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

Add documentation for the Parallel Manager #1220

Merged
merged 9 commits into from
Dec 4, 2023

Conversation

k1nshuk
Copy link
Contributor

@k1nshuk k1nshuk commented Nov 28, 2023

Fixes/Resolves:

Addresses #1195 by adding documentation for the parallel manager

Summary/Motivation:

Meet the project goals

Changes proposed in this PR:

  • Add documentation

Legal Acknowledgement

By contributing to this software project, I agree to the following terms and conditions for my contribution:

  1. I agree my contributions are submitted under the license terms described in the LICENSE.txt file at the top level of this directory.
  2. I represent I am authorized to make the contributions and grant the license. If my employer has rights to intellectual property that includes these contributions, I represent that I have received permission to make contributions and grant the required license on behalf of that employer.

@k1nshuk k1nshuk added the documentation Improvements or additions to documentation label Nov 28, 2023
@k1nshuk k1nshuk self-assigned this Nov 28, 2023
@k1nshuk k1nshuk linked an issue Nov 28, 2023 that may be closed by this pull request
Copy link

codecov bot commented Nov 28, 2023

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (86301bc) 94.78% compared to head (471d9d9) 94.78%.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1220   +/-   ##
=======================================
  Coverage   94.78%   94.78%           
=======================================
  Files         353      353           
  Lines       35454    35454           
=======================================
  Hits        33604    33604           
  Misses       1850     1850           

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

Copy link
Contributor

@bknueven bknueven left a comment

Choose a reason for hiding this comment

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

I have a minor suggestion. But some documentation is better than no documentation.

docs/technical_reference/tools/parallel_manager.rst Outdated Show resolved Hide resolved
Comment on lines +103 to +104
documentation. A lot of features are currently missing from the parallel
manager that limits its wider use. We encourage developers to make PRs to the
Copy link
Contributor

Choose a reason for hiding this comment

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

Are there some immediate examples that come to mind that we should list somewhere, e.g., in an issue?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

We have all the necessary features needed to run the parameter sweep. If however, we wanted to make the parallel manager into a standalone package we would need features that, for example, allows one worker to send data to another and so on. I do not think we need to make an issue for it quite yet as this is only tangentially related to WaterTAP.

Copy link
Contributor

@adam-a-a adam-a-a left a comment

Choose a reason for hiding this comment

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

@k1nshuk - looks great to me- just a couple of quick comments to consider before we merge.

Copy link
Contributor

@avdudchenko avdudchenko 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 good enough to me.

@ksbeattie ksbeattie added the Priority:Normal Normal Priority Issue or PR label Nov 30, 2023
@adam-a-a adam-a-a enabled auto-merge (squash) December 4, 2023 20:00
@adam-a-a adam-a-a merged commit 997b5a3 into watertap-org:main Dec 4, 2023
24 checks passed
@k1nshuk k1nshuk deleted the pm_docs branch December 5, 2023 18:08
lbianchi-lbl pushed a commit to watertap-org/parameter-sweep that referenced this pull request May 1, 2024
* added some parallel manager documentation to watertap.

* update docs to render correctly.

* update documentation to remove redundant documentation.

* Grammatical fix

Co-authored-by: Adam Atia <aatia@keylogic.com>

* add more context around which parallel paradigm to use for analysis.

---------

Co-authored-by: Kinshuk <kinshuk.panda@nrel.gov>
Co-authored-by: Adam Atia <aatia@keylogic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation Priority:Normal Normal Priority Issue or PR
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add documentation for Parallel Manager
5 participants