bencher.results.bench_result

Classes

`RerunResult`
`BenchResult`	Contains the results of the benchmark and has methods to cast the results to various datatypes and graphical representations

Module Contents

class bencher.results.bench_result.RerunResult

class bencher.results.bench_result.BenchResult(bench_cfg)

Contains the results of the benchmark and has methods to cast the results to various datatypes and graphical representations

timings = None

classmethod from_existing(original: BenchResult) → BenchResult

to(result_type: BenchResult, result_var: param.Parameter | None = None, override: bool = True, reduce: bencher.results.bench_result_base.ReduceType | None = None, aggregate: bool | int | list[str] | None = None, agg_fn: Literal['mean', 'sum', 'max', 'min', 'median'] = 'mean', **kwargs: Any) → BenchResult

Return the current instance of BenchResult.

Returns:: The current instance of the benchmark result
Return type:: BenchResult

static default_plot_callbacks() → list[callable]

Get the default list of plot callback functions.

These callbacks are used by default in the to_auto method if no specific plot list is provided.

Returns:: A list of plotting callback functions
Return type:: list[callable]

static plotly_callbacks() → list[callable]

Get the list of Plotly-specific callback functions.

Returns:: A list of Plotly-based visualization callback functions
Return type:: list[callable]

plot() → panel.panel

Plots the benchresult using the plot callbacks defined by the bench run.

This method uses the plot_callbacks defined in the bench_cfg to generate plots for the benchmark results.

Returns:: A panel representation of the results, or None if no plot_callbacks defined
Return type:: pn.panel

to_auto(plot_list: list[callable] | None = None, remove_plots: list[callable] | None = None, default_container=pn.Column, override: bool = False, numeric_only: bool = False, **kwargs) → list[panel.panel]

Automatically generate plots based on the provided plot callbacks.

Parameters:

plot_list (list[callable], optional) – List of plot callback functions to use. Defaults to None.
remove_plots (list[callable], optional) – List of plot callback functions to exclude. Defaults to None.
default_container (type, optional) – Default container type for the plots. Defaults to pn.Column.
override (bool, optional) – Whether to override unsupported plots. Defaults to False.
numeric_only (bool, optional) – When True, skip pane-type result callbacks (images, videos, rerun, etc.) that cannot be numerically aggregated. Defaults to False.
**kwargs – Additional keyword arguments for plot configuration.

Returns:

A list of panel objects containing the generated plots.

Return type:

list[pn.panel]

to_auto_plots(extra_panels: collections.abc.Sequence[collections.abc.Callable[[BenchResult], panel.viewable.Viewable] | panel.viewable.Viewable] | None = None, **kwargs) → panel.panel

Given the dataset result of a benchmark run, automatically deduce how to plot the data based on the types of variables that were sampled.

Parameters:

extra_panels – Extra panel callables or static panels to inject after the sweep summary and before aggregate/auto plots. Each item is either a callable(BenchResult) -> panel, or a static panel object.
**kwargs – Additional keyword arguments for plot configuration.

Returns:

A panel containing plot results.

Return type:

pn.panel

_scalar_aggregate_summary() → panel.pane.Markdown: Render a Markdown table for a fully-aggregated (scalar) result.