Skip to content

Docs: document the TinyProfileParser script#5525

Open
SuryanshSS1011 wants to merge 1 commit into
AMReX-Codes:developmentfrom
SuryanshSS1011:docs-tinyprofileparser
Open

Docs: document the TinyProfileParser script#5525
SuryanshSS1011 wants to merge 1 commit into
AMReX-Codes:developmentfrom
SuryanshSS1011:docs-tinyprofileparser

Conversation

@SuryanshSS1011

Copy link
Copy Markdown

Closes #4160.

The Tools/TinyProfileParser/profileparser.py script wasn't mentioned anywhere in the docs, so this adds a short subsection to the Tiny Profiling page covering it.

The new "Converting TinyProfiler Output for Hatchet" subsection goes right after "Hot Spots and Load Balance", since the script consumes TinyProfiler stdout. It covers:

  • what the script does (parses TinyProfiler stdout into a JSON file for Hatchet)
  • how to run it, including the optional output-directory argument
  • the metrics it emits per function (n_calls, the excl_* set, and the incl_* set)
  • a note that it expects a single plain run-end summary (relevant if you use BL_PROFILE_TINY_FLUSH)

I went with a subsection rather than a separate page since it's one small utility and this keeps it next to the profiler output it parses. Happy to split it into its own page under the chapter toctree instead if you'd prefer that.

Docs-only change; the wording is checked against the current script.

Adds a subsection to the Tiny Profiling docs covering
Tools/TinyProfileParser/profileparser.py, which converts TinyProfiler
stdout into JSON for Hatchet. Covers usage and the metrics it emits.

Closes AMReX-Codes#4160
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.

document TinyProfileParser

1 participant