metal:TunableCoupler02

TunableCoupler02.png

Source: Metal (Qiskit Metal). Category: coupler. Module: qiskit_metal.qlibrary.couplers.tunable_coupler_02.

See also the catalog.

Pins

Pins of metal:TunableCoupler02

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:

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.