quantcore_circuits.lom.simulate

LOM simulation of any circuit: circuit.json (+ values) → QuCat network → modes, κ → QuTiP Hamiltonian.

This is the “simulate the lumped circuit later” path: it needs no FEM. Give it a circuit exported from a layout (component estimates), or one filled from HFSS/Q3D/Sonnet results, and it returns per-mode frequencies, linewidths and anharmonicities, the cross-Kerr matrix, and the dressed spectrum from diagonalising QuCat’s circuit Hamiltonian (junction cosine Taylor-expanded) with QuTiP. Modes are named after the element that stores most of their inductive energy: a junction (Q1) or a resonator’s λ/4 inductance (R1).

Element mapping: C → capacitor, JJ/SQUID → junction (Lj, + Cj in parallel), TLres λ/4 or λ/2 → parallel LC at its node (fundamental mode), HANGER → the coupling capacitance that gives the hanger’s κ into the feedline load (κ = ω² C_k² R_load / C_r), R → port resistor, L → inductor.

Before QuCat, nodes that only capacitors touch (unused couplers, the far plate of a coupling capacitor, a merged coupler bus) are eliminated exactly by Kron reduction of the capacitance matrix: such a node carries no charge, so C_red = C_kk − C_ke C_ee⁻¹ C_ek changes nothing physical. It removes QuCat’s spurious ω ≈ 0 roots and keeps its polynomial solve small (a 4-qubit ring: 12 → 4 nodes). The QuTiP space is capped at max_dim states (fewer levels per mode when many modes are kept); modes are labelled one-to-one with their dominant inductive element.

ZZ (static, between qubit modes): ζ = E11 − E10 − E01 + E00 on the dressed levels (bare normal-mode states matched by overlap), in LomResult.zz_MHz for qubit pairs that are circuit neighbours (a path of elements between their junction nodes that crosses no other qubit and no port/feedline load) whose modes are not hybridised, and in dressed["zz"] for every pair (with neighbours / hybridised flags). It is exact within the Taylor-expanded junction cosine and the truncation: it equals a charge-basis diagonalisation of two coupled transmons, and second-order perturbation theory with the transmon matrix elements (tests). The textbook 2g²(α1 + α2)/((Δ + α1)(Δ − α2)) with the harmonic g is ≈ 15 % larger for E_J/E_C ≈ 57. When two qubit modes hybridise (|Δ| ≲ g), per-qubit ZZ is not defined.

Validation. Every network is also solved as a lossless normal-mode problem (K v = ω² C v, junctions linearised). When QuCat’s roots or zero-point fluctuations disagree with it (degenerate or near-degenerate roots: identical coupled qubits, a floating transmon between strongly coupled resonators), the modes and the Hamiltonian come from that solve (same form as QuCat’s), κ from the nearest QuCat mode, and a note says so.

Attributes

Classes

Functions

simulate(filled[, taylor, excitations, max_modes, max_dim]) → LomResult

Normal modes + QuTiP dressed spectrum of filled (see module docstring).

Module Contents

class quantcore_circuits.lom.simulate.LomResult
chi_MHz: list[list[float]]
dressed: dict
modes: list[Mode]
netlist: list[dict] = []
notes: list[str] = []
params: dict
zz_MHz: dict[str, float]
class quantcore_circuits.lom.simulate.Mode
anharmonicity_MHz: float
f_GHz: float
index: int
kappa_MHz: float
kind: str
label: str
participation: dict[str, float]
quantcore_circuits.lom.simulate.simulate(filled, taylor: int = 8, excitations: list[int] | None = None, max_modes: int = 4, max_dim: int = 2500) → LomResult

Normal modes + QuTiP dressed spectrum of filled (see module docstring).

max_modes modes (qubits first, then by frequency) enter the QuTiP Hamiltonian, with excitations Fock levels each (default: 10 per qubit, 5 per resonator, reduced to keep ≤ max_dim states).

quantcore_circuits.lom.simulate.H_PLANCK = 6.62607015e-34
quantcore_circuits.lom.simulate.PHI0_RED = 3.2910597827380374e-16