quantcore_circuits.lom.estimates ================================ .. py:module:: quantcore_circuits.lom.estimates .. autoapi-nested-parse:: 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 (:mod:`.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 :func:`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 --------- .. autoapisummary:: quantcore_circuits.lom.estimates.cap quantcore_circuits.lom.estimates.concentric_rings quantcore_circuits.lom.estimates.coplanar_coupling quantcore_circuits.lom.estimates.coupled_strips_per_um quantcore_circuits.lom.estimates.cps_c_per_um quantcore_circuits.lom.estimates.cpw_c_per_um quantcore_circuits.lom.estimates.cpw_line quantcore_circuits.lom.estimates.cross_island quantcore_circuits.lom.estimates.disk_to_ground quantcore_circuits.lom.estimates.eps_eff quantcore_circuits.lom.estimates.exact_values quantcore_circuits.lom.estimates.interdigital quantcore_circuits.lom.estimates.k_ratio quantcore_circuits.lom.estimates.pad_to_ground quantcore_circuits.lom.estimates.ring_to_ground quantcore_circuits.lom.estimates.segments_c_per_um quantcore_circuits.lom.estimates.substrate_eps quantcore_circuits.lom.estimates.two_pads Module Contents --------------- .. py:function:: cap(value: float | None, kind: str, formula: str, fem: bool = True) -> dict Element value dict for a capacitance estimate: ``{"estimate", "unit", "fem", "estimate_source", ...}``. .. py:function:: 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). .. py:function:: 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). .. py:function:: 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. .. py:function:: 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. .. py:function:: cpw_c_per_um(a: float, b: float, eps_r: float) -> float CPW (centre width a, gaps b) capacitance per µm, fF/µm. .. py:function:: 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). .. py:function:: 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). .. py:function:: 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. .. py:function:: eps_eff(eps_r: float) -> float Quasi-static effective permittivity of a planar structure on a thick substrate: (εr + 1)/2. .. py:function:: exact_values() Within this block :func:`cap` does not round (sensitivities of the estimates to small parameter changes). .. py:function:: 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. .. py:function:: k_ratio(k: float) -> float K(k)/K(k') with k' = √(1 − k²) (complete elliptic integrals of the first kind). .. py:function:: 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). .. py:function:: 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). .. py:function:: 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. .. py:function:: substrate_eps(pdk) -> float εr of the PDK substrate (``pdk`` is a PDK object, its name, or a number). .. py:function:: 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.