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

Update some parallel documentation #5515

Merged
merged 3 commits into from
Oct 2, 2023

Conversation

knelli2
Copy link
Contributor

@knelli2 knelli2 commented Sep 29, 2023

Proposed changes

Some of it was out of date. Also added some info and warnings.

Upgrade instructions

Code review checklist

  • The code is documented and the documentation renders correctly. Run
    make doc to generate the documentation locally into BUILD_DIR/docs/html.
    Then open index.html.
  • The code follows the stylistic and code quality guidelines listed in the
    code review guide.
  • The PR lists upgrade instructions and is labeled bugfix or
    new feature if appropriate.

Further comments

@knelli2 knelli2 requested a review from a team September 29, 2023 08:02
\snippet Test_DetectHangArray.cpp deadlock_analysis_function

If this function is specified in the metavariables and a deadlock occurs, this
function and all the simple actions in it will run. The information printed
Copy link
Member

Choose a reason for hiding this comment

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

What do you mean by "simple actions in [a function]"?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The function named run_deadlock_analysis_simple_actions calls simple actions.

Copy link
Member

Choose a reason for hiding this comment

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

OK, yeah, I guess that should have been clear if I'd paid more attention.

@@ -806,15 +806,15 @@ will be invoked; in this case the callback function re-runs
\snippet Test_AlgorithmGlobalCache.cpp check_mutable_cache_item_is_ready

Note that `Parallel::mutable_cache_item_is_ready` is called on a local
core and does no parallel communication.
node and does no parallel communication.
Copy link
Member

Choose a reason for hiding this comment

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

"the local node". (There's only one.)


### 2. Retrieving the item

The item is retrieved using `Parallel::get` just like for constant items.
For example, to retrieve the item `Tags::VectorOfDoubles`:
\snippet Test_AlgorithmGlobalCache.cpp retrieve_mutable_cache_item

Note that `Parallel::get` is called on a local core and does no
Note that `Parallel::get` is called on a local node and does no
Copy link
Member

Choose a reason for hiding this comment

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

"the" again.

@knelli2
Copy link
Contributor Author

knelli2 commented Sep 29, 2023

Squashed the "the"s.

@kidder kidder merged commit 10959e8 into sxs-collaboration:develop Oct 2, 2023
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.

3 participants