quantcore_circuits.lom.simulate =============================== .. py:module:: quantcore_circuits.lom.simulate .. autoapi-nested-parse:: 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 ---------- .. autoapisummary:: quantcore_circuits.lom.simulate.H_PLANCK quantcore_circuits.lom.simulate.PHI0_RED Classes ------- .. autoapisummary:: quantcore_circuits.lom.simulate.LomResult quantcore_circuits.lom.simulate.Mode Functions --------- .. autoapisummary:: quantcore_circuits.lom.simulate.simulate Module Contents --------------- .. py:class:: LomResult .. py:attribute:: chi_MHz :type: list[list[float]] .. py:attribute:: dressed :type: dict .. py:attribute:: modes :type: list[Mode] .. py:attribute:: netlist :type: list[dict] :value: [] .. py:attribute:: notes :type: list[str] :value: [] .. py:attribute:: params :type: dict .. py:attribute:: zz_MHz :type: dict[str, float] .. py:class:: Mode .. py:attribute:: anharmonicity_MHz :type: float .. py:attribute:: f_GHz :type: float .. py:attribute:: index :type: int .. py:attribute:: kappa_MHz :type: float .. py:attribute:: kind :type: str .. py:attribute:: label :type: str .. py:attribute:: participation :type: dict[str, float] .. py:function:: 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). .. py:data:: H_PLANCK :value: 6.62607015e-34 .. py:data:: PHI0_RED :value: 3.2910597827380374e-16