% generated by scripts/make_component_docs.py -- do not edit. Put hand-written notes in docs/components/notes/metal_StarQubit.md (included below). # metal:StarQubit A single configurable circle with multiple pads. **Source:** Metal (Qiskit Metal). **Category:** qubit. **Module:** `qiskit_metal.qlibrary.qubits.star_qubit`. See also the [catalog](../CATALOG.md). ## Pins ![Pins of metal:StarQubit](../../images/components/metal_StarQubit.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 | |---|---|---|---|---|---|---| | `pin_cpl1` | 0 | -375 | 270 | 10 | 6 | LOM node `pin_cpl1` | | `pin_cpl2` | 356.646 | -115.881 | 342 | 10 | 6 | LOM node `pin_cpl2` | | `pin_cpl3` | -220.419 | 303.381 | 126 | 10 | 6 | LOM node `pin_cpl3` | | `pin_cpl4` | -356.646 | -115.881 | 198 | 10 | 6 | LOM node `pin_cpl4` | | `pin_rdout` | 220.419 | 303.381 | 54 | 10 | 6 | LOM node `pin_rdout` | | `squid_a` | 0 | 345 | none | 10 | 6 | junction pins (the LOM's L_J); LOM node `island` | | `squid_b` | 0 | 395 | none | 10 | 6 | junction pins (the LOM's L_J); grounded in the LOM | 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`). ## 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` | `"StarQubit"` | – | 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` | C | island – gnd | estimate=49, unit=fF, estimate_source=rough: centre island as a disk (star arms neglected), estimate_kind=rough, uncertainty=±50% | | `J_X` | JJ | island – gnd | Lj_nH=10, Cj_fF=0 | | `Cg_X_pin_cpl1` | C | island – pin_cpl1 | estimate=29, unit=fF, estimate_source=rough: pad sector facing the island (CPS), estimate_kind=rough, uncertainty=±50% | | `Cc_X_pin_cpl1` | C | pin_cpl1 – gnd | estimate=24, unit=fF, estimate_source=rough: pad outer edge (half CPW), estimate_kind=rough, uncertainty=±50% | | `Cg_X_pin_cpl2` | C | island – pin_cpl2 | estimate=29, unit=fF, estimate_source=rough: pad sector facing the island (CPS), estimate_kind=rough, uncertainty=±50% | | `Cc_X_pin_cpl2` | C | pin_cpl2 – gnd | estimate=24, unit=fF, estimate_source=rough: pad outer edge (half CPW), estimate_kind=rough, uncertainty=±50% | | `Cg_X_pin_cpl3` | C | island – pin_cpl3 | estimate=29, unit=fF, estimate_source=rough: pad sector facing the island (CPS), estimate_kind=rough, uncertainty=±50% | | `Cc_X_pin_cpl3` | C | pin_cpl3 – gnd | estimate=24, unit=fF, estimate_source=rough: pad outer edge (half CPW), estimate_kind=rough, uncertainty=±50% | | `Cg_X_pin_cpl4` | C | island – pin_cpl4 | estimate=29, unit=fF, estimate_source=rough: pad sector facing the island (CPS), estimate_kind=rough, uncertainty=±50% | | `Cc_X_pin_cpl4` | C | pin_cpl4 – gnd | estimate=24, unit=fF, estimate_source=rough: pad outer edge (half CPW), estimate_kind=rough, uncertainty=±50% | | `Cg_X_pin_rdout` | C | island – pin_rdout | estimate=35, unit=fF, estimate_source=rough: pad sector facing the island (CPS), estimate_kind=rough, uncertainty=±50% | | `Cc_X_pin_rdout` | C | pin_rdout – gnd | estimate=30, unit=fF, estimate_source=rough: pad outer edge (half CPW), estimate_kind=rough, uncertainty=±50% | Nodes: `island`, `pin_cpl1`, `pin_cpl2`, `pin_cpl3`, `pin_cpl4`, `pin_rdout`. ## Simulation export notes - C5: Metal-wrapped junction pins off the metal edges (stand-in sheet is wrong) (status: fixed; fix in sim_tools/builder.py (FaceMetal, junction_gap, junction_sheet, sheet_junction_port)) ## How to use In Python: ```python from quantcore_circuits.designer import Designer d = Designer("demo", box=(0, 0, 7500, 7500)) d.add("U1", "metal:StarQubit", 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.pin_cpl1") # 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:StarQubit` 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.