Skip to content

Benchmark Analyzer

Analyzers that process raw execution results into insights and visualizations.

Analyzers aggregate measurement counts, compute probabilities, and optionally generate plots. The base class is subclassed for benchmark-specific analysis logic.

BenchmarkAnalyzer

Bases: ABC

Base class for execution result analyzers.

Receives a list of ExecutionResult objects (circuit measurements and metrics) and produces an AnalysisResult with aggregated metrics and optional artifacts. Subclasses implement benchmark-specific analysis logic (e.g., fidelity, overlap).

analyze abstractmethod

analyze(
    execution_results: List[ExecutionResult],
    context: RunContext,
) -> AnalysisResult

Analyze raw execution results.

DefaultAnalyzer

Bases: BenchmarkAnalyzer

Standard result aggregator and visualizer.

Combines all measurement counts, computes outcome probabilities, identifies the most frequent bitstring, and optionally generates a probability bar plot. Returns metrics and plot artifacts for the benchmark report.

analyze

analyze(
    execution_results: List[ExecutionResult],
    context: RunContext,
) -> AnalysisResult

Analyze a list of execution results.