qiskit_ibm_runtime.visualization.draw_chunk_timings

draw_chunk_timings(*timings, names=None, common_start=False, normalize_y=False, line_width=4, show_legend=None, tz=None)

GitHub

Draw one or more ChunkTiming on a bar plot.

Each chunk corresponds to a single execution window on the backend. The y-axis represents cumulative work completed across chunks — in units of elements executed, or as a percentage if normalize_y=True.

When comparing multiple ChunkTiming (e.g. from different jobs), use common_start=True to align traces at $t=0$ for direct comparison.

Note

For a simpler single-trace interface for data from an executor job, call draw() directly on job.result().timings.

Parameters

timings (ChunkTiming) – One or more ChunkTiming collections.
names (str | Iterable[str] | None) – Name or names to assign to the respective timings. When provided, a legend is shown by default.
common_start (bool) – Whether to shift each collection’s chunks so that its first chunk starts at $t=0$ . Useful for comparing timings from different jobs side by side.
normalize_y (bool) – Whether to display the y-axis units as a percentage of work complete, rather than cumulative elements completed.
line_width (int) – The thickness of line segments.
show_legend (bool | None) – Whether to show a legend. By default, shown only when names is provided.
tz (timezone | None) – The timezone to use for displaying times. None (default) uses the local system timezone. Pass datetime.timezone.utc to display times in UTC.

Returns

A plotly figure.

Return type

PlotlyFigure