scope_profiler.post_processing

CLI entry point for post-processing HDF5 profiling data.

Attributes

Name	Description
COMPANION_EXPORTS	No description.

Classes

Name	Description
OutputTargets	No description.

Functions

Name	Description
build_export_parser	No description.
build_parser	No description.
expand_file_patterns	Expand CLI file arguments that contain shell-style wildcard patterns.
export_main	Export HDF5 profiling data without rendering plot images.
main	Render one plot kind or plot preset from HDF5 profiling data.
parse_ranks	Parse a rank specification string into a list of integers.
parse_region_groups	Parse --combine-regions specs into a {name: [patterns]} dict.

COMPANION_EXPORTSattributemodule attribute#

View source

COMPANION_EXPORTS = ('prof', 'speedscope', 'flamegraph')

OutputTargetsclassdataclass#

View source

class OutputTargets(directory: str | None, single_file: str | None, statistics_path: str | None)

directoryattributeinstance attribute#

View source

directory: str | None

single_fileattributeinstance attribute#

View source

single_file: str | None

statistics_pathattributeinstance attribute#

View source

statistics_path: str | None

build_export_parserfunction#

View source

def build_export_parser() -> argparse.ArgumentParser

build_parserfunction#

View source

def build_parser() -> argparse.ArgumentParser

expand_file_patternsfunction#

View source

def expand_file_patterns(file_args: list[str], parser: argparse.ArgumentParser) -> list[str]

Expand CLI file arguments that contain shell-style wildcard patterns.

export_mainfunction#

View source

def export_main(argv: list[str] | None = None)

Export HDF5 profiling data without rendering plot images.

mainfunction#

View source

def main(argv: list[str] | None = None)

Render one plot kind or plot preset from HDF5 profiling data.

parse_ranksfunction#

View source

def parse_ranks(spec: str, verbose: bool = False) -> list[int]

Parse a rank specification string into a list of integers.

Supports comma-separated values and ranges (e.g., ‘1-3,5’).

parse_region_groupsfunction#

View source

def parse_region_groups(specs: list[str] | None, parser: argparse.ArgumentParser) -> dict[str, list[str]] | None

Parse --combine-regions specs into a {name: [patterns]} dict.

Each spec has the form NAME=PATTERN1,PATTERN2. Repeating the same NAME across specs is not supported - pass every pattern for a group in one spec instead.