quantcore_circuits.pdk ====================== .. py:module:: quantcore_circuits.pdk .. autoapi-nested-parse:: 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 (:data:`QCC_LAYERS`, drawn at their fab numbers). Fab layer numbers appear at mask export (:mod:`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 (:class:`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 (:class:`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"`` (:attr:`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"`` (:class:`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 (:class:`CornerRounding`). The die frame (:class:`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 ---------- .. autoapisummary:: quantcore_circuits.pdk.DEFAULT_PDK quantcore_circuits.pdk.QCC_LAYERS quantcore_circuits.pdk.QUANTCORE_NB_SAPPHIRE_V1 quantcore_circuits.pdk.QUANTCORE_NB_SI_V1 Classes ------- .. autoapisummary:: quantcore_circuits.pdk.CheeseRule quantcore_circuits.pdk.CornerRounding quantcore_circuits.pdk.DieFrame quantcore_circuits.pdk.FabLayer quantcore_circuits.pdk.JunctionProcess quantcore_circuits.pdk.KeepoutRule quantcore_circuits.pdk.Pdk quantcore_circuits.pdk.Stack Functions --------- .. autoapisummary:: quantcore_circuits.pdk.get_pdk quantcore_circuits.pdk.register_pdk quantcore_circuits.pdk.substrate_name Package Contents ---------------- .. py:class:: 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. .. py:attribute:: clearance :type: float :value: 4.0 .. py:attribute:: fill :type: str :value: 'band' .. py:attribute:: gap :type: float :value: 20.0 .. py:attribute:: ground_island_mm2 :type: float :value: 1.5 .. py:attribute:: layer :type: str :value: 'M1' .. py:property:: pitch :type: float .. py:attribute:: rows :type: int :value: 3 .. py:attribute:: size :type: float :value: 5.0 .. py:class:: 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. .. py:attribute:: fraction :type: float :value: 0.25 .. py:attribute:: layers :type: tuple[str, ...] :value: ('M1', 'M3') .. py:attribute:: max_radius :type: float :value: 10.0 .. py:attribute:: min_edge :type: float :value: 2.0 .. py:attribute:: min_radius :type: float :value: 0.1 .. py:attribute:: points :type: int :value: 64 .. py:class:: 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). .. py:attribute:: alignment_layer :type: str :value: 'marker_1' .. py:attribute:: boundary_layer :type: str :value: 'chip_boundary' .. py:attribute:: device_id :type: tuple[float, float] :value: (700.0, 300.0) .. py:attribute:: dicing_layer :type: str :value: 'marker_0' .. py:attribute:: dicing_leg :type: float :value: 250.0 .. py:attribute:: dicing_width :type: float :value: 25.0 .. py:attribute:: grid_large :type: float :value: 10.0 .. py:attribute:: grid_small :type: float :value: 5.0 .. py:attribute:: grid_x :type: tuple[float, float, float] :value: (302.5, 452.5, 602.5) .. py:attribute:: grid_y :type: tuple[float, float, float] :value: (305.0, 452.5, 600.0) .. py:attribute:: margin :type: float :value: 100.0 .. py:attribute:: marker_area :type: float :value: 500.0 .. py:attribute:: pad_edge :type: float :value: 100.0 .. py:class:: FabLayer .. py:attribute:: datatype :type: int .. py:attribute:: description :type: str :value: '' .. py:attribute:: faces :type: tuple[str, ...] | None :value: None .. py:property:: info :type: kqcircuits.pya_resolver.pya.LayerInfo .. py:attribute:: invert :type: bool :value: False .. py:attribute:: layer :type: int .. py:attribute:: source :type: str .. py:class:: 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: :mod:`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; :func:`~quantcore_circuits.circuit.bridges.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; :func:`quantcore_circuits.layouts.junctions.trilayer.spacer_gradient_levels`). .. py:attribute:: bent_finger_um :type: float :value: 0.6 .. py:attribute:: cj_fF_per_um2 :type: float :value: 50.0 .. py:attribute:: f_q_range_GHz :type: tuple[float, float] :value: (4.0, 8.0) .. py:attribute:: finger_grid_um :type: float :value: 0.01 .. py:attribute:: finger_range_um :type: tuple[float, float] :value: (0.1, 2.0) .. py:attribute:: gap_meV :type: float :value: 1.4 .. py:property:: jc_uA_per_um2 :type: float Critical-current density implied by ``gap_meV`` and ``rn_area_ohm_um2`` (µA/µm²). .. py:attribute:: material :type: str :value: 'Nb/AlOx/Nb trilayer' .. py:property:: nominal_area_um2 :type: float .. py:attribute:: nominal_fingers_um :type: tuple[float, float] :value: (0.5, 0.6) .. py:attribute:: rn_area_ohm_um2 :type: float :value: 13500.0 .. py:attribute:: rn_nominal_kohm :type: float :value: 45.0 .. py:attribute:: rn_target_kohm :type: tuple[float, float] :value: (40.0, 50.0) .. py:attribute:: spacer_gradient :type: bool :value: True .. py:attribute:: spacer_shades :type: int :value: 3 .. py:class:: 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 :func:`~quantcore_circuits.layouts.wafers.fab_export.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). .. py:attribute:: component_margin :type: float :value: 24.0 .. py:attribute:: fill_holes_um2 :type: float :value: 40000.0 .. py:attribute:: other_margin :type: float :value: 9.0 .. py:attribute:: own_grow :type: float :value: 4.0 .. py:attribute:: route_margin :type: float :value: 10.0 .. py:class:: Pdk .. py:method:: film(name: str | None = None) -> KineticInductance The kinetic inductance of film ``name`` ("Nb", "NbN"); None → the default film (``kinetic``). .. py:method:: material_dict() -> dict .. py:method:: simulation_params() -> dict KQC ``Simulation`` parameters for this stack. .. py:attribute:: brand :type: str :value: 'QCT' .. py:attribute:: cheese :type: CheeseRule | None .. py:attribute:: cpw_a :type: float :value: 10.0 .. py:attribute:: cpw_b :type: float :value: 6.0 .. py:attribute:: design_grid_um :type: float :value: 0.001 .. py:attribute:: die_size :type: tuple[float, float] :value: (7500.0, 7500.0) .. py:attribute:: fab_layers :type: dict[str, FabLayer] .. py:attribute:: face :type: str :value: '1t1' .. py:attribute:: films :type: dict[str, KineticInductance] .. py:attribute:: frame :type: DieFrame | None .. py:attribute:: junction :type: JunctionProcess .. py:attribute:: keepout :type: KeepoutRule .. py:attribute:: kinetic :type: KineticInductance .. py:attribute:: m3_margin_um :type: float :value: 5.0 .. py:attribute:: name :type: str .. py:attribute:: rounding :type: CornerRounding | None .. py:attribute:: stack :type: Stack .. py:attribute:: turn_radius :type: float :value: 100.0 .. py:attribute:: version :type: str .. py:class:: Stack Material stack used by simulation exports (all lengths in µm). .. py:attribute:: chip_distance :type: float :value: 8.0 .. py:attribute:: london_penetration_depth_um :type: float :value: 0.09 .. py:attribute:: lower_box_height :type: float :value: 0.0 .. py:attribute:: metal_height :type: float :value: 0.0 .. py:attribute:: metal_thickness_um :type: float :value: 0.2 .. py:attribute:: substrate_height :type: float :value: 650.0 .. py:attribute:: substrate_loss_tangent :type: float :value: 1e-06 .. py:attribute:: substrate_material :type: str :value: 'sapphire' .. py:attribute:: substrate_permittivity :type: float :value: 10.25 .. py:attribute:: upper_box_height :type: float :value: 1000.0 .. py:function:: get_pdk(name: str = DEFAULT_PDK) -> Pdk .. py:function:: register_pdk(pdk: Pdk) -> None .. py:function:: 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``). .. py:data:: DEFAULT_PDK .. py:data:: QCC_LAYERS .. py:data:: QUANTCORE_NB_SAPPHIRE_V1 .. py:data:: QUANTCORE_NB_SI_V1