quantcore_circuits.loop

The analysis half of the design loop, step by step, recording everything for the dashboard.

analyse() — job results → circuit.json (filled: design vs extracted values) → Metal LOM / QuCat / SQcircuit / scqubits → QuTiP Hamiltonian (dressed levels, simulated readout χ, flux curve) → consensus vs targets. The design is planned once for the circuit and its fill; with out_dir the four estimators’ results are kept in estimates_cache.json and reused while the circuit they read is the same (a second analysis of the same design and jobs, e.g. Propose after Simulate or Import, skips them). feedback() — a surrogate per qubit–readout pair anchored on that point (FEM or the layout’s estimates; every qubit class with a LOM model, λ/4 and λ/2 readouts, quantcore_circuits.codesign) → proposed knobs → design revision (rebuilt and checked, or only written for a preview), with notes on what could not be tuned.

Both update a Run (build/<design>/state.json) when given one, and return plain data for notebooks and plots (quantcore_circuits.plots).

Attributes

Classes

Functions

analyse(design[, job_dir, group, run, readout, ...]) → Analysis

Job → circuit → estimators → QuTiP → consensus (module docstring). run None: the dashboard tracking

dashboard_circuit(filled) → dict

dashboard_consensus(rows) → list[dict]

dashboard_targets(rows) → list[dict]

feedback(an[, run, design_source, iteration, bounds, ...])

Surrogate from this FEM point → knobs → revision iteration (built + netlist-checked). Returns

pair_plot_id(kind, qubit, an) → str

Plot id of a per-pair plot (levels, readout, flux): bare for the first pair, <kind>_<qubit>

update_cards(run, design, an[, proposal]) → None

Parameter cards + design summary for the dashboard (see quantcore_circuits.cards).

Module Contents

class quantcore_circuits.loop.Analysis
dressed: dict | None = None
estimates: dict
filled: object
flux: dict | None = None
goal: dict
hamiltonian: object | None = None
model: object
pair_results: dict[str, dict]
plan: object | None = None
plots: list[dict] = []
readout: dict | None = None
rows: list
quantcore_circuits.loop.analyse(design, job_dir=None, group: str | None = None, run=None, readout: bool = True, kappa_MHz: float | None = None, out_dir: str | pathlib.Path | None = None) → Analysis

Job → circuit → estimators → QuTiP → consensus (module docstring). run None: the dashboard tracking session’s run (quantcore_circuits.track.start()), if there is one.

quantcore_circuits.loop.dashboard_circuit(filled) → dict
quantcore_circuits.loop.dashboard_consensus(rows) → list[dict]
quantcore_circuits.loop.dashboard_targets(rows) → list[dict]
quantcore_circuits.loop.feedback(an: Analysis, run=None, design_source=None, iteration: int = 1, bounds=None, build_revision: bool = True)

Surrogate from this FEM point → knobs → revision iteration (built + netlist-checked). Returns (proposal, revision_path, build_result).

Every transmon–readout pair of the circuit gets a surrogate (quantcore_circuits.codesign. surrogate_from_fill(): any qubit class with a LOM model, λ/4 and λ/2 readouts); what cannot be tuned (no pair, no clean knob, a drawn junction) is listed in proposal.notes. build_revision=False (a preview, e.g. qcc results propose) writes the revision without building it: build_result is then None.

quantcore_circuits.loop.pair_plot_id(kind: str, qubit: str, an: Analysis) → str

Plot id of a per-pair plot (levels, readout, flux): bare for the first pair, <kind>_<qubit> for the others.

quantcore_circuits.loop.update_cards(run, design, an, proposal=None) → None

Parameter cards + design summary for the dashboard (see quantcore_circuits.cards).

quantcore_circuits.loop.BRANCH_TYPE
quantcore_circuits.loop.ESTIMATES_CACHE = 'estimates_cache.json'
quantcore_circuits.loop.TARGET_LABEL