From 79a9f568f1ccb2ba588dfe1d935ea61061bae9d2 Mon Sep 17 00:00:00 2001 From: Josh Horton Date: Tue, 17 Nov 2026 09:45:23 +0000 Subject: [PATCH 1/3] add small nnote on AHFE protocol --- cookbook/exploring_protocol_settings.ipynb | 28 +++++++++++----------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/cookbook/exploring_protocol_settings.ipynb b/cookbook/exploring_protocol_settings.ipynb index 3802da58..11f9afe9 100644 --- a/cookbook/exploring_protocol_settings.ipynb +++ b/cookbook/exploring_protocol_settings.ipynb @@ -389,9 +389,8 @@ ] }, { - "cell_type": "markdown", - "id": "c1d2e3f4a5b60001", "metadata": {}, + "cell_type": "markdown", "source": [ "### Other protocols\n", "\n", @@ -402,34 +401,35 @@ "\n", "These protocols execute both the `complex` and `solvent` legs within a single transformation, the settings to control the production sampling are then prefixed with the leg name `complex_*` or `solvent_*`.\n", "\n", - "In addition, each leg has a `*_equil_simulation_settings` object controlling an initial MD simulation used to determine the restraint atoms in the complex and to seed both legs production simulations.\n" - ] + "In addition, each leg has a `*_equil_simulation_settings` object controlling an initial MD simulation used to determine the restraint atoms in the complex and to seed both legs production simulations.\n", + "\n", + "**N.B.:** The `AbsoluteSolvationProtocol` follows the same per-leg settings pattern, but uses the prefixes `vacuum_*` and `solvent_*` rather than `complex_`* and `solvent_*` and the following examples also apply to that protocol.\n" + ], + "id": "881aec55e73c19cd" }, { + "metadata": {}, "cell_type": "code", - "execution_count": 8, - "id": "61192c7c", - "metadata": { - "nbsphinx": "hidden" - }, "outputs": [], + "execution_count": null, "source": [ "import warnings\n", "\n", "# Silence a third-party Biopython deprecation warning raised on import\n", "warnings.filterwarnings(\"ignore\", message=\"The Bio.Application modules\")" - ] + ], + "id": "f6c511b6841b4135" }, { - "cell_type": "code", - "execution_count": 9, - "id": "other-protocol-imports", "metadata": {}, + "cell_type": "code", "outputs": [], + "execution_count": null, "source": [ "from openfe.protocols.openmm_afe import AbsoluteBindingProtocol\n", "from openfe.protocols.openmm_septop import SepTopProtocol\n" - ] + ], + "id": "bb9691bd6e6cec83" }, { "cell_type": "markdown", From 4c3f5b9e2aac1fb55e0313f0cb3f44c21b6fc28c Mon Sep 17 00:00:00 2001 From: Josh Horton Date: Wed, 18 Nov 2026 13:41:25 +0000 Subject: [PATCH 2/3] use an alert box --- cookbook/exploring_protocol_settings.ipynb | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/cookbook/exploring_protocol_settings.ipynb b/cookbook/exploring_protocol_settings.ipynb index 11f9afe9..2cbff06a 100644 --- a/cookbook/exploring_protocol_settings.ipynb +++ b/cookbook/exploring_protocol_settings.ipynb @@ -403,7 +403,11 @@ "\n", "In addition, each leg has a `*_equil_simulation_settings` object controlling an initial MD simulation used to determine the restraint atoms in the complex and to seed both legs production simulations.\n", "\n", - "**N.B.:** The `AbsoluteSolvationProtocol` follows the same per-leg settings pattern, but uses the prefixes `vacuum_*` and `solvent_*` rather than `complex_`* and `solvent_*` and the following examples also apply to that protocol.\n" + "
\n", + "\n", + "**Note:** The **AbsoluteSolvationProtocol** follows the same per-leg settings pattern, but uses the prefixes **vacuum_*** and **solvent_*** rather than **complex_*** and **solvent_*** and the following examples also apply to that protocol.\n", + "\n", + "
" ], "id": "881aec55e73c19cd" }, From cc8225d03ba4811007d30ae2ae9ec4e0fb8de063 Mon Sep 17 00:00:00 2001 From: Josh Horton Date: Wed, 18 Nov 2026 14:31:32 +0000 Subject: [PATCH 3/3] make sure cells have output --- cookbook/exploring_protocol_settings.ipynb | 73 ++++++++++++++-------- 1 file changed, 46 insertions(+), 27 deletions(-) diff --git a/cookbook/exploring_protocol_settings.ipynb b/cookbook/exploring_protocol_settings.ipynb index 2cbff06a..79bd8599 100644 --- a/cookbook/exploring_protocol_settings.ipynb +++ b/cookbook/exploring_protocol_settings.ipynb @@ -25,8 +25,9 @@ ] }, { - "metadata": {}, "cell_type": "markdown", + "id": "84d716d6bc428c83", + "metadata": {}, "source": [ "## Sampling and performance settings\n", "\n", @@ -52,14 +53,25 @@ "| **Protocol repeats** | The number of independent executions of the protocol. | `protocol_repeats` | `int` |\n", "\n", "The appropriate changes to these settings are transformation dependent with no single setting guaranteeing sufficient convergence or accuracy in general. These settings provide a good starting point to investigate the affect of additional sampling. The following example retrieves them from the default settings:" - ], - "id": "84d716d6bc428c83" + ] }, { - "metadata": {}, "cell_type": "code", - "outputs": [], - "execution_count": null, + "execution_count": 2, + "id": "921c307e3d1f19b8", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Lambda windows: 11\n", + "Production length per state: 5.0 nanosecond\n", + "Equilibration length per state: 1.0 nanosecond\n", + "Independent repeats: 3\n" + ] + } + ], "source": [ "n_repeats = settings.protocol_repeats\n", "n_windows = settings.lambda_settings.lambda_windows\n", @@ -70,12 +82,12 @@ "print(f\"Production length per state: {production_length}\")\n", "print(f\"Equilibration length per state: {equilibration_length}\")\n", "print(f\"Independent repeats: {n_repeats}\")" - ], - "id": "921c307e3d1f19b8" + ] }, { - "metadata": {}, "cell_type": "markdown", + "id": "22b1aa1dd390fd73", + "metadata": {}, "source": [ "### Estimating the computational cost of a protocol\n", "\n", @@ -97,14 +109,22 @@ "\n", "\n", "So for the default settings the total simulation time is:" - ], - "id": "22b1aa1dd390fd73" + ] }, { - "metadata": {}, "cell_type": "code", - "outputs": [], - "execution_count": null, + "execution_count": 3, + "id": "c8b951b79fd1c4bb", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Total simulation time: 198.0 nanosecond\n" + ] + } + ], "source": [ "def estimate_rbfe_cost(settings):\n", " n_repeats = settings.protocol_repeats\n", @@ -117,8 +137,7 @@ "\n", "total_sim_time_per_leg = estimate_rbfe_cost(settings)\n", "print(f\"Total simulation time: {total_sim_time_per_leg}\")" - ], - "id": "c8b951b79fd1c4bb" + ] }, { "cell_type": "markdown", @@ -389,8 +408,9 @@ ] }, { - "metadata": {}, "cell_type": "markdown", + "id": "881aec55e73c19cd", + "metadata": {}, "source": [ "### Other protocols\n", "\n", @@ -408,32 +428,31 @@ "**Note:** The **AbsoluteSolvationProtocol** follows the same per-leg settings pattern, but uses the prefixes **vacuum_*** and **solvent_*** rather than **complex_*** and **solvent_*** and the following examples also apply to that protocol.\n", "\n", "" - ], - "id": "881aec55e73c19cd" + ] }, { - "metadata": {}, "cell_type": "code", + "execution_count": 8, + "id": "f6c511b6841b4135", + "metadata": {}, "outputs": [], - "execution_count": null, "source": [ "import warnings\n", "\n", "# Silence a third-party Biopython deprecation warning raised on import\n", "warnings.filterwarnings(\"ignore\", message=\"The Bio.Application modules\")" - ], - "id": "f6c511b6841b4135" + ] }, { - "metadata": {}, "cell_type": "code", + "execution_count": 9, + "id": "bb9691bd6e6cec83", + "metadata": {}, "outputs": [], - "execution_count": null, "source": [ "from openfe.protocols.openmm_afe import AbsoluteBindingProtocol\n", "from openfe.protocols.openmm_septop import SepTopProtocol\n" - ], - "id": "bb9691bd6e6cec83" + ] }, { "cell_type": "markdown",