quantcore_circuits.lom.calibration ================================== .. py:module:: quantcore_circuits.lom.calibration .. autoapi-nested-parse:: Component LOM calibration: knob → element value, per component and PDK (no FEM needed to get a first LOM). Each entry is a power law ``v = v0 (k/k0)^p`` anchored at a reference simulation of the component geometry, the same form the co-design surrogate refines (:mod:`quantcore_circuits.codesign`). Values are fF. The reference geometry is the example Xmon (arm width 25 µm, gap 25 µm, claw finger 25 µm, claw gap 6 µm); away from it the estimate is first-order and is replaced as soon as a C-matrix of the actual design exists. ``hanger_k`` is the voltage coupling coefficient k = (Z0e − Z0o)/(Z0e + Z0o) of the parallel-coupled section of a hanger coupler, per ground-strip width (µm), used for the external Q of a λ/4 hanger: Q_ext = π / (2 k² sin²(β l_c)) (Besedin & Menushenkov 2018). Calibrate it from a driven/eigenmode simulation. Attributes ---------- .. autoapisummary:: quantcore_circuits.lom.calibration.CALIBRATION quantcore_circuits.lom.calibration.HANGER_K quantcore_circuits.lom.calibration.HANGER_K_REF Functions --------- .. autoapisummary:: quantcore_circuits.lom.calibration.estimate quantcore_circuits.lom.calibration.hanger_k quantcore_circuits.lom.calibration.hanger_kappa_MHz quantcore_circuits.lom.calibration.invert Module Contents --------------- .. py:function:: estimate(cell: str, quantity: str, params: dict, pdk_name: str) -> tuple[float | None, str] (value fF, provenance) of ``quantity`` for a cell with ``params``; (None, reason) if uncalibrated. .. py:function:: hanger_k(ground_gap_um: float) -> float Coupling coefficient for a hanger with the given ground strip (nearest calibrated width, e^-gap scaling). .. py:function:: hanger_kappa_MHz(f_GHz: float, vp_m_s: float, coupling_length_um: float, ground_gap_um: float) -> float External linewidth κ/2π of a λ/4 hanger coupled over ``coupling_length_um`` near its shorted end. .. py:function:: invert(cell: str, quantity: str, value: float, pdk_name: str) -> float | None Knob value that gives ``value`` (fF) for ``quantity`` (LOM → layout). .. py:data:: CALIBRATION :type: dict[tuple[str, str], dict] .. py:data:: HANGER_K .. py:data:: HANGER_K_REF :value: 'HFSS driven S21 notch fit, q1_r1_feedline R1, AEDT 2024 R1 (2026-11-03); was 0.06 (estimate)'