quantcore_circuits.pdk¶
Quantcore process design kit: fab layer map, stack-up and CPW defaults.
Geometry is always drawn in KQC layer names (1t1_base_metal_gap_wo_grid, 1t1_SIS_junction, …) plus a few
Quantcore layers (QCC_LAYERS, drawn at their fab numbers). Fab layer numbers appear at mask export
(quantcore_circuits.layouts.wafers.fab_export). The map below is the fab layer map (2026-11-03), all as a
negative mask (drawn = removed / exposed):
fab layer |
source |
meaning |
|---|---|---|
1/0 |
KQC |
fine structure: feedline ends, resonator and transmon ground cut-outs |
2/0 |
KQC |
junction top finger |
3/0 |
derived: filled keep-outs ( |
second-metal subtractive etch: each 1/0 feature including what lies between its gaps (a CPW’s centre conductor, a qubit’s island) + ground margin, plus the cheese holes (the same squares as on 1/0) |
4/0 |
KQC |
junction second finger |
50/0 |
qcc |
junction spacer material (HSQ) |
51–53/0 |
qcc |
spacer gradient (greyscale lithography shades) |
100/0 |
qcc |
chip boundary |
500/0 |
qcc |
wafer boundary (wafer level, |
501/0 |
qcc |
wafer markers: die labels / outlines, alignment
and orientation marks (wafer level, |
1000/0 … |
qcc |
marker layers: 1000/0 dicing markers, 1001/0 alignment-marker grids (confirmed 2026-11-03) |
300/0 |
KQC |
airbridge layers (“300/0”); the bridge |
301/0 |
KQC |
(flyover) on 301/0 is an assumption |
700/0 |
KQC |
TSVs |
800/0 … |
KQC face |
800/0 its base-metal etch, 801/0 indium bumps, 802/0 under-bump metal, 803/0 + 804/0 its junction fingers (numbering after 800 assumed) |
Universal Quantcore (QCT) chip rules (2026-11-03), applied to every chip built with this PDK:
the die frame: L-shaped dicing markers and the 3×3 alignment grids (
DieFrame); the device ID is optional (edge centres → beside the feedline pads, 50 µm gap → slid along the left/right edges; omitted if nowhere free);the brand text is
"QCT"(Pdk.brand) wherever a KQC chip frame draws one;fab export only (never in simulation exports): ground cheese in a band around the components, or over the whole die for chip parameter
cheese: "chip"(CheeseRule: 3/0 grown byrowsgrid pitches, 5 µm squares, 20 µm gaps, none within 4 µm of the 3/0 keep-outs; every hole is written on 1/0 and on 3/0) and rounded corners with a radius tied to each polygon’s shortest dimension (CornerRounding).
The die frame (DieFrame, components/pdk_geometry_summary.md) is drawn on every chip by default.
hsq_boundary (legacy HSQ write-field frame, 150/0) is kept for the legacy marker cells but is not a fab layer.
Legacy helper layers 9/0 (bounding box) and 10/0 (scratch) are not exported.
Attributes¶
Classes¶
Ground cheese (design rule): holes only in a band around the components, not over the whole chip. |
|
Fab-export rounding of sharp corners (design rule): each polygon's corners get a radius tied to its shortest |
|
Die frame ( |
|
Quantcore Nb/AlOx/Nb trilayer junction rule (2026-11-03): Nb gap Δ = 1.4 meV, R_n 40–50 kΩ, qubits |
|
3/0: where the second metal is etched away after its deposition (design rule, 2026-11-03), so it cannot short |
|
Material stack used by simulation exports (all lengths in µm). |
Functions¶
|
|
|
|
|
The PDK name of |
Package Contents¶
- class quantcore_circuits.pdk.CheeseRule¶
Ground cheese (design rule): holes only in a band around the components, not over the whole chip.
The band is the 3/0 keep-out grown by
rowsgrid pitches;sizeµm squares on a chip-aligned grid withgapµm between them (pitch = size + gap) are kept where they lie entirely in the band,clearanceµm or more from 3/0, inside the design area and clear of the frame’s markers and device ID. They are etched (added tolayer, M1 = 1/0) and, as the same squares (not grown by the keep-out margin), added to 3/0 (2026-11-17: the cheese is on both fab layers 1/0 and 3/0; the clearance is to the keep-outs alone). Simulation exports never get cheese.fill="chip"puts the same squares over the whole design area instead of a band (stillclearancefrom 3/0, clear of the frame markers and the device ID).Holes go in the ground plane only: metal connected to the die edge, or an isolated metal piece of at least
ground_island_mm2(ground enclosed by a closed bus ring or a feedline loop). Smaller isolated pieces are pads and islands (a transmon’s pads, a probe pad) and get none. The largest such pads in the examples are 1.0 mm² (1.2 × 0.84 mm transmon pads), the smallest enclosed ground 1.6 mm² (a four-qubit bus ring).Where it is drawn: in the chip build itself, into KQC’s
ground_gridlayer, so layouts and snapshots show it. Chip parametercheese:"auto"(default),"pdk"(the band),"chip"(the whole die at this density; a KQCwith_gridis switched off),"original"(nothing added), or a dict (an original design’s own rule). The original design wins under"auto": a design that carries its own cheese (KQCwith_grid, or a static cell with its holes, markedcheese: "original") keeps it and gets no PDK band; a design without any gets this band. The fab export adds the band only to a build that has no cheese at all.- clearance: float = 4.0¶
- fill: str = 'band'¶
- gap: float = 20.0¶
- ground_island_mm2: float = 1.5¶
- layer: str = 'M1'¶
- property pitch: float¶
- rows: int = 3¶
- size: float = 5.0¶
- class quantcore_circuits.pdk.CornerRounding¶
Fab-export rounding of sharp corners (design rule): each polygon’s corners get a radius tied to its shortest dimension, so narrow features keep their shape and wide ones get softer corners.
Shortest dimension d = min(2·area/perimeter, shortest straight edge ≥
min_edge) (a strip of width w gives w); radius r = min(fraction· d,max_radius), skipped belowmin_radius. Applied tolayers(fab-layer names) before cheesing; junction fingers are left exact by default.- fraction: float = 0.25¶
- layers: tuple[str, ...] = ('M1', 'M3')¶
- max_radius: float = 10.0¶
- min_edge: float = 2.0¶
- min_radius: float = 0.1¶
- points: int = 64¶
- class quantcore_circuits.pdk.DieFrame¶
Die frame (
components/pdk_geometry_summary.md), drawn inside the chip box; all lengths in µm.Corner L-shaped dicing markers (legs along the die edges), a design area inset by
margin, amarker_areasquare in each corner of the design area holding a 3×3 alignment grid, and the device-ID block centred at the bottom of the design area. Grid positions are measured from the die corner, mirrored for the other corners.Pad rule (2026-11-03; distance 2026-11-10): bond pads and launchers sit with the outer edge of their etch
pad_edge= 100 µm from the die edge (the design-area margin), whatever the original chip did.place.edgein a design puts an instance there; KQC sample-holder launchers get theirlauncher_indentfrom it (unless a design setslaunchers.indent); the DRC flags pads that are not there (pad_edgewarning).- alignment_layer: str = 'marker_1'¶
- boundary_layer: str = 'chip_boundary'¶
- device_id: tuple[float, float] = (700.0, 300.0)¶
- dicing_layer: str = 'marker_0'¶
- dicing_leg: float = 250.0¶
- dicing_width: float = 25.0¶
- grid_large: float = 10.0¶
- grid_small: float = 5.0¶
- grid_x: tuple[float, float, float] = (302.5, 452.5, 602.5)¶
- grid_y: tuple[float, float, float] = (305.0, 452.5, 600.0)¶
- margin: float = 100.0¶
- marker_area: float = 500.0¶
- pad_edge: float = 100.0¶
- class quantcore_circuits.pdk.FabLayer¶
- datatype: int¶
- description: str = ''¶
- faces: tuple[str, ...] | None = None¶
- property info: kqcircuits.pya_resolver.pya.LayerInfo¶
- invert: bool = False¶
- layer: int¶
- source: str¶
- class quantcore_circuits.pdk.JunctionProcess¶
Quantcore Nb/AlOx/Nb trilayer junction rule (2026-11-03): Nb gap Δ = 1.4 meV, R_n 40–50 kΩ, qubits at 4–8 GHz. Formulas:
quantcore_circuits.circuit.bridges(I_c·R_n = πΔ/2e, Ambegaokar–Baratoff at T ≪ T_c; L_J = Φ0/2πI_c; R_n = R_n·A / area;size_junction()).Assumed (not stated in the fab spec; flagged as an open assumption): the specific resistance
rn_area_ohm_um2= 45 kΩ × 0.30 µm², chosen so the trilayer chips’ nominal qubit junction (straight 0.5 µm × bent 0.6 µm: chip_05 Q2–Q6, chip_10a, chip_11mJX, the centre of the chip_04/06/08 test sweeps) has R_n = 45 kΩ; that is J_c = πΔ/(2e·R_n·A) ≈ 0.163 µA/µm² (16 A/cm²).cj_fF_per_um2(50 fF/µm²) is the usual Nb/AlOx/Nb specific capacitance. Sizing keeps the bent finger atbent_finger_umand solves the straight finger, rounded tofinger_grid_umwithinfinger_range_um.spacer_gradientswitches the 51–53/0 dose levels on by default in every junction cell that draws a 50/0 spacer (decision #4: rectangular spacers split intospacer_shadesnested strips of width/3, windows and concentric spacers into rings;quantcore_circuits.layouts.junctions.trilayer.spacer_gradient_levels()).- bent_finger_um: float = 0.6¶
- cj_fF_per_um2: float = 50.0¶
- f_q_range_GHz: tuple[float, float] = (4.0, 8.0)¶
- finger_grid_um: float = 0.01¶
- finger_range_um: tuple[float, float] = (0.1, 2.0)¶
- gap_meV: float = 1.4¶
- property jc_uA_per_um2: float¶
Critical-current density implied by
gap_meVandrn_area_ohm_um2(µA/µm²).
- material: str = 'Nb/AlOx/Nb trilayer'¶
- property nominal_area_um2: float¶
- nominal_fingers_um: tuple[float, float] = (0.5, 0.6)¶
- rn_area_ohm_um2: float = 13500.0¶
- rn_nominal_kohm: float = 45.0¶
- rn_target_kohm: tuple[float, float] = (40.0, 50.0)¶
- spacer_gradient: bool = True¶
- spacer_shades: int = 3¶
- class quantcore_circuits.pdk.KeepoutRule¶
3/0: where the second metal is etched away after its deposition (design rule, 2026-11-03), so it cannot short the 1/0 features. Filled regions — they do not exclude the 1/0 structure in the middle:
routes (CPW lines, meanders): the whole CPW footprint (gaps + centre conductor) grown by
route_margin(legacy resonators ≈ 6 µm: some ground on both sides);components (qubits, pads, capacitors …): the bounding box of their etch grown by
component_margin— a square/rectangle engulfing some ground (as the legacy Xmon / two-pad PCells draw it), unless the cell defines its own keep-out with a classmethodqcc_keepout(params) -> [pya.DBox | pya.DPolygon](local µm);anything else drawn in 1/0 (device-ID text, shapes placed directly): grown by
other_margin.
Fab change 2026-11-17 (design rule): every 3/0 keep-out is 4 µm wider per side than before (the cheese sat too close to its edge):
route_margin6 → 10,component_margin20 → 24,other_margin5 → 9, and the keep-outs the cells draw themselves (qcc_keepout, legacy PCells) grow byown_grow= 4 (applied once inkeepout_region(), not per cell).Whole chips placed as one cell (e.g. a KQC chip replica) are opened and their parts treated as above; a KQC chip cell with no sub-cells (its geometry drawn into the chip cell itself), or any cell over more than half the die, gets its etch grown by
other_margin, not its bounding box.Gaps the union leaves between neighbouring keep-outs are filled when smaller than
fill_holes_um2; larger enclosed areas — the ground inside a closed bus ring — stay outside 3/0 (they are ground, not a feature), so the cheese can reach them (notebooks-metal, 2026-11-10).- component_margin: float = 24.0¶
- fill_holes_um2: float = 40000.0¶
- other_margin: float = 9.0¶
- own_grow: float = 4.0¶
- route_margin: float = 10.0¶
- class quantcore_circuits.pdk.Pdk¶
- film(name: str | None = None) KineticInductance¶
The kinetic inductance of film
name(“Nb”, “NbN”); None → the default film (kinetic).
- material_dict() dict¶
- simulation_params() dict¶
KQC
Simulationparameters for this stack.
- brand: str = 'QCT'¶
- cheese: CheeseRule | None¶
- cpw_a: float = 10.0¶
- cpw_b: float = 6.0¶
- design_grid_um: float = 0.001¶
- die_size: tuple[float, float] = (7500.0, 7500.0)¶
- face: str = '1t1'¶
- films: dict[str, KineticInductance]¶
- junction: JunctionProcess¶
- keepout: KeepoutRule¶
- kinetic: KineticInductance¶
- m3_margin_um: float = 5.0¶
- name: str¶
- rounding: CornerRounding | None¶
- turn_radius: float = 100.0¶
- version: str¶
- class quantcore_circuits.pdk.Stack¶
Material stack used by simulation exports (all lengths in µm).
- chip_distance: float = 8.0¶
- london_penetration_depth_um: float = 0.09¶
- lower_box_height: float = 0.0¶
- metal_height: float = 0.0¶
- metal_thickness_um: float = 0.2¶
- substrate_height: float = 650.0¶
- substrate_loss_tangent: float = 1e-06¶
- substrate_material: str = 'sapphire'¶
- substrate_permittivity: float = 10.25¶
- upper_box_height: float = 1000.0¶
- quantcore_circuits.pdk.substrate_name(base: str, h: float | None = None, eps_r: float | None = None, tan_d: float | None = None) str¶
The PDK name of
basewith its own substrate values (None / equal to the PDK’s: left out; all left out: the plainbase).
- quantcore_circuits.pdk.DEFAULT_PDK¶
- quantcore_circuits.pdk.QCC_LAYERS¶
- quantcore_circuits.pdk.QUANTCORE_NB_SAPPHIRE_V1¶
- quantcore_circuits.pdk.QUANTCORE_NB_SI_V1¶