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 base_metal_gap (drawn = etch)

fine structure: feedline ends, resonator and transmon ground cut-outs

2/0

KQC SIS_junction

junction top finger

3/0

derived: filled keep-outs (KeepoutRule)

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 SIS_junction_2

junction second finger

50/0

qcc hsq

junction spacer material (HSQ)

51–53/0

qcc spacer_1 … spacer_3

spacer gradient (greyscale lithography shades)

100/0

qcc chip_boundary (drawn by the die frame)

chip boundary

500/0

qcc wafer_boundary

wafer boundary (wafer level, Wafer)

501/0

qcc wafer_markers

wafer markers: die labels / outlines, alignment and orientation marks (wafer level, Wafer)

1000/0 …

qcc marker_0 … (drawn by the die frame)

marker layers: 1000/0 dicing markers, 1001/0 alignment-marker grids (confirmed 2026-11-03)

300/0

KQC airbridge_pads

airbridge layers (“300/0”); the bridge

301/0

KQC airbridge_flyover

(flyover) on 301/0 is an assumption

700/0

KQC through_silicon_via

TSVs

800/0 …

KQC face 2b1 (flip-chip top chip)

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 by rows grid 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

CheeseRule

Ground cheese (design rule): holes only in a band around the components, not over the whole chip.

CornerRounding

Fab-export rounding of sharp corners (design rule): each polygon's corners get a radius tied to its shortest

DieFrame

Die frame (components/pdk_geometry_summary.md), drawn inside the chip box; all lengths in µm.

FabLayer

JunctionProcess

Quantcore Nb/AlOx/Nb trilayer junction rule (2026-11-03): Nb gap Δ = 1.4 meV, R_n 40–50 kΩ, qubits

KeepoutRule

3/0: where the second metal is etched away after its deposition (design rule, 2026-11-03), so it cannot short

Pdk

Stack

Material stack used by simulation exports (all lengths in µm).

Functions

get_pdk([name]) → Pdk

register_pdk(pdk) → None

substrate_name(base[, h, eps_r, tan_d]) → str

The PDK name of base with its own substrate values (None / equal to the PDK's: left out; all left out: the

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 rows grid pitches; size µm squares on a chip-aligned grid with gap µ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 to layer, 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 (still clearance from 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_grid layer, so layouts and snapshots show it. Chip parameter cheese: "auto" (default), "pdk" (the band), "chip" (the whole die at this density; a KQC with_grid is 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 (KQC with_grid, or a static cell with its holes, marked cheese: "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 below min_radius. Applied to layers (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, a marker_area square 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.edge in a design puts an instance there; KQC sample-holder launchers get their launcher_indent from it (unless a design sets launchers.indent); the DRC flags pads that are not there (pad_edge warning).

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_11m JX, 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 at bent_finger_um and solves the straight finger, rounded to finger_grid_um within finger_range_um.

spacer_gradient switches the 51–53/0 dose levels on by default in every junction cell that draws a 50/0 spacer (decision #4: rectangular spacers split into spacer_shades nested 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_meV and rn_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 classmethod qcc_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_margin 6 → 10, component_margin 20 → 24, other_margin 5 → 9, and the keep-outs the cells draw themselves (qcc_keepout, legacy PCells) grow by own_grow = 4 (applied once in keepout_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 Simulation parameters 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)
fab_layers: dict[str, FabLayer]
face: str = '1t1'
films: dict[str, KineticInductance]
frame: DieFrame | None
junction: JunctionProcess
keepout: KeepoutRule
kinetic: KineticInductance
m3_margin_um: float = 5.0
name: str
rounding: CornerRounding | None
stack: Stack
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.get_pdk(name: str = DEFAULT_PDK) → Pdk
quantcore_circuits.pdk.register_pdk(pdk: Pdk) → None
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 base with its own substrate values (None / equal to the PDK’s: left out; all left out: the plain base).

quantcore_circuits.pdk.DEFAULT_PDK
quantcore_circuits.pdk.QCC_LAYERS
quantcore_circuits.pdk.QUANTCORE_NB_SAPPHIRE_V1
quantcore_circuits.pdk.QUANTCORE_NB_SI_V1