quantcore_circuits.circuit.bridges ================================== .. py:module:: quantcore_circuits.circuit.bridges .. autoapi-nested-parse:: Mathematical bridges from simulation results to circuit element values. 1. Maxwell C-matrix → branch capacitances: C_ij = −C_ij(Maxwell) (i ≠ j), C_i0 = Σ_j C_ij(Maxwell). 2. Distributed λ/4 resonator → LC at its open end: C_r = π/(4 ω_r Z0), L_r = 4 Z0/(π ω_r); v_ph and Z0 from Metal's CPW formulas on the PDK stack (:func:`quantcore_circuits.analysis.synthesis.cpw_properties`). 3. Junction: Rn ↔ Ic (Ambegaokar–Baratoff at T = 0: Ic·Rn = πΔ/2e) ↔ Lj = Φ0/(2π Ic); area → Rn through the PDK specific resistance; SQUID → EJ(Φ) = EJΣ \|cos πΦ\| √(1 + d² tan² πΦ). The Quantcore trilayer rule (:class:`quantcore_circuits.pdk.JunctionProcess`: Δ = 1.4 meV, R_n 40–50 kΩ, f_q 4–8 GHz) sizes junctions: :func:`size_junction` (target f_q and C_Σ → E_J, L_J, R_n, area, finger widths), :func:`junction_from_fingers` (drawn fingers → R_n, I_c, L_J, E_J, C_J), :func:`fingers_for_lj` (what the junction cells use). 4. Ports: a 50 Ω resistor on feedline nodes (κ in QuCat). 5. Participations → ϕ_zpf: :mod:`quantcore_circuits.analysis.epr`. Units: fF, nH, Ω, µm, GHz. Attributes ---------- .. autoapisummary:: quantcore_circuits.circuit.bridges.DELTA_NB_MEV quantcore_circuits.circuit.bridges.E quantcore_circuits.circuit.bridges.H quantcore_circuits.circuit.bridges.PHI0 Classes ------- .. autoapisummary:: quantcore_circuits.circuit.bridges.JunctionSizing quantcore_circuits.circuit.bridges.JunctionValues Functions --------- .. autoapisummary:: quantcore_circuits.circuit.bridges.area_from_rn quantcore_circuits.circuit.bridges.branch_capacitances quantcore_circuits.circuit.bridges.c_from_ec quantcore_circuits.circuit.bridges.ec_from_c quantcore_circuits.circuit.bridges.ej_for_f01 quantcore_circuits.circuit.bridges.ej_from_lj quantcore_circuits.circuit.bridges.fingers_for_lj quantcore_circuits.circuit.bridges.ic_from_lj quantcore_circuits.circuit.bridges.ic_from_rn quantcore_circuits.circuit.bridges.junction_from_fingers quantcore_circuits.circuit.bridges.junction_process quantcore_circuits.circuit.bridges.lj_from_area quantcore_circuits.circuit.bridges.lj_from_ej quantcore_circuits.circuit.bridges.lj_from_ic quantcore_circuits.circuit.bridges.lj_from_rn quantcore_circuits.circuit.bridges.maxwell_from_branches quantcore_circuits.circuit.bridges.quarter_wave_lc quantcore_circuits.circuit.bridges.rn_from_area quantcore_circuits.circuit.bridges.rn_from_ic quantcore_circuits.circuit.bridges.rn_from_lj quantcore_circuits.circuit.bridges.size_junction quantcore_circuits.circuit.bridges.squid_ej quantcore_circuits.circuit.bridges.stack_capacitance_scale quantcore_circuits.circuit.bridges.tl_resonator quantcore_circuits.circuit.bridges.transmon_f01 Module Contents --------------- .. py:class:: JunctionSizing Result of :func:`size_junction`: the target, the ideal junction, and the junction as drawn (fingers on the PDK grid), with window checks (R_n 40–50 kΩ and f_q 4–8 GHz on the default rule). .. py:method:: as_dict() -> dict .. py:method:: design_junction() -> dict ``design.json`` instance ``junction`` values of the drawn junction (L_J total, C_J total). .. py:method:: junction_params() -> dict Parameters for the trilayer junction cells (``junction_params`` of an Xmon, a ``Quantcore*`` cell). .. py:attribute:: c_sigma_fF :type: float .. py:attribute:: drawn :type: JunctionValues .. py:attribute:: ec_GHz :type: float .. py:attribute:: ej_GHz :type: float .. py:attribute:: f_in_window :type: bool .. py:attribute:: f_q_GHz :type: float .. py:attribute:: f_q_drawn_GHz :type: float .. py:property:: finger_width :type: float .. py:attribute:: lj_nH :type: float .. py:attribute:: n :type: int .. py:attribute:: notes :type: list[str] :value: [] .. py:attribute:: rn_in_window :type: bool .. py:attribute:: rn_kohm :type: float .. py:property:: second_finger_width :type: float .. py:class:: JunctionValues Electrical values of ``n`` identical trilayer cross junctions in parallel (n = 2: a symmetric SQUID at zero flux). Per-junction values carry ``_each``; ``rn_kohm``, ``lj_nH``, ``ej_GHz``, ``cj_fF`` are the device totals. .. py:method:: as_dict() -> dict .. py:attribute:: area_each_um2 :type: float .. py:attribute:: bent_um :type: float .. py:attribute:: cj_fF :type: float .. py:attribute:: ej_GHz :type: float .. py:attribute:: ic_each_nA :type: float .. py:attribute:: lj_nH :type: float .. py:attribute:: n :type: int .. py:attribute:: rn_each_kohm :type: float .. py:attribute:: rn_in_window :type: bool .. py:attribute:: rn_kohm :type: float .. py:attribute:: straight_um :type: float .. py:function:: area_from_rn(rn_ohm: float, rn_area_ohm_um2: float) -> float Junction area (µm²) for a normal-state resistance, from the specific resistance Rn·A (Ω·µm²). .. py:function:: branch_capacitances(maxwell_fF, labels: list[str], ground: str = 'ground') -> dict[tuple[str, str], float] Maxwell matrix (signal nets only, as Q3D/Elmer/Palace export it) → branch capacitances in fF. Keys are ``(net, ground)`` for capacitance to ground and ``(net_i, net_j)`` (i < j in ``labels`` order). .. py:function:: c_from_ec(ec_GHz: float) -> float .. py:function:: ec_from_c(c_fF: float) -> float E_C/h (GHz) = e² / (2 C) / h. .. py:function:: ej_for_f01(f01_GHz: float, ec_GHz: float) -> float E_J/h (GHz) that gives ``f01_GHz`` at ``ec_GHz`` (inverse of :func:`transmon_f01`). .. py:function:: ej_from_lj(lj_nH: float) -> float E_J/h (GHz) = (Φ0/2π)² / L_J / h. .. py:function:: fingers_for_lj(lj_nH: float, n: int = 1, pdk=None, bent_um: float | None = None) -> tuple[float, float, list[str]] (straight µm, bent µm, notes) of ``n`` parallel junctions with total L_J ``lj_nH`` on the PDK rule. The bent finger stays at ``bent_um`` (default the PDK's ``bent_finger_um``); the straight finger gives the area, rounded to ``finger_grid_um``. Below ``finger_range_um[0]`` the straight finger is held at the minimum and the bent finger takes the area; above the maximum it is clipped (notes say so). .. py:function:: ic_from_lj(lj_nH: float) -> float .. py:function:: ic_from_rn(rn_ohm: float, delta_meV: float = DELTA_NB_MEV) -> float Ambegaokar–Baratoff critical current (A) at T = 0. .. py:function:: junction_from_fingers(straight_um: float, bent_um: float | None = None, n: int = 1, pdk=None) -> JunctionValues Drawn cross junction(s) → R_n, I_c, L_J, E_J, C_J on the PDK junction rule (``bent_um`` None or 0: same as the straight finger, as the trilayer cells' ``second_finger_width = 0``). .. py:function:: junction_process(pdk=None) The :class:`~quantcore_circuits.pdk.JunctionProcess` of a PDK (name, ``Pdk`` or None = default PDK); a ``JunctionProcess`` passes through. .. py:function:: lj_from_area(area_um2: float, rn_area_ohm_um2: float, delta_meV: float = DELTA_NB_MEV) -> float .. py:function:: lj_from_ej(ej_GHz: float) -> float .. py:function:: lj_from_ic(ic_A: float) -> float Josephson inductance (nH). .. py:function:: lj_from_rn(rn_ohm: float, delta_meV: float = DELTA_NB_MEV) -> float Josephson inductance (nH) of a junction of normal-state resistance ``rn_ohm`` (Ambegaokar–Baratoff, T = 0). .. py:function:: maxwell_from_branches(branches: dict[tuple[str, str], float], labels: list[str], ground: str = 'ground') Inverse of :func:`branch_capacitances` (for tests and for building Maxwell matrices from a circuit). .. py:function:: quarter_wave_lc(f_r_GHz: float, z0: float = 50.0) -> tuple[float, float] (C fF, L nH) of a λ/4 resonator near resonance seen from its open end. .. py:function:: rn_from_area(area_um2: float, rn_area_ohm_um2: float) -> float Normal-state resistance from junction area and the PDK specific resistance Rn·A (Ω·µm²). .. py:function:: rn_from_ic(ic_A: float, delta_meV: float = DELTA_NB_MEV) -> float .. py:function:: rn_from_lj(lj_nH: float, delta_meV: float = DELTA_NB_MEV) -> float .. py:function:: size_junction(f_q_GHz: float, c_sigma_fF: float, pdk=None, n: int = 1, c_includes_junction: bool = True) -> JunctionSizing Size a Quantcore trilayer junction for a transmon frequency. ``c_sigma_fF`` is the total shunt capacitance (``c_includes_junction=False``: without the junction's own C_J, which is then added from the sized area, iterated to convergence). E_C = e²/2C_Σ, E_J = (f_q + E_C)²/(8 E_C) (inverse of the asymptotic transmon f01), L_J = (Φ0/2π)²/E_J; each of the ``n`` parallel junctions (n = 2: a symmetric SQUID at zero flux) gets n·L_J → R_n (Ambegaokar–Baratoff, Δ of the PDK) → area = R_n·A / R_n → fingers (:func:`fingers_for_lj`). The drawn junction (fingers on the grid) is re-evaluated; ``rn_in_window`` checks the device R_n (per junction / n) against ``rn_target_kohm`` and ``f_in_window`` the drawn f_q against ``f_q_range_GHz``; ``notes`` say what is outside. .. py:function:: squid_ej(ej_sum_GHz: float, asym: float, flux_phi0: float) -> float Effective EJ of an asymmetric DC SQUID (d = (EJ1 − EJ2)/(EJ1 + EJ2)) at flux Φ/Φ0. .. py:function:: stack_capacitance_scale(eps_from: float, eps_to: float) -> float Approximate rescaling of planar (CPW-like) capacitances between substrates: C ∝ (εr + 1)/2. .. py:function:: tl_resonator(length_um: float, a_um: float, b_um: float, pdk_name: str | None = None, guess_GHz: float = 7.0) λ/4 CPW resonator of ``length_um`` → {f_GHz, Z0_ohm, vp_m_s, eps_eff, C_fF, L_nH, + L_geo/L_k/alpha_k} (fixed point on f). The film's kinetic inductance (``pdk.kinetic``, decision #45) is in v_p and Z0: f = f_geo/√(1+L_k/L_geo); ``alpha_k`` = L_k/(L_k+L_geo) of the line and ``f_geo_GHz`` the purely geometric frequency are reported. .. py:function:: transmon_f01(ej_GHz: float, ec_GHz: float) -> float Transmon 0→1 frequency (GHz), asymptotic √(8 E_J E_C) − E_C (E_J/E_C ≫ 1). .. py:data:: DELTA_NB_MEV :value: 1.4 .. py:data:: E :value: 1.602176634e-19 .. py:data:: H :value: 6.62607015e-34 .. py:data:: PHI0 :value: 2.067833848e-15