quantcore_circuits.lom.metal_models

LOM models for Quantum Metal components placed through the "metal:<Class>" wrapper (quantcore_circuits. layouts.metal): instance params are Metal options, ports are Metal pin names, junction ends squid_a/_b.

Metal class

lumped model (local nodes → FEM labels <inst>.<node>)

TransmonPocket, …CL, …6, …Teeth

floating: island1 = pad_top, island2 = pad_bot, JJ between; per connection pad a coupler node (C_g to its pad, a small C to the far pad, C to ground); CL: Charge_Line drive port

TransmonCross, TransmonCrossFL,

grounded cross / star: island + JJ (FL: SQUID + flux_line control);

TransmonStar

per claw a coupler node

TransmonConcentric, …Type2

floating: island1 = outer ring, island2 = inner disk, SQUID (two JJs) between; readout coupler node; flux-bias pins → control

TransmonInterdigitated

floating: island1 = top pad, island2 = bottom pad; readout (bottom), bus1/bus2 (top)

StarQubit

grounded centre island + JJ; 4 coupler pads + readout pad

TunableCoupler01

grounded coupler island + SQUID; Control claw node; Flux control

TunableCoupler02

floating pads + SQUID; bus line (pin1–pin2) coupled to both; fbl

CapNInterdigital, Cap3Interdigital,

π network between the two pins

CapFingerInFrame

CapNInterdigitalTee

primary line (prime_start = prime_end) + IDC to second_end

CoupledLineTee

primary line + a coupled line (component line with a HANGER section to the primary): continued by the route on second_end it becomes the resonator (λ/4 for a shorted coupler end, λ/2 for an open one)

LineTee

one conductor (T-junction)

ResonatorCoilRect, ReadoutResFC,

a resonator line from the pin (the coil / the meander)

ResonatorLumped

LaunchpadWirebond(+Driven)

50 Ω port on tie (Driven: in is the pad itself)

LaunchpadWirebondCoupled

50 Ω pad + coupling C to tie

OpenToGround / ShortToGround

zero-length line ending open / shorted: a route into it is a λ/2 / λ/4

Airbridge

wire

PolylineCPW

a line (wire, or a stub resonator with a free end)

SNAIL

JJ between a and b (linearised SNAIL inductance)

jj_dolan, jj_manhattan, SQUID_LOOP,

no pins: a junction drawn into other metal; no circuit element (declare

BridgeFreeJunction

it as part of the qubit)

NSquareSpiral

(sample shape) a spiral trace from spiralPin to an open inner end (line)

Metal-only cells (METAL_ONLY: TransmonConcentricType2, TunableCoupler02, ResonatorLumped, NSquareSpiral) draw no pocket: the models above hold on a pocket (a subtracting Metal shape such as metal:Rectangle subtract: true covering the cell’s origin); without one the builder grounds their ports and adds no elements (a note says so).

Estimates: TransmonPocket is the coupled-pad analytic model anchored on the Metal tutorial Q3D matrix of the default pocket (docs/tut/4-Analysis/Q1_TwoTransmon_CapMatrix.txt); cross / star islands on the Xmon Q3D (CPW-arm model); claws through a ground strip with the Xmon claw’s screening. The rest is analytic or rough (see estimates). Junction Lj comes from the design’s junction (else Metal’s hfss_inductance option).

Attributes

Classes

MetalOptions

A Metal component's options (defaults + the instance's), with µm / number accessors.

Functions

airbridge_lom(name, inst, pdk)

Metal Airbridge: a wire between its two landing pads; with no port joined, a ground strap (ports → gnd).

cap3_interdigital_lom(name, inst, pdk)

Metal Cap3Interdigital: three-finger IDC (finger width = gap = trace width) between a and b.

cap_finger_in_frame_lom(name, inst, pdk)

Metal CapFingerInFrame: a finger (pin finger) inside a U frame (pin frame): C along both sides.

cap_n_interdigital_lom(name, inst, pdk)

Metal CapNInterdigital: N-finger IDC between north_end and south_end.

cap_n_interdigital_tee_lom(name, inst, pdk)

Metal CapNInterdigitalTee: primary CPW (prime_start = prime_end, one conductor) + IDC to second_end.

coupled_line_tee_lom(name, inst, pdk)

Metal CoupledLineTee: primary CPW + a parallel coupled line (coupling_length at coupling_space) whose

launchpad_coupled_lom(name, inst, pdk)

Metal LaunchpadWirebondCoupled: a 50 Ω pad coupled to the tie line through a coupler section (rough C).

launchpad_driven_lom(name, inst, pdk)

Metal LaunchpadWirebondDriven: a 50 Ω port; in (the driven pad) and tie are one conductor.

launchpad_lom(name, inst, pdk)

Metal LaunchpadWirebond: a 50 Ω port on its tie conductor.

line_tee_lom(name, inst, pdk)

Metal LineTee: a T-junction, all three pins one conductor.

metal_mro(cls_name) → list[str]

Metal class names of cls_name and its bases (for subclasses of qlibrary components).

metal_only_without_pocket(design, plan, iname) → str | None

A note when iname is a metal-only Metal cell that no subtracting Metal shape (a pocket) covers: its metal

n_square_spiral_lom(name, inst, pdk)

Metal NSquareSpiral (sample shape) on a pocket: a spiral trace from spiralPin (outer end) to an open inner

open_to_ground_lom(name, inst, pdk)

Metal OpenToGround: an open end; a route into it becomes an open-ended (λ/2 or λ/4) resonator.

polyline_cpw_lom(name, inst, pdk)

Metal PolylineCPW: a CPW line along points (wire between connected pins, stub resonator otherwise).

readout_res_fc_lom(name, inst, pdk)

Metal ReadoutResFC: a CPW resonator from the fork/circle coupler (open) through l1 … 5 × l5 to readout.

resonator_coil_lom(name, inst, pdk)

Metal ResonatorCoilRect: a rectangular-spiral resonator of length (line_width/gap) from

resonator_lumped_lom(name, inst, pdk)

Metal ResonatorLumped: a meandered trace shorted to the (grounded) perimeter, open at pin_n: λ/4.

short_to_ground_lom(name, inst, pdk)

Metal ShortToGround: a shorted end; a route into it becomes a shorted (λ/4) resonator end.

snail_lom(name, inst, pdk)

Metal SNAIL: a JJ between pins a and b with the SNAIL's linear inductance (3 Lj in series ∥ Lj_small) unless

star_qubit_lom(name, inst, pdk)

Metal StarQubit: grounded star-shaped centre island + JJ, four coupler pads and a readout pad around it.

transmon_concentric2_lom(name, inst, pdk)

Metal TransmonConcentricType2: floating disk (rad_inner) + ring (… rad_outer), SQUID between; pins pin1–3

transmon_concentric_lom(name, inst, pdk)

Metal TransmonConcentric: floating disk (rad_i) + ring (rad_i + gap … rad_o), two JJs = SQUID between;

transmon_cross_fl_lom(name, inst, pdk)

Metal TransmonCrossFL: TransmonCross with a flux line (flux_line control, junction as SQUID).

transmon_cross_lom(name, inst, pdk)

Metal TransmonCross (Xmon-type): grounded cross, JJ on the south arm, claw connection pads.

transmon_interdigitated_lom(name, inst, pdk)

Metal TransmonInterdigitated: floating pads (top = island1, bottom = island2) with 4 fingers each.

transmon_pocket6_lom(name, inst, pdk)

Metal TransmonPocket6: TransmonPocket with up to six connection pads (loc_H picks the pad).

transmon_pocket_cl_lom(name, inst, pdk)

Metal TransmonPocketCL: TransmonPocket + charge line (Charge_Line → drive control).

transmon_pocket_lom(name, inst, pdk)

Metal TransmonPocket: floating two-pad transmon with connection pads (see module table).

transmon_pocket_teeth_lom(name, inst, pdk)

Metal TransmonPocketTeeth: TransmonPocket with tooth-shaped connection pads (estimated as rectangles).

transmon_star_lom(name, inst, pdk)

Metal TransmonStar: grounded star (N arms as CPW sections), JJ on one arm, claw connection pads.

tunable_coupler01_lom(name, inst, pdk)

Metal TunableCoupler01: grounded coupler island (interdigitated C to ground) + SQUID to ground; Control is

tunable_coupler02_lom(name, inst, pdk)

Metal TunableCoupler02: two circular pads (floating) + SQUID; a bus CPW (pin1–pin2) passes both pads.

Module Contents

class quantcore_circuits.lom.metal_models.MetalOptions(cls_name: str, params: dict)

A Metal component’s options (defaults + the instance’s), with µm / number accessors.

num(key: str, default: float = 0.0, src: dict | None = None) → float
um(key: str, default: float = 0.0, src: dict | None = None) → float
cls
pads
raw
quantcore_circuits.lom.metal_models.airbridge_lom(name, inst, pdk)

Metal Airbridge: a wire between its two landing pads; with no port joined, a ground strap (ports → gnd).

quantcore_circuits.lom.metal_models.cap3_interdigital_lom(name, inst, pdk)

Metal Cap3Interdigital: three-finger IDC (finger width = gap = trace width) between a and b.

quantcore_circuits.lom.metal_models.cap_finger_in_frame_lom(name, inst, pdk)

Metal CapFingerInFrame: a finger (pin finger) inside a U frame (pin frame): C along both sides.

quantcore_circuits.lom.metal_models.cap_n_interdigital_lom(name, inst, pdk)

Metal CapNInterdigital: N-finger IDC between north_end and south_end.

quantcore_circuits.lom.metal_models.cap_n_interdigital_tee_lom(name, inst, pdk)

Metal CapNInterdigitalTee: primary CPW (prime_start = prime_end, one conductor) + IDC to second_end.

quantcore_circuits.lom.metal_models.coupled_line_tee_lom(name, inst, pdk)

Metal CoupledLineTee: primary CPW + a parallel coupled line (coupling_length at coupling_space) whose coupler end is open (open_termination) or shorted; the route on second_end continues it as a resonator.

quantcore_circuits.lom.metal_models.launchpad_coupled_lom(name, inst, pdk)

Metal LaunchpadWirebondCoupled: a 50 Ω pad coupled to the tie line through a coupler section (rough C).

quantcore_circuits.lom.metal_models.launchpad_driven_lom(name, inst, pdk)

Metal LaunchpadWirebondDriven: a 50 Ω port; in (the driven pad) and tie are one conductor.

quantcore_circuits.lom.metal_models.launchpad_lom(name, inst, pdk)

Metal LaunchpadWirebond: a 50 Ω port on its tie conductor.

quantcore_circuits.lom.metal_models.line_tee_lom(name, inst, pdk)

Metal LineTee: a T-junction, all three pins one conductor.

quantcore_circuits.lom.metal_models.metal_mro(cls_name: str) → list[str]

Metal class names of cls_name and its bases (for subclasses of qlibrary components).

quantcore_circuits.lom.metal_models.metal_only_without_pocket(design, plan, iname: str) → str | None

A note when iname is a metal-only Metal cell that no subtracting Metal shape (a pocket) covers: its metal is part of the ground plane, so it has no circuit elements; else None.

quantcore_circuits.lom.metal_models.n_square_spiral_lom(name, inst, pdk)

Metal NSquareSpiral (sample shape) on a pocket: a spiral trace from spiralPin (outer end) to an open inner end, as a line (a route into it ends in a stub of the spiral’s length). Rough: the CPW formula with a = width, b = gap ignores the turns’ mutual coupling. Without a pocket the builder grounds the pin (see METAL_ONLY).

quantcore_circuits.lom.metal_models.open_to_ground_lom(name, inst, pdk)

Metal OpenToGround: an open end; a route into it becomes an open-ended (λ/2 or λ/4) resonator.

quantcore_circuits.lom.metal_models.polyline_cpw_lom(name, inst, pdk)

Metal PolylineCPW: a CPW line along points (wire between connected pins, stub resonator otherwise).

quantcore_circuits.lom.metal_models.readout_res_fc_lom(name, inst, pdk)

Metal ReadoutResFC: a CPW resonator from the fork/circle coupler (open) through l1 … 5 × l5 to readout.

quantcore_circuits.lom.metal_models.resonator_coil_lom(name, inst, pdk)

Metal ResonatorCoilRect: a rectangular-spiral resonator of length (line_width/gap) from spiralPin; its inner end is open.

quantcore_circuits.lom.metal_models.resonator_lumped_lom(name, inst, pdk)

Metal ResonatorLumped: a meandered trace shorted to the (grounded) perimeter, open at pin_n: λ/4.

quantcore_circuits.lom.metal_models.short_to_ground_lom(name, inst, pdk)

Metal ShortToGround: a shorted end; a route into it becomes a shorted (λ/4) resonator end.

quantcore_circuits.lom.metal_models.snail_lom(name, inst, pdk)

Metal SNAIL: a JJ between pins a and b with the SNAIL’s linear inductance (3 Lj in series ∥ Lj_small) unless the design gives junction.Lj_nH (the SNAIL’s third-order nonlinearity is not modelled).

quantcore_circuits.lom.metal_models.star_qubit_lom(name, inst, pdk)

Metal StarQubit: grounded star-shaped centre island + JJ, four coupler pads and a readout pad around it.

quantcore_circuits.lom.metal_models.transmon_concentric2_lom(name, inst, pdk)

Metal TransmonConcentricType2: floating disk (rad_inner) + ring (… rad_outer), SQUID between; pins pin1–3 are coupler fingers on the ring (rough).

quantcore_circuits.lom.metal_models.transmon_concentric_lom(name, inst, pdk)

Metal TransmonConcentric: floating disk (rad_i) + ring (rad_i + gap … rad_o), two JJs = SQUID between; pin1 readout line over the ring (coupler node), pin2/pin3 the flux-bias loop (controls).

quantcore_circuits.lom.metal_models.transmon_cross_fl_lom(name, inst, pdk)

Metal TransmonCrossFL: TransmonCross with a flux line (flux_line control, junction as SQUID).

quantcore_circuits.lom.metal_models.transmon_cross_lom(name, inst, pdk)

Metal TransmonCross (Xmon-type): grounded cross, JJ on the south arm, claw connection pads.

quantcore_circuits.lom.metal_models.transmon_interdigitated_lom(name, inst, pdk)

Metal TransmonInterdigitated: floating pads (top = island1, bottom = island2) with 4 fingers each.

quantcore_circuits.lom.metal_models.transmon_pocket6_lom(name, inst, pdk)

Metal TransmonPocket6: TransmonPocket with up to six connection pads (loc_H picks the pad).

quantcore_circuits.lom.metal_models.transmon_pocket_cl_lom(name, inst, pdk)

Metal TransmonPocketCL: TransmonPocket + charge line (Charge_Line → drive control).

quantcore_circuits.lom.metal_models.transmon_pocket_lom(name, inst, pdk)

Metal TransmonPocket: floating two-pad transmon with connection pads (see module table).

quantcore_circuits.lom.metal_models.transmon_pocket_teeth_lom(name, inst, pdk)

Metal TransmonPocketTeeth: TransmonPocket with tooth-shaped connection pads (estimated as rectangles).

quantcore_circuits.lom.metal_models.transmon_star_lom(name, inst, pdk)

Metal TransmonStar: grounded star (N arms as CPW sections), JJ on one arm, claw connection pads.

quantcore_circuits.lom.metal_models.tunable_coupler01_lom(name, inst, pdk)

Metal TunableCoupler01: grounded coupler island (interdigitated C to ground) + SQUID to ground; Control is the coupler claw (circuit node), Flux the flux line.

quantcore_circuits.lom.metal_models.tunable_coupler02_lom(name, inst, pdk)

Metal TunableCoupler02: two circular pads (floating) + SQUID; a bus CPW (pin1–pin2) passes both pads.

quantcore_circuits.lom.metal_models.METAL_ONLY
quantcore_circuits.lom.metal_models.POCKET_Q3D
quantcore_circuits.lom.metal_models.POCKET_REF = 'Metal tutorial Q3D, TransmonPocket defaults (Q1_TwoTransmon_CapMatrix)'