quantcore_circuits.circuit.bridges

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 (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 (quantcore_circuits.pdk.JunctionProcess: Δ = 1.4 meV, R_n 40–50 kΩ, f_q 4–8 GHz) sizes junctions: size_junction() (target f_q and C_Σ → E_J, L_J, R_n, area, finger widths), junction_from_fingers() (drawn fingers → R_n, I_c, L_J, E_J, C_J), fingers_for_lj() (what the junction cells use).

  4. Ports: a 50 Ω resistor on feedline nodes (κ in QuCat).

  5. Participations → ϕ_zpf: quantcore_circuits.analysis.epr.

Units: fF, nH, Ω, µm, GHz.

Attributes

Classes

JunctionSizing

Result of size_junction(): the target, the ideal junction, and the junction as drawn (fingers on the

JunctionValues

Electrical values of n identical trilayer cross junctions in parallel (n = 2: a symmetric SQUID at zero

Functions

area_from_rn(rn_ohm, rn_area_ohm_um2) → float

Junction area (µm²) for a normal-state resistance, from the specific resistance Rn·A (Ω·µm²).

branch_capacitances(maxwell_fF, labels[, ground]) → dict[tuple[str, str], float]

Maxwell matrix (signal nets only, as Q3D/Elmer/Palace export it) → branch capacitances in fF.

c_from_ec(ec_GHz) → float

ec_from_c(c_fF) → float

E_C/h (GHz) = e² / (2 C) / h.

ej_for_f01(f01_GHz, ec_GHz) → float

E_J/h (GHz) that gives f01_GHz at ec_GHz (inverse of transmon_f01()).

ej_from_lj(lj_nH) → float

E_J/h (GHz) = (Φ0/2π)² / L_J / h.

fingers_for_lj(lj_nH[, n, pdk, bent_um]) → tuple[float, float, list[str]]

(straight µm, bent µm, notes) of n parallel junctions with total L_J lj_nH on the PDK rule.

ic_from_lj(lj_nH) → float

ic_from_rn(rn_ohm[, delta_meV]) → float

Ambegaokar–Baratoff critical current (A) at T = 0.

junction_from_fingers(straight_um[, bent_um, n, pdk]) → 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

junction_process([pdk])

The JunctionProcess of a PDK (name, Pdk or None = default PDK); a

lj_from_area(area_um2, rn_area_ohm_um2[, delta_meV]) → float

lj_from_ej(ej_GHz) → float

lj_from_ic(ic_A) → float

Josephson inductance (nH).

lj_from_rn(rn_ohm[, delta_meV]) → float

Josephson inductance (nH) of a junction of normal-state resistance rn_ohm (Ambegaokar–Baratoff, T = 0).

maxwell_from_branches(branches, labels[, ground])

Inverse of branch_capacitances() (for tests and for building Maxwell matrices from a circuit).

quarter_wave_lc(f_r_GHz[, z0]) → tuple[float, float]

(C fF, L nH) of a λ/4 resonator near resonance seen from its open end.

rn_from_area(area_um2, rn_area_ohm_um2) → float

Normal-state resistance from junction area and the PDK specific resistance Rn·A (Ω·µm²).

rn_from_ic(ic_A[, delta_meV]) → float

rn_from_lj(lj_nH[, delta_meV]) → float

size_junction(f_q_GHz, c_sigma_fF[, pdk, n, ...]) → JunctionSizing

Size a Quantcore trilayer junction for a transmon frequency.

squid_ej(ej_sum_GHz, asym, flux_phi0) → float

Effective EJ of an asymmetric DC SQUID (d = (EJ1 − EJ2)/(EJ1 + EJ2)) at flux Φ/Φ0.

stack_capacitance_scale(eps_from, eps_to) → float

Approximate rescaling of planar (CPW-like) capacitances between substrates: C ∝ (εr + 1)/2.

tl_resonator(length_um, a_um, b_um[, pdk_name, guess_GHz])

λ/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

transmon_f01(ej_GHz, ec_GHz) → float

Transmon 0→1 frequency (GHz), asymptotic √(8 E_J E_C) − E_C (E_J/E_C ≫ 1).

Module Contents

class quantcore_circuits.circuit.bridges.JunctionSizing

Result of 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).

as_dict() → dict
design_junction() → dict

design.json instance junction values of the drawn junction (L_J total, C_J total).

junction_params() → dict

Parameters for the trilayer junction cells (junction_params of an Xmon, a Quantcore* cell).

c_sigma_fF: float
drawn: JunctionValues
ec_GHz: float
ej_GHz: float
f_in_window: bool
f_q_GHz: float
f_q_drawn_GHz: float
property finger_width: float
lj_nH: float
n: int
notes: list[str] = []
rn_in_window: bool
rn_kohm: float
property second_finger_width: float
class quantcore_circuits.circuit.bridges.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.

as_dict() → dict
area_each_um2: float
bent_um: float
cj_fF: float
ej_GHz: float
ic_each_nA: float
lj_nH: float
n: int
rn_each_kohm: float
rn_in_window: bool
rn_kohm: float
straight_um: float
quantcore_circuits.circuit.bridges.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²).

quantcore_circuits.circuit.bridges.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).

quantcore_circuits.circuit.bridges.c_from_ec(ec_GHz: float) → float
quantcore_circuits.circuit.bridges.ec_from_c(c_fF: float) → float

E_C/h (GHz) = e² / (2 C) / h.

quantcore_circuits.circuit.bridges.ej_for_f01(f01_GHz: float, ec_GHz: float) → float

E_J/h (GHz) that gives f01_GHz at ec_GHz (inverse of transmon_f01()).

quantcore_circuits.circuit.bridges.ej_from_lj(lj_nH: float) → float

E_J/h (GHz) = (Φ0/2π)² / L_J / h.

quantcore_circuits.circuit.bridges.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).

quantcore_circuits.circuit.bridges.ic_from_lj(lj_nH: float) → float
quantcore_circuits.circuit.bridges.ic_from_rn(rn_ohm: float, delta_meV: float = DELTA_NB_MEV) → float

Ambegaokar–Baratoff critical current (A) at T = 0.

quantcore_circuits.circuit.bridges.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).

quantcore_circuits.circuit.bridges.junction_process(pdk=None)

The JunctionProcess of a PDK (name, Pdk or None = default PDK); a JunctionProcess passes through.

quantcore_circuits.circuit.bridges.lj_from_area(area_um2: float, rn_area_ohm_um2: float, delta_meV: float = DELTA_NB_MEV) → float
quantcore_circuits.circuit.bridges.lj_from_ej(ej_GHz: float) → float
quantcore_circuits.circuit.bridges.lj_from_ic(ic_A: float) → float

Josephson inductance (nH).

quantcore_circuits.circuit.bridges.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).

quantcore_circuits.circuit.bridges.maxwell_from_branches(branches: dict[tuple[str, str], float], labels: list[str], ground: str = 'ground')

Inverse of branch_capacitances() (for tests and for building Maxwell matrices from a circuit).

quantcore_circuits.circuit.bridges.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.

quantcore_circuits.circuit.bridges.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²).

quantcore_circuits.circuit.bridges.rn_from_ic(ic_A: float, delta_meV: float = DELTA_NB_MEV) → float
quantcore_circuits.circuit.bridges.rn_from_lj(lj_nH: float, delta_meV: float = DELTA_NB_MEV) → float
quantcore_circuits.circuit.bridges.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 (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.

quantcore_circuits.circuit.bridges.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.

quantcore_circuits.circuit.bridges.stack_capacitance_scale(eps_from: float, eps_to: float) → float

Approximate rescaling of planar (CPW-like) capacitances between substrates: C ∝ (εr + 1)/2.

quantcore_circuits.circuit.bridges.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.

quantcore_circuits.circuit.bridges.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).

quantcore_circuits.circuit.bridges.DELTA_NB_MEV = 1.4
quantcore_circuits.circuit.bridges.E = 1.602176634e-19
quantcore_circuits.circuit.bridges.H = 6.62607015e-34
quantcore_circuits.circuit.bridges.PHI0 = 2.067833848e-15