PipelineTrace¶

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

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

Attributes Summary

`env_artifacts`	Stage-produced artifacts (e.g. ham_ops) captured for cache restore.
`final_batch`	The fully-expanded batch after all stages have run.
`initial_batch`	The batch of MetaCircuits before any stage expansion.
`result_format`	Result format declared by the measurement stage during expand.
`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 = <dataclasses._MISSING_TYPE object>¶: Stage-produced artifacts (e.g. ham_ops) captured for cache restore.

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.

result_format: ResultFormat | None = None¶: Result format declared by the measurement stage during expand.

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.