Get Circuit Metrics Evolution
Get the ordered analytics snapshots recorded for a circuit.
Use this tool to show how metrics such as depth, two-qubit gate count, and qubit count changed across successive transformations of a circuit, for example original to transpiled to compressed.
When to Use:
- Call this when the caller asks how a circuit improved or degraded through transpilation or compression.
- Call this after
compute_circuit_analyticswithanalytics_type='evolution'has recorded a snapshot.
Constraints:
- An empty list is a valid result and means no evolution snapshots have been recorded for this circuit yet.
- Snapshots are stored per circuit, so compare against the parent circuit ID rather than expecting cross-circuit history here.
Notes:
- For agent-facing output, report the first and last snapshot plus the delta on the metrics the caller cares about instead of every entry.
Args: circuit_id: Circuit identifier from a prior MCP response. user: Authenticated user resolved from the API key. db: Active database session.
Returns: Analytics snapshots in recorded order, oldest first.
Raises:
HTTPException: Raised with 404 when the circuit or its experiment is
not available to the caller.
Authorizations
Path Parameters
Response
Successful Response
Number of qubits (must be >= 1)
x >= 1