Component examples (Metal A–E)

A catalogue board rather than a chip. The 19 single-component and sub-circuit notebooks of the Qiskit Metal “circuit examples” (qubits, resonators, composites, couplers, input-output coupling; Apache-2.0, © IBM and contributors) are gathered on one 35 × 28 mm board, one 7 × 7 mm tile each. The Quantcore rebuild is distributed under GPL-3.0.

Build this one to see every metal: component drawn through the wrapper in one place, with Quantcore junctions. The board is a test bed for the component wrappers and their LOM models and is not meant for fabrication.

The whole component-examples board as the v2 notebook builds it

At a glance

Notebook

examples/designs/metal/component_examples.ipynb (an older one-cell version is kept as component_examples.v1.ipynb)

Source

Qiskit Metal circuit examples A.Qubits, B.Resonators, C.Composite-bi-partite, D.Qubit-couplers, E.Input-output-coupling, © IBM and contributors, Apache-2.0

Chip

35 × 28 mm board of 7 × 7 mm tiles (larger than the 7.5 mm Quantcore die)

On the chip

19 example tiles: qubits (A), one resonator (B), one qubit with a resonator (C), three coupler examples (D), launchpad and charge-line examples (E)

Builds today

yes (layout built on 2026-11-19 in 14 s)

How the notebook builds it

The layout segments of component_examples, one picture each
  1. Board. An empty board with the QCT frame and the 5 × 4 tile grid.

  2. Bond pads. None placed: the pad rule is not applied to this board (its two launchpads stay in their tiles).

  3. Qubits (A). The qubit examples, each with a Quantcore junction.

  4. Resonator (B). One λ/2 meander between two open ends.

  5. Composite (C). A pocket transmon with its 5 mm meander.

  6. Couplers (D). Two crossmons with a tunable coupler, and two pockets joined by a short line and by a bus.

  7. Input-output (E). A coupled launchpad, a launchpad driving an open meander, and a pocket with a charge line.

  8. Whole board. Sim groups for the FEM jobs, the content centred in the die, the design saved.

Each picture in the strip zooms on the tiles of that group.

LOM estimates

Numbers are from a run of this notebook on 2026-11-19 (Setup, Design, Check and the LOM cells, 18 s): QuCat normal modes with QuTiP dressed values.

group

qubit

f_q (GHz)

α (MHz)

resonator

f_r (GHz)

κ (MHz)

χ (MHz)

A01

A01_Q1

5.818

-201

–

–

–

–

A02

A02_Q1

7.087

-310

–

–

–

–

A03

A03_qubit1

5.48

-177

–

–

–

–

A04

A04_qubit1

4.065

-87.9

–

–

–

–

A05

A05_Q1

5.818

-201

–

–

–

–

A06

A06_Q1

7.094

-310

–

–

–

–

A07

A07_Q1

7.087

-310

–

–

–

–

A10

A10_Q1

7.759

-379

–

–

–

–

A11

A11_Star

5.174

-156

–

–

–

–

B11

–

–

–

B11_meanderTest

7.002

0

–

C21

C21_Q1

7.349

-334

C21_coupler

11.73

0

-2.52

D32

D32_Q1

7.353

-286

–

–

–

–

D33

D33_Q1

7.342

-322

D33_coupler

11.02

0

-2.79

E42

–

–

–

E42_bus

6.235

2.01

–

E43

E43_Q1

7.087

-310

–

–

–

–

D31_Q1

D31_Q1

5.788

-199

–

–

–

–

D31_Q2

D31_Q2

5.788

-199

–

–

–

–

D31_Tune_C_Q12

D31_Tune_C_Q12

8.568

-474

–

–

–

–

group

pair

ZZ (kHz)

neighbours

hybridised

D32

D32_Q1-D32_Q2

–

yes

yes

D33

D33_Q1-D33_Q2

–

yes

yes

LOM plot of component_examples

These are lumped-model estimates from component formulas and calibration, not FEM results. The LOM page says how far to trust them.

Build spec

The rest of this page is the detailed spec the notebook was built from: every component, port, route and length.

The metal: references in this spec build as written, through the metal: wrapper (ports are the Metal pin names, parameters the Metal options). The Quantcore and KQC substitutions are optional.

The notebook examples/designs/metal/component_examples.ipynb builds all 19 A–E notebooks, run headless, one 7 × 7 mm tile each.

Source: Quantum Metal docs/circuit-examples/{A.Qubits, B.Resonators, C.Composite-bi-partite, D.Qubit-couplers, E.Input-output-coupling} plus analysis sub-circuits from docs/tut/**. Licence Apache-2.0. None of these is a whole chip (no launchpads plus readout plus control). They are useful as component tests for the metal:<Class> wrappers and for the LOM models. Coordinates are Metal (centred); the chip size is given where the notebook sets it.

circuit-examples, A–E

notebook

what it draws

catalog refs (buildable stand-in)

A.Qubits/01-Transmon_cross

one TransmonCross

metal:TransmonCross (Xmon; Metal cross_length = arm, so Xmon cross_length = 2×)

A.Qubits/02-Transmon_floating

one TransmonPocket

metal:TransmonPocket (KQC DoublePads)

A.Qubits/03-concentric_transmon

one TransmonConcentric

metal:TransmonConcentric (KQC ConcentricTransmon)

A.Qubits/04-Interdigitated_Transmon

TransmonInterdigitated

metal:TransmonInterdigitated (no direct KQC match)

A.Qubits/05-Transmon_cross_fl

TransmonCrossFL

metal:TransmonCrossFL (Xmon(flux_port=True))

A.Qubits/06-Transmon_floating_6

TransmonPocket6

metal:TransmonPocket6 (none with 6 couplers)

A.Qubits/07-Transmon_floating_cl

TransmonPocketCL

metal:TransmonPocketCL (Xmon plus a free-end charge line; KQC Swissmon has a drive port)

A.Qubits/08-JJ-Dolan, 09-JJ-Manhattan

junction cells

metal:jj_dolan, metal:jj_manhattan (KQC Manhattan, ManhattanSingleJunction; Quantcore TrilayerJunction)

A.Qubits/10-Transmon_floating_teeth

TransmonPocketTeeth

metal:TransmonPocketTeeth

A.Qubits/11-Star_shaped_qubit

StarQubit

metal:StarQubit (used by 53/54)

B.Resonators/11-Resonator_Meander

RouteMeander to OpenToGround

meander route plus free_end(term>0)

C.Composite-bi-partite/21-OneTransmonsWithMeanderAndOTG

TransmonPocket + 5 mm meander to an open end (chip 4 × 6 mm)

pocket stand-in plus meander plus free_end

D.Qubit-couplers/31-TwoCrossmonsTunableCoupler

2 TransmonCrossFL ± 0.3 mm + TunableCoupler01 (chip 3 × 3 mm)

sub-circuit of A4_full_chip / iswap3_xmon_tc

D.Qubit-couplers/32-TwoTransmonsDirectCoupling

2 TransmonPocket 1 mm apart + RouteStraight between readout pads (chip 2 × 2 mm)

two Xmons plus a straight cpw

D.Qubit-couplers/33-TwoTransmonsWithMeander

2 TransmonPocket 2 mm apart + 5 mm meander bus (chip 4 × 6 mm)

two Xmons plus a meander bus

E.Input-output-coupling/41-LaunchPad

LaunchpadWirebondCoupled

BondPad + FingerCapacitorSquare

E.Input-output-coupling/42-ResonatorAndLaunchPad

coupled pad → 10 mm meander → open end

BondPad + cap + meander + free end

E.Input-output-coupling/43-TransmonPocketCL

TransmonPocketCL

as A.07

Tutorial sub-circuits (not whole chips)

notebook

what it draws

tut 1.4 Saving-Your-Chip-Design

2 TransmonPocketCL + 2 pads, explicit full option dumps (useful default reference)

tut 1.5 Parametric-design

the 4-qubit ring of 1.3 swept over options

tut 2.12–2.15 routing

meander/anchor/mixed/airbridge routing demos between pockets

tut 2.24 Design-rule-checking

deliberately bad routes (thin gap, kink, airbridges) on a 6 × 6 mm chip, for DRC tests

tut 3.1–3.3, 4.01, 4.21, quick-topics/Managing-pins

1.3-style 4-pocket core, render/LOM demos

tut 4.13 / 4.14

transmon + resonator; double hanger (2 pockets, 2 CLTs, 8/9 mm meanders, chip 2 × 2 mm)

tut 4.16–4.18

hanger resonator test chips (LaunchpadWirebondDriven ×2, CLT, meander, OTG; chip 9 × 9 mm), S21 fits

tut 4.19

single transmon C-matrix with ElmerFEM

tut Design-and-Simulation-of-a-Cross-Resonance-Gate

2 TransmonPocket6 1 mm apart + meander coupler (CR-gate pair, no readout)

tut 4.44–4.46

the same 10 × 10 package device as tut443_10x10_package

Use

  • Use these as unit tests for each metal:<Class> wrapper (ports = Metal pin names) and for the per-component LOM models before building the chips.

  • The 4.16–4.18 hanger chips validate the Designer hanger’s κ and Q_ext. They need metal:LaunchpadWirebondDriven (or a BondPad port).

Quantcore PDK rebuild

The notebook is a Quantcore PDK rebuild of the source, not a replica: the netlist, LOM and imported components are kept, and the process is Quantcore’s.

Notebook: examples/designs/metal/component_examples.ipynb.

  • Chip: the Quantcore die frame (L dicing markers 1000/0, 3 × 3 alignment grids 1001/0, chip boundary 100/0, device ID where an edge is free; any brand text is QCT), drawn on the source’s 35 × 28 mm chip (the design does not fit the 7.5 mm die); no KQC chip frame.

  • Stack: sapphire 650 µm, εr 10.25 (the PDK default stack, used by the LOM estimates and every FEM export); Metal’s DesignPlanar default is silicon (εr 11.45, 750 µm), so the LOM capacitances, resonator frequencies and FEM jobs here are for sapphire rather than the source’s substrate.

  • Junctions: Quantcore Nb/AlOx/Nb trilayer junctions (junction_type from layouts.registry.trilayer_junction): fingers on 2/0 + 4/0, spacer 50/0 with the 51–53/0 gradient, sized on the PDK junction rule (Nb Δ = 1.4 meV, I_c·R_n = πΔ/2e, R_n·A 13.5 kΩ·µm² and C_J 50 fF/µm² assumed); every qubit gets the PDK nominal junction, 0.5 × 0.6 µm fingers → R_n = 45 kΩ, L_J = 6.73 nH, C_J = 15 fF (in the 40–50 kΩ window), the flux-tunable cells (TransmonCrossFL, TunableCoupler01) a PDK SQUID of two 0.25 × 0.6 µm junctions → R_n = 45 kΩ in parallel, L_J = 6.73 nH at zero flux, C_J = 15 fF (in the 40–50 kΩ window), in place of the 10 nH + 2 fF assumed for the source. The interdigitated transmon (C_Σ ≈ 216 fF) is sized for 4.05 GHz (L_J 6.4 nH, R_n ≈ 43 kΩ) to stay in the 4–8 GHz band. Expected (estimates from the LOM): crosses ≈ 5.8 GHz, pockets ≈ 7.1–7.4 GHz, Teeth ≈ 7.7 GHz, concentric ≈ 5.5 GHz, star ≈ 5.2 GHz, the D.31 coupler ≈ 8.6 GHz at zero flux. The two junction tiles (A.08 jj_dolan, A.09 jj_manhattan) keep Metal’s own junction drawing as a reference (single-layer, 2/0 only, so not a Quantcore junction).

  • Kept: the topology and every Metal component with the source’s options (through the metal: wrapper), positions and orientations, every route’s end pins and total length, the sim groups (each example on its own 7 × 7 mm tile, Metal’s route corner points and lengths).