utils | Conductor Quantum

Shared utilities for plotting backends.

This module centralizes small, reusable helpers used by multiple plotting backends to keep implementations minimal and consistent.

Module Contents

Classes

Name	Description
`PlotSpec`	Plot specification with type-safe fields.
`PlotState`	Complete plot state: source, figure, and spec in one place.

Functions

Name	Description
`prepare_heatmap_data`	Calculate rect sizes and update color range for heatmap data.
`make_line_plot`	Create a 1D line plot.
`make_heatmap_plot`	Create a 2D heatmap plot.

Data

LINE_PLOT_WIDTH LINE_PLOT_HEIGHT HEATMAP_WIDTH HEATMAP_HEIGHT

API

1 stanza.plotter.backends.utils.LINE_PLOT_WIDTH

Value: 800

1 stanza.plotter.backends.utils.LINE_PLOT_HEIGHT

Value: 400

1 stanza.plotter.backends.utils.HEATMAP_WIDTH

Value: 800

1 stanza.plotter.backends.utils.HEATMAP_HEIGHT

Value: 600

1 class stanza.plotter.backends.utils.PlotSpec

Plot specification with type-safe fields.

1 name: str

Value: None

1 plot_type: str

Value: None

1 x_label: str

Value: None

1 y_label: str

Value: None

1 z_label: str | None

Value: None

1 cell_size: tuple[float, float] | None

Value: None

1 mapper: bokeh.models.LinearColorMapper | None

Value: None

1 dx: float | None

Value: None

1 dy: float | None

Value: None

1 value_min: float

Value: float(...)

1 value_max: float

Value: float(...)

1 class stanza.plotter.backends.utils.PlotState

Complete plot state: source, figure, and spec in one place.

Single source of truth for a plot’s data, visualization, and configuration. Ownership is clear: whoever has the PlotState owns the entire plot.

1 source: bokeh.models.ColumnDataSource

Value: None

1 figure: typing.Any

Value: None

1 spec: stanza.plotter.backends.utils.PlotSpec

Value: None

1 stanza.plotter.backends.utils.prepare_heatmap_data(
2     data: dict[str, typing.Any],
3     existing_data: dict[str, typing.Any],
4     spec: stanza.plotter.backends.utils.PlotSpec
5 ) -> dict[str, typing.Any]

Calculate rect sizes and update color range for heatmap data.

Parameters:

data

dict[str, typing.Any]

New data to add (x, y, value)

existing_data

dict[str, typing.Any]

Existing data in the data source

spec

stanza.plotter.backends.utils.PlotSpec

Plot specification with dx, dy, value_min, value_max

Returns:

Updated data with width and height fields added

1 stanza.plotter.backends.utils.make_line_plot(
2     name: str,
3     x_label: str,
4     y_label: str
5 ) -> stanza.plotter.backends.utils.PlotState

Create a 1D line plot.

Returns complete PlotState with source, figure, and spec.

1 stanza.plotter.backends.utils.make_heatmap_plot(
2     name: str,
3     x_label: str,
4     y_label: str,
5     z_label: str | None,
6     cell_size: tuple[float, float] | None
7 ) -> stanza.plotter.backends.utils.PlotState

Create a 2D heatmap plot.

Returns complete PlotState with source, figure, and spec.