% generated by scripts/make_component_docs.py -- do not edit. Put hand-written notes in docs/components/notes/metal_TunableCoupler02.md (included below). # metal:TunableCoupler02 TunableCoupler02.png **Source:** Metal (Qiskit Metal). **Category:** coupler. **Module:** `qiskit_metal.qlibrary.couplers.tunable_coupler_02`. See also the [catalog](../CATALOG.md). ## Pins ![Pins of metal:TunableCoupler02](../../images/components/metal_TunableCoupler02.png) Pin image (default parameters). Light = metal, dark = etched gap, colours = junction layers. A red dot and arrow is a pin and its direction (out of the cell); the red bar is the CPW width a + 2 b. Blue dot = a pin without direction. Units: µm. | pin | x (µm) | y (µm) | direction (°) | a (µm) | b (µm) | purpose | |---|---|---|---|---|---|---| | `fbl` | -450 | 1000 | 90 | 10 | 6 | control line (flux) in the LOM | | `pin1` | 1900 | 50 | 0 | 10 | 6 | LOM node `bus` | | `pin2` | -1900 | 50 | 180 | 10 | 6 | LOM node `bus` | | `squid_a` | -200 | 450 | none | 10 | 6 | junction pins (the LOM's L_J); LOM node `island1` | | `squid_b` | 200 | 450 | none | 10 | 6 | junction pins (the LOM's L_J); LOM node `island2` | Pins with direction `none`: `squid_a`, `squid_b`. They mark a point (a junction lead, a pad centre), not a CPW end. The KLayout ghost draws them as boxes. A route can start there only where the notes say so; it cannot be snapped to. a, b: CPW centre width and gap where the pin declares them (`–` = not declared). Position and direction are in the cell's own frame (`at=(0, 0)`, `rot=0`). **Notes from the catalog:** draws metal only, no pocket (Metal computes its pocket but never adds it): alone it is empty in the negative mask, as in Metal's own GDS (metal on the ground plane). Place it on a pocket, e.g. metal:Rectangle with subtract: true; its metal goes to base_metal_addition, which the fab export removes from the etch. Metal's defaults are mm-scale. ## Parameters | name | default | unit | description | |---|---|---|---| | `a` | `10` | μm | Width of center conductor | | `b` | `6` | μm | Width of gap | | `r` | `100` | μm | Turn radius | | `junction_type` | `"Metal"` | – | Junction as fabricated: Metal footprint, or a trilayer cell placed on each junction line | | `junction_params` | `"{}"` | – | Trilayer junction cell parameters (JSON dict, e.g. lj_nH) | | `metal_class` | `"TunableCoupler02"` | – | Quantum Metal component | | `options` | `"{}"` | – | Metal options as JSON (bare numbers on length options are µm) | | `open_pins` | `""` | – | Pins left open (comma-separated): keep Metal's etch beyond them, as drawn with no route attached | Electrically relevant parameters (sizes, gaps, junction, ports) come first, the rest follows. ## LOM model The cell contributes to the lumped model: | branch | type | nodes | value (estimate at defaults) | |---|---|---|---| | `C_X_1` | C | island1 – gnd | estimate=110, unit=fF, estimate_source=rough: pad as a disk in the pocket, estimate_kind=rough, uncertainty=±50% | | `Cb_X_1` | C | island1 – bus | estimate=42, unit=fF, estimate_source=rough: bus line past the pad (CPS), estimate_kind=rough, uncertainty=±50% | | `C_X_2` | C | island2 – gnd | estimate=110, unit=fF, estimate_source=rough: pad as a disk in the pocket, estimate_kind=rough, uncertainty=±50% | | `Cb_X_2` | C | island2 – bus | estimate=42, unit=fF, estimate_source=rough: bus line past the pad (CPS), estimate_kind=rough, uncertainty=±50% | | `C_X_12` | C | island1 – island2 | estimate=43, unit=fF, estimate_source=rough: pads across the junction gap (CPS), estimate_kind=rough, uncertainty=±50% | | `Cc_X_bus` | C | bus – gnd | estimate=160, unit=fF, estimate_source=rough: bus, estimate_kind=rough, uncertainty=±50% | | `J_X` | SQUID | island1 – island2 | Lj_nH=10, Cj_fF=0, asym=0, flux_phi0=0 | Nodes: `island1`, `island2`, `bus`. ## Simulation export notes - C5b: metal-only Metal cell placed without its pocket (status: context; fix in — (design side)) ## How to use In Python: ```python from quantcore_circuits.designer import Designer d = Designer("demo", box=(0, 0, 7500, 7500)) d.add("U1", "metal:TunableCoupler02", at=(3750, 3750), a=10) # parameters: see the table above d.add("PAD", "BondPad", at=(1125, 3750), rot=270) # a launcher to connect to d.route("L1", "PAD.a", "U1.fbl") # a CPW from the pad to the pin ``` Pin names go into `d.route(...)` as `INSTANCE.pin`, and into `snap=` / `to=` when placing. From the shell: `qcc components metal:TunableCoupler02` lists the pins; add `--schema` for the parameters. In KLayout: Quantcore panel ▸ Components ▸ double-click the cell, then click on the layout to place it. Rotate and mirror before the click; use Connect on two pins to route.