Skip to content

add task-based execution tutorials - #322

Draft
atravitz wants to merge 18 commits into
mainfrom
feat/add_worker_based_execution
Draft

atravitz wants to merge 18 commits into
mainfrom
feat/add_worker_based_execution

Conversation

@atravitz

@atravitz atravitz commented Aug 27, 2026 •

Copy link
Copy Markdown
Contributor

accompanies the user guide in-progress at OpenFreeEnergy/openfe#2211

@review-notebook-app

Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@github-actions

Copy link
Copy Markdown

Colab 👈 Launch a Colab session on branch feat/add_worker_based_execution

@atravitz atravitz self-assigned this Sep 21, 2026
@atravitz
atravitz force-pushed the feat/add_worker_based_execution branch from 07ef972 to bee3106 Compare September 29, 2026 15:43
@atravitz atravitz changed the title add worker based execution API example add worker based execution tutorials Sep 29, 2026
@atravitz atravitz changed the title add worker based execution tutorials add task-based execution tutorials Sep 29, 2026
@atravitz
atravitz force-pushed the feat/add_worker_based_execution branch from 36ddff1 to 7702492 Compare September 29, 2026 22:28
@hannahbaumann hannahbaumann self-assigned this Sep 30, 2026
@atravitz

atravitz commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor Author

@hannahbaumann example zenodo data we can pull for cooking show style results https://zenodo.org/records/23072369

@hannahbaumann
hannahbaumann requested a review from IAlibay October 2, 2026 12:34
@atravitz
atravitz removed the request for review from IAlibay October 2, 2026 17:13
@atravitz

atravitz commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor Author

Thanks @hannahbaumann for taking this over - the API tutorial is great!

I've updated the corresonding PR at openfe so you can preview how it renders.

@@ -0,0 +1,1463 @@
{

@atravitz atravitz Oct 2, 2026 •

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.

This introduction is really strong! I might make the user guide intro more similar to this when I revisit it. I'll want to write an API section for that as well.

One bit that is slightly confusing is the phrasing:

"Task-based execution moves the orchestration into openfe:"

since it might not be clear that "orchestration" = "which simulations are run in which order".

Maybe even opening with:

"When usingopenfe quickrun, you are orchestrating the campaign. You choose and execute each Transformation in the order of your choosing.

would clarify the distinction?


Reply via ReviewNB

@@ -0,0 +1,1463 @@
{

@atravitz atravitz Oct 2, 2026 •

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 can make it easy for them to access alchemicalNetwork_mc1_small.json" by adding a "fetch mcl1-network" command.

thoughts?


Reply via ReviewNB

@@ -0,0 +1,1463 @@
{

@atravitz atravitz Oct 2, 2026 •

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.

[nit] setup_task_campaign() - adding the () makes it clearer this is a Python method, vs the CLI command.


Reply via ReviewNB

@@ -0,0 +1,1463 @@
{

@atravitz atravitz Oct 2, 2026 •

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.

maybe add a note like "we recommend you prefix your warehouse and task database names with warehouse_ and tasks_ accordingly. this follows the default behavior of the CLI". just to encourage good conventions. I didn't want to be too strict at the API level, be can still recommend :)


Reply via ReviewNB

@@ -0,0 +1,1463 @@
{

@atravitz atravitz Oct 2, 2026 •

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.

you'll want to use wh and task_db here, since those are the actual Python objects, as opposed to just the paths.


Reply via ReviewNB

@@ -0,0 +1,1463 @@
{

@atravitz atravitz Oct 2, 2026 •

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.

suggestion: For this network, four Transformations × three units per repeat x 1 repeat per Transformation gives 12 tasks.


Reply via ReviewNB

@@ -0,0 +1,1463 @@
{

@atravitz atravitz Oct 2, 2026 •

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.

we can link to the SLURM part of the UserGuide here.


Reply via ReviewNB

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.

2 participants