quantcore_circuits.circuit.adapters

Estimator adapters (M9): solve(filled) -> ParamSet with Metal LOM, QuCat, SQcircuit and scqubits.

A ParamSet is a flat dict keyed like the design targets: "<Q>.f_q_GHz", "<Q>.alpha_MHz", "<Q>.EJ_GHz", "<Q>.EC_GHz", "<R>.f_GHz" (dressed resonator), "<R>.g_MHz", "<R>.chi_MHz" (χ = E11 − E10 − E01 + E00) and "<R>.kappa_MHz" when a feedline coupling is known. Every adapter sees the same filled circuit (same C-matrix, Lj, λ/4 LC) and quantises it its own way:

  • metal_lom — Quantum Metal LOM 2.0: TRANSMON + TL_RESONATOR subsystems on the Maxwell matrix

  • qucat — QuCat lumped network (C-matrix branches + JJ + λ/4 parallel LC): its circuit Hamiltonian (junction Taylor-expanded) diagonalised with QuTiP

  • sqcircuit — SQcircuit exact diagonalisation of the 2-node circuit (charge × harmonic basis)

  • scqubits — scqubits Transmon + Oscillator HilbertSpace with the analytic loaded coupling

  • pyepr — not a LOM: pyEPR’s Hamiltonian from an eigenmode job’s junction participations (eigenmode_epr); it runs only when the filled circuit carries EPR results (filled.results["epr"])

Attributes

Functions

epr_modes(filled[, results]) → dict[str, dict]

Qubit and resonator mode of each pair in the job's EPR result (filled.results["epr"], or results).

metal_lom(filled) → ParamSet

pyepr(filled) → ParamSet

pyEPR on eigenmode data (eigenmode_epr job): dressed f_q, α, f_r and χ from the EPR Hamiltonian

qucat(filled[, taylor, excitations]) → ParamSet

QuCat: normal modes + the circuit Hamiltonian (junction cosine Taylor-expanded to taylor), diagonalised

scqubits(filled) → ParamSet

solve_all(filled[, names]) → dict[str, ParamSet]

Run each adapter; a failing estimator is reported as {"error": message} instead of aborting the rest.

sqcircuit(filled) → ParamSet

Module Contents

quantcore_circuits.circuit.adapters.epr_modes(filled: quantcore_circuits.circuit.fill.FilledCircuit, results: dict | None = None) → dict[str, dict]

Qubit and resonator mode of each pair in the job’s EPR result (filled.results["epr"], or results).

The qubit mode is the one with the largest participation of the qubit’s junction; the resonator mode is the remaining mode closest to the pair’s claw-loaded λ/4 (LOM) frequency. Returns qubit → {“qm”, “rm”, “junction”}. A pair whose qubit has no junction in this result (a subset job without it) is left out.

quantcore_circuits.circuit.adapters.metal_lom(filled: quantcore_circuits.circuit.fill.FilledCircuit) → ParamSet
quantcore_circuits.circuit.adapters.pyepr(filled: quantcore_circuits.circuit.fill.FilledCircuit) → ParamSet

pyEPR on eigenmode data (eigenmode_epr job): dressed f_q, α, f_r and χ from the EPR Hamiltonian (pyEPR numerical diagonalisation of the junction participations, quantcore_circuits.analysis.epr. epr_analysis()), κ = f/Q of the resonator mode (50 Ω-terminated feedline). Empty without EPR results.

quantcore_circuits.circuit.adapters.qucat(filled: quantcore_circuits.circuit.fill.FilledCircuit, taylor: int = 8, excitations: tuple[int, int] = (10, 10)) → ParamSet

QuCat: normal modes + the circuit Hamiltonian (junction cosine Taylor-expanded to taylor), diagonalised with QuTiP. States are identified by overlap with the bare Fock states of the (qubit, resonator) modes.

excitations per mode: 10 resonator levels (not 6) keep α converged for strongly anharmonic qubits (a Metal TransmonPocket with α ≈ −460 MHz: −416 MHz with 6 levels, −457.5 with 10, SQcircuit −459.2).

quantcore_circuits.circuit.adapters.scqubits(filled: quantcore_circuits.circuit.fill.FilledCircuit) → ParamSet
quantcore_circuits.circuit.adapters.solve_all(filled: quantcore_circuits.circuit.fill.FilledCircuit, names: list[str] | None = None) → dict[str, ParamSet]

Run each adapter; a failing estimator is reported as {"error": message} instead of aborting the rest.

pyepr joins the model’s estimators automatically when the filled circuit carries EPR results.

quantcore_circuits.circuit.adapters.sqcircuit(filled: quantcore_circuits.circuit.fill.FilledCircuit) → ParamSet
quantcore_circuits.circuit.adapters.ADAPTERS
quantcore_circuits.circuit.adapters.ParamSet