quantcore_circuits.lom.estimates

Analytic element estimates for component LOM models (no FEM): planar capacitances by conformal mapping.

Everything here is a closed-form, quasi-static estimate for thin conductors on a thick substrate (sapphire εr 10.25 in the default PDK), with the field split equally between substrate and air: ε_eff = (εr + 1)/2. It is meant for a first LOM before any C-matrix exists, and it is labelled as such in every element value (estimate_source).

The one primitive. Two conductors on the boundary of a half-plane occupy the segments [x1, x2] and [x3, x4] (the rest of the boundary is a Neumann boundary, i.e. the slot / dielectric interface). Their capacitance per unit length in a half-space of permittivity ε is ε K(k)/K(k’), with the cross ratio k² = (x2 − x1)(x4 − x3) / ((x3 − x1)(x4 − x2)). Substrate + air give 2 ε0 ε_eff K(k)/K(k’). The standard results follow from it, and the unit tests check them against each other:

  • CPW (centre a, gaps b): C’ = 4 ε0 ε_eff K(k)/K(k’), k = a/(a + 2b) (Wen 1969; Simons, Coplanar Waveguide, ch. 2)

  • coplanar strips w1, w2 at spacing s, no ground: C’ = 2 ε0 ε_eff K(k)/K(k’), k² = w1 w2/((w1 + s)(w2 + s)) (equal widths: the textbook CPS K(k’)/K(k) with k = s/(s + 2w), by Landen’s transformation)

  • two equal strips w at spacing s inside a ground slot (ground at distance g beyond each strip), z → z² mapping: even mode k_e² = (b² − a²)/(c² − a²), odd mode k_o = (c/b)·√((b² − a²)/(c² − a²)) with a = s/2, b = a + w, c = b + g; C_ground = C_e, C_mutual = (C_o − C_e)/2 per unit length (edge-coupled CPW, Simons ch. 7)

  • interdigital capacitor (N fingers, width w, gap s, overlap L): Igreja & Dias, Sens. Actuators A 112, 291 (2004): C = (N − 3) C_I/2 + 2 C_I C_E/(C_I + C_E), C_I,E = ε0 (εr + 1) L K(k)/K(k’), k_I = sin(πη/2), k_E = 2√η/(1 + η), η = w/(w + s); within ~10 % of Alley’s (εr + 1) L [(N − 3) A1 + A2] (Bahl, Lumped elements)

Accuracy. Against Q3D: the Xmon island (cross arms as CPW) comes out 13 % high; the two-pad Metal TransmonPocket mutual capacitance about 25 % high, its pad-to-ground about 20 % high, and the connection-pad C_g within 20 % (Metal tutorial 4.01). Each estimate carries an uncertainty and a kind:

  • "calibration" — power law anchored on a FEM run of the same component (calibration)

  • "analytic" — a conformal-mapping formula applied to the component’s own geometry (±25 % typical)

  • "rough" — a geometry the formulas only approximate: screened couplers, curved or spiral electrodes, a calibration borrowed from another component (±50 %, or worse)

Values are rounded to 3 significant figures (analytic) or 2 (rough). Units: µm in, fF out. Inside exact_values() they are not rounded (the co-design surrogate takes the LOM’s sensitivities from small knob steps, which the rounding would hide).

Functions

cap(value, kind, formula[, fem]) → dict

Element value dict for a capacitance estimate: {"estimate", "unit", "fem", "estimate_source", ...}.

concentric_rings(r_in, r_mid_in, eps_r) → float

Disk of radius r_in and a ring starting at r_mid_in: their facing edge as coupled strips, rough.

coplanar_coupling(length, w1, w2, s, eps_r[, screening]) → float

Edge-to-edge coupling of two conductors facing each other over length across s (CPS formula).

coupled_strips_per_um(w, s, g, eps_r) → tuple[float, float]

Two equal strips (width w, spacing s) in a ground slot (gap g beyond each): (C to ground, C mutual), fF/µm.

cps_c_per_um(w1, w2, s, eps_r) → float

Mutual capacitance per µm of two coplanar strips (widths w1, w2, spacing s), no ground nearby.

cpw_c_per_um(a, b, eps_r) → float

CPW (centre width a, gaps b) capacitance per µm, fF/µm.

cpw_line(length, a, b, eps_r) → float

Shunt capacitance of a CPW stub of length (lumped: valid for length ≪ λ/4).

cross_island(arm_lengths, arm_width, gap, eps_r) → float

Cross (Xmon/Swissmon) island to ground: arms as CPW sections of centre arm_width and gap gap.

disk_to_ground(r, gap, eps_r) → float

Disk of radius r in a circular ground cut-out of radius r + gap: a CPW of centre 2r bent into a circle.

eps_eff(eps_r) → float

Quasi-static effective permittivity of a planar structure on a thick substrate: (εr + 1)/2.

exact_values()

Within this block cap() does not round (sensitivities of the estimates to small parameter changes).

interdigital(n_fingers, finger_w, finger_gap, overlap, ...) → float

Interdigital capacitor (Igreja & Dias 2004), N ≥ 2 fingers; for N = 2 the two-strip CPS value is used.

k_ratio(k) → float

K(k)/K(k') with k' = √(1 − k²) (complete elliptic integrals of the first kind).

pad_to_ground(w, h, gap_w, gap_h, eps_r[, open_edges]) → float

Rectangular pad w × h in a ground cut-out (clearance gap_w beyond the w-sides... i.e. along x, gap_h

ring_to_ground(r_out, width, gap, eps_r) → float

Outer edge of a ring (outer radius r_out, radial width w) facing ground across gap (half-CPW).

segments_c_per_um(x1, x2, x3, x4, eps_r) → float

C' (fF/µm) between boundary segments [x1, x2] and [x3, x4] (x4 may be inf), substrate + air.

substrate_eps(pdk) → float

εr of the PDK substrate (pdk is a PDK object, its name, or a number).

two_pads(pad_w, pad_h, pad_gap, side_gap, back_gap, eps_r) → tuple[float, float]

Two equal pads (w × h) facing each other across pad_gap along their long sides, in a pocket.

Module Contents

quantcore_circuits.lom.estimates.cap(value: float | None, kind: str, formula: str, fem: bool = True) → dict

Element value dict for a capacitance estimate: {"estimate", "unit", "fem", "estimate_source", ...}.

quantcore_circuits.lom.estimates.concentric_rings(r_in: float, r_mid_in: float, eps_r: float) → float

Disk of radius r_in and a ring starting at r_mid_in: their facing edge as coupled strips, rough.

Uses the CPS formula along the mean circumference with strip widths = the radial extents (capped).

quantcore_circuits.lom.estimates.coplanar_coupling(length: float, w1: float, w2: float, s: float, eps_r: float, screening: float = 1.0) → float

Edge-to-edge coupling of two conductors facing each other over length across s (CPS formula).

screening < 1 for a ground strip or ground-plane edges close to the gap (rough).

quantcore_circuits.lom.estimates.coupled_strips_per_um(w: float, s: float, g: float, eps_r: float) → tuple[float, float]

Two equal strips (width w, spacing s) in a ground slot (gap g beyond each): (C to ground, C mutual), fF/µm.

quantcore_circuits.lom.estimates.cps_c_per_um(w1: float, w2: float, s: float, eps_r: float) → float

Mutual capacitance per µm of two coplanar strips (widths w1, w2, spacing s), no ground nearby.

quantcore_circuits.lom.estimates.cpw_c_per_um(a: float, b: float, eps_r: float) → float

CPW (centre width a, gaps b) capacitance per µm, fF/µm.

quantcore_circuits.lom.estimates.cpw_line(length: float, a: float, b: float, eps_r: float) → float

Shunt capacitance of a CPW stub of length (lumped: valid for length ≪ λ/4).

quantcore_circuits.lom.estimates.cross_island(arm_lengths: list[float], arm_width: float, gap: float, eps_r: float) → float

Cross (Xmon/Swissmon) island to ground: arms as CPW sections of centre arm_width and gap gap.

arm_lengths are centre-to-tip lengths; the centre square is counted once. The end caps are not counted (they roughly compensate the overestimate of treating the arm junctions as straight CPW).

quantcore_circuits.lom.estimates.disk_to_ground(r: float, gap: float, eps_r: float) → float

Disk of radius r in a circular ground cut-out of radius r + gap: a CPW of centre 2r bent into a circle.

quantcore_circuits.lom.estimates.eps_eff(eps_r: float) → float

Quasi-static effective permittivity of a planar structure on a thick substrate: (εr + 1)/2.

quantcore_circuits.lom.estimates.exact_values()

Within this block cap() does not round (sensitivities of the estimates to small parameter changes).

quantcore_circuits.lom.estimates.interdigital(n_fingers: int, finger_w: float, finger_gap: float, overlap: float, eps_r: float) → float

Interdigital capacitor (Igreja & Dias 2004), N ≥ 2 fingers; for N = 2 the two-strip CPS value is used.

quantcore_circuits.lom.estimates.k_ratio(k: float) → float

K(k)/K(k’) with k’ = √(1 − k²) (complete elliptic integrals of the first kind).

quantcore_circuits.lom.estimates.pad_to_ground(w: float, h: float, gap_w: float, gap_h: float, eps_r: float, open_edges: int = 0) → float

Rectangular pad w × h in a ground cut-out (clearance gap_w beyond the w-sides… i.e. along x, gap_h along y). Sum of the two CPW cross-sections: w·C’_cpw(h, gap_h) + h·C’_cpw(w, gap_w).

open_edges (0–2) removes that many long (length w) edges’ share, for edges facing another conductor instead of ground (half of the first term each).

quantcore_circuits.lom.estimates.ring_to_ground(r_out: float, width: float, gap: float, eps_r: float) → float

Outer edge of a ring (outer radius r_out, radial width w) facing ground across gap (half-CPW).

quantcore_circuits.lom.estimates.segments_c_per_um(x1: float, x2: float, x3: float, x4: float, eps_r: float) → float

C’ (fF/µm) between boundary segments [x1, x2] and [x3, x4] (x4 may be inf), substrate + air.

quantcore_circuits.lom.estimates.substrate_eps(pdk) → float

εr of the PDK substrate (pdk is a PDK object, its name, or a number).

quantcore_circuits.lom.estimates.two_pads(pad_w: float, pad_h: float, pad_gap: float, side_gap: float, back_gap: float, eps_r: float) → tuple[float, float]

Two equal pads (w × h) facing each other across pad_gap along their long sides, in a pocket.

back_gap is the clearance from each pad’s far long edge to the ground, side_gap from its short edges. Returns (C pad → ground, C pad ↔ pad), fF. Long edges: edge-coupled strips in a ground slot; short edges: the CPW cross-section along y.