PipelineTrace¶

class PipelineTrace(initial_batch, final_batch, stage_expansions, stage_tokens, env_artifacts=<factory>)[source]¶

Bases: object

Forward-pass pipeline trace for fan-out verification before execution.

Attributes Summary

`env_artifacts`	Measurement artifacts (`ham_ops`, `per_group_shots`) reconstructed from the final batch for backend submission and dry-run reporting.
`final_batch`	The fully-expanded batch after all stages have run.
`initial_batch`	The batch of MetaCircuits before any stage expansion.
`stage_expansions`	Per-stage expansion results, one entry per BundleStage in expand order.
`stage_tokens`	Per-stage opaque tokens returned by each BundleStage's expand.

Attributes Documentation

env_artifacts: dict[str, Any] = <dataclasses._MISSING_TYPE object>¶: Measurement artifacts (ham_ops, per_group_shots) reconstructed from the final batch for backend submission and dry-run reporting.

final_batch: dict[tuple[tuple[str, Hashable], ...], MetaCircuit] = <dataclasses._MISSING_TYPE object>¶: The fully-expanded batch after all stages have run.

initial_batch: dict[tuple[tuple[str, Hashable], ...], MetaCircuit] = <dataclasses._MISSING_TYPE object>¶: The batch of MetaCircuits before any stage expansion.

stage_expansions: tuple[ExpansionResult, ...] = <dataclasses._MISSING_TYPE object>¶: Per-stage expansion results, one entry per BundleStage in expand order.

stage_tokens: tuple[Any, ...] = <dataclasses._MISSING_TYPE object>¶: Per-stage opaque tokens returned by each BundleStage’s expand.