scope_profiler.plotting_scripts.histogram

Per-region duration-distribution histograms.

Functions

Name	Description
plot_duration_histogram	Plot each region's call-duration distribution as a frequency line.

plot_duration_histogramfunction#

View source

def plot_duration_histogram(profiling_data: ProfilingResults | Sequence[ProfilingResults], ranks: list[int] | int | None = None, include: list[str] | str | None = None, exclude: list[str] | str | None = None, bins: int = 30, filepath: str | None = None, show: bool = False, verbose: bool = True, cmap: str = DEFAULT_CMAP, log_scale: bool = False, data_filepath: str | Path | None = None, data_format: str = 'csv', backend: str = 'matplotlib') -> None

Plot each region’s call-duration distribution as a frequency line.

One panel per file, one line per region, giving the count of calls falling in each duration bin - so a region whose calls are mostly fast with an occasional slow outlier shows up as a peak with a long tail, something the mean/min/max in :func:plot_durations cannot distinguish from a uniformly slower region.

Parameters

bins : int Number of histogram bins spanning each file’s observed duration range (default: 30). All regions in a panel share the same bin edges, so the curves are directly comparable. backend : str Backend to use for rendering: “matplotlib” (default) or “plotly”.