Skip to content

User guide updates membrane#1933

Open
hannahbaumann wants to merge 246 commits intomainfrom
user_guide_updates_membrane
Open

User guide updates membrane#1933
hannahbaumann wants to merge 246 commits intomainfrom
user_guide_updates_membrane

Conversation

@hannahbaumann
Copy link
Copy Markdown
Contributor

@hannahbaumann hannahbaumann commented Apr 9, 2026

  • Adds ProteinMembraneComponent explanation, including example code of creating a ChemicalSystem for the complex leg of protein-membrane simulations.
  • Adds _adaptive_settings to the user guide
  • Adds mentioning of the differences in defining ChemicalSystems in ABFE and SepTop vs HybTop protocols.
  • [follow-up PR] Update CLI user guide to add the --protein-membrane flag

Checklist

  • All new code is appropriately documented (user-facing code must have complete docstrings).
  • Added a news entry, or the changes are not user-facing.
  • Ran pre-commit: you can run pre-commit locally or comment on this PR with pre-commit.ci autofix.

Manual Tests: these are slow so don't need to be run every commit, only before merging and when relevant changes are made (generally at reviewer-discretion).

Developers certificate of origin

hannahbaumann and others added 30 commits October 9, 2025 16:36
Copy link
Copy Markdown
Member

@IAlibay IAlibay left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Couple of small comments, but otherwise this looks great to me!

Comment thread docs/guide/setup/chemical_systems_and_thermodynamic_cycles.rst Outdated
Comment thread docs/guide/setup/chemical_systems_and_thermodynamic_cycles.rst Outdated
Comment thread docs/guide/setup/chemical_systems_and_thermodynamic_cycles.rst Outdated
Comment thread docs/guide/setup/chemical_systems_and_thermodynamic_cycles.rst Outdated
Copy link
Copy Markdown
Contributor

@atravitz atravitz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks great @hannahbaumann! Just a couple non-blocking edits and suggestions. I also opened #1954 so that the reference links work - but it can be merged independently from this PR.

Comment thread docs/guide/setup/chemical_systems_and_thermodynamic_cycles.rst Outdated
Comment thread docs/guide/setup/chemical_systems_and_thermodynamic_cycles.rst Outdated
Comment thread docs/guide/setup/chemical_systems_and_thermodynamic_cycles.rst
Comment on lines +186 to +188
A thermodynamic cycle can be described as a set of :class:`.ChemicalSystem`\s (nodes) connected by
alchemical transformations (edges). The :class:`.Protocol` defines how the
:class:`.ChemicalSystem`\s map onto the cycle and how they are used in practice.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this unclear regarding thermodynamic cycles and alchemical networks. Not blocking for this PR, but maybe we can follow up with a better explainer over in the alchemical network docs?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I ended up removing the reference to the alchemical networks here, because I think it would confuse users more, since a thermodynamic cycle is more linked to a Transformation. I think the reference to the protocols here is more helpful, since e.g. in the RBFE protocol we say how the ChemicalSystems are used to describe the thermodynamic cycle.

Comment thread docs/guide/setup/defining_protocols.rst Outdated
hannahbaumann and others added 6 commits April 23, 2026 07:58
Co-authored-by: Alyssa Travitz <31974495+atravitz@users.noreply.github.com>
Co-authored-by: Alyssa Travitz <31974495+atravitz@users.noreply.github.com>
Co-authored-by: Alyssa Travitz <31974495+atravitz@users.noreply.github.com>
and disulfide bonds (defined via CONECT records).
* - :class:`.SmallMoleculeComponent`
- Ligands and cofactors
-
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to say that they can optionally contain atomic partial charges which can be used in the simulation?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great idea, added this!

Comment thread docs/guide/setup/chemical_systems_and_thermodynamic_cycles.rst Outdated
Comment thread docs/guide/setup/chemical_systems_and_thermodynamic_cycles.rst
hannahbaumann and others added 3 commits April 23, 2026 11:21
Co-authored-by: Josh Horton <Josh.Horton@newcastle.ac.uk>
Co-authored-by: Josh Horton <Josh.Horton@newcastle.ac.uk>
@github-actions
Copy link
Copy Markdown

No API break detected ✅

Copy link
Copy Markdown
Collaborator

@jthorton jthorton left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great, good job @hannahbaumann!
Do we want to merge #1954 first though to make sure the links work in the docs or does it not matter?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants