quantcore_circuits.circuit.hamiltonian

QuTiP Hamiltonian of a transmon + λ/4 readout pair, and the standard checks (M10).

Model (cyclic frequencies, GHz): the transmon in the charge basis, H_t = 4E_C(n̂ − n_g)² − E_J cos φ̂, truncated to its nq lowest eigenstates, plus the resonator f_r a†a and the charge coupling g_n n̂ (a + a†) (no rotating-wave approximation). Inputs come from the filled circuit ( two_node_model()): loaded E_C, E_J from Lj, the claw-loaded λ/4 frequency and g_n.

Checks:

  • dressed() — dressed levels by bare-state overlap → f_q, f_r, α, χ (χ = E11 − E10 − E01 + E00)

  • readout() — simulated resonator transmission with the qubit in |g⟩ or |e⟩: weak coherent probe, steady state of the Lindblad equation in the dressed basis (drive and dissipators kept to the ΔN = ±1 terms), peak positions → χ_readout. Qubit relaxation (|g⟩) or incoherent pumping (|e⟩) at a rate ≪ κ pins the qubit state.

  • flux_curve() — f01/f12 vs flux of a (possibly asymmetric) SQUID transmon

  • purcell_t1_us() — Purcell limit (Δ/g)²/κ

Classes

Functions

dressed(model[, n_levels]) → dict

flux_curve(ej_sum_GHz, ec_GHz[, asym, phis]) → dict

f01 and f12 (GHz) of a SQUID transmon vs flux Φ/Φ0.

from_pair(pair[, nq, nr]) → TransmonResonator

purcell_t1_us(f_q_GHz, f_r_GHz, g_MHz, kappa_MHz) → float

T1 limit from decay through the readout resonator, (Δ/g)²/κ (κ, Δ, g as cyclic frequencies).

readout(model[, kappa_MHz, span_MHz, n_points, ...]) → dict

Simulated transmission ⟨a⟩ vs probe frequency for the qubit in |g⟩ and |e⟩ (see module docstring).

Module Contents

class quantcore_circuits.circuit.hamiltonian.TransmonResonator
latex() → str
operators()
transmon()

(energies GHz, n̂ in the eigenbasis) of the bare transmon, nq levels.

EC_GHz: float
EJ_GHz: float
f_r_GHz: float
property g_MHz: float
g_n_MHz: float
ncut: int = 20
ng: float = 0.0
nq: int = 6
nr: int = 8
quantcore_circuits.circuit.hamiltonian.dressed(model: TransmonResonator, n_levels: int = 10) → dict
quantcore_circuits.circuit.hamiltonian.flux_curve(ej_sum_GHz: float, ec_GHz: float, asym: float = 0.0, phis=None) → dict

f01 and f12 (GHz) of a SQUID transmon vs flux Φ/Φ0.

quantcore_circuits.circuit.hamiltonian.from_pair(pair, nq: int = 6, nr: int = 8) → TransmonResonator
quantcore_circuits.circuit.hamiltonian.purcell_t1_us(f_q_GHz: float, f_r_GHz: float, g_MHz: float, kappa_MHz: float) → float

T1 limit from decay through the readout resonator, (Δ/g)²/κ (κ, Δ, g as cyclic frequencies).

quantcore_circuits.circuit.hamiltonian.readout(model: TransmonResonator, kappa_MHz: float = 1.0, span_MHz: float | None = None, n_points: int = 81, drive_over_kappa: float = 0.05, qubit_rate_over_kappa: float = 0.05, nq: int = 3, nr: int = 3) → dict

Simulated transmission ⟨a⟩ vs probe frequency for the qubit in |g⟩ and |e⟩ (see module docstring).

The master equation uses a reduced nq × nr copy of the model (a weak probe only populates the lowest levels); the reported chi_eigen_MHz comes from the full-size model. The qubit pinning rate must beat the Purcell decay through the resonator (≈ κ g²/Δ²) but stay ≪ κ; P_e_at_peak_* reports how well it worked.