Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Issue 801 execution quickrun #814

Merged
merged 5 commits into from
Apr 10, 2024
Merged

Conversation

richardjgowers
Copy link
Contributor

fixes #801

Checklist

  • Added a news entry

Developers certificate of origin

Copy link

codecov bot commented Apr 5, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.31%. Comparing base (4c4ce04) to head (f43d284).

❗ Current head f43d284 differs from pull request most recent head 139e9c3. Consider uploading reports for the commit 139e9c3 to get more accurate results

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #814      +/-   ##
==========================================
- Coverage   92.53%   92.31%   -0.23%     
==========================================
  Files         133      133              
  Lines        9767     9767              
==========================================
- Hits         9038     9016      -22     
- Misses        729      751      +22     
Flag Coverage Δ
fast-tests 92.31% <ø> (?)
slow-tests ?

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Copy link
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.

Thanks, couple of typos and a question.

docs/guide/execution/quickrun_execution.rst Outdated Show resolved Hide resolved
docs/guide/execution/quickrun_execution.rst Outdated Show resolved Hide resolved
docs/guide/execution/quickrun_execution.rst Outdated Show resolved Hide resolved
The **execution** of these simulations however requires a large amount of computational power and is intended to be
distributed onto a HPC environment.
To do this requires storing and sending the details of the simulation from the local workstation to a HPC environment,
this can be done via the :func:`.Transformation.dump` function which creates a saved "json" version of the data.
Copy link
Member

Choose a reason for hiding this comment

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

Should this really be here? It feels like this page should concentrate "I have a JSON, what do I do now", and this should get punted over to the setup section.. maybe we're missing a "writing out an alchemical network" section?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I added a link to the relevant cookbook here. It's duplicated information, but it's also essential for anything else on the page to make sense so it's probably warranted

@richardjgowers richardjgowers requested a review from IAlibay April 9, 2024 12:57
Copy link
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.

Two comments, but otherwise looks good to me.

The planning and preparation of a campaign of alchemical simulations using the ``openfe`` package is intended to be
achievable on a local workstation in a matter of minutes.
The **execution** of these simulations however requires a large amount of computational power and is intended to be
distributed across a HPC environment.
Copy link
Member

Choose a reason for hiding this comment

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

It's probably not necessary, but one thing here that might be a bit of a catch to a novice user is "o so I need a HPC machine to do this", maybe a note that says something like "you can also do this on your workstation" might be good to spell things out?


::

openfe quickrun transformation.json
Copy link
Member

Choose a reason for hiding this comment

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

This doesn't use the -o flag, but the next example does. Would it be worth at least making them equivalent? (and saying that -o means that you're generating an output file named results.json)?

richardjgowers and others added 5 commits April 10, 2024 09:56
@richardjgowers richardjgowers force-pushed the issue_801_execution_quickrun branch from 8b012fe to 139e9c3 Compare April 10, 2024 08:56
@richardjgowers richardjgowers merged commit 0dd3a73 into main Apr 10, 2024
7 of 9 checks passed
@richardjgowers richardjgowers deleted the issue_801_execution_quickrun branch April 10, 2024 08:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

User guide: Add execution quickrun page (primary page)
2 participants