# 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. ```{image} ../../images/designs/metal/component_examples.png :alt: The whole component-examples board as the v2 notebook builds it :width: 100% ``` ## 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 ```{image} ../../images/designs/metal/component_examples_steps.png :alt: The layout segments of component_examples, one picture each :width: 100% ``` 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 | ```{image} ../../images/designs/metal/component_examples_lom.png :width: 80% :alt: LOM plot of component_examples ``` These are lumped-model estimates from component formulas and calibration, not FEM results. [The LOM page](../../library/lom.md) 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:` 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:` 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`](../../../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).