quantcore_circuits.layouts.junctions.trilayer

Nb trilayer cross junctions with HSQ sidewall protection (ported from QWri JJ_finger Top/Bottom and xjc_junction_TL_mod.py / xjc_squid_TL_mod.py).

Two finger exposures cross over each other:

  • the straight finger (legacy layer 2/0, KQC SIS_junction) connects to the island (port_common side),

  • the bent finger (legacy layer 4/0, KQC SIS_junction_2) connects to ground (origin_squid side).

Both are drawn as negative-tone windows (window minus finger), exactly as the legacy fab output. HSQ boxes go to the Quantcore hsq layer (PDK v2 spacer, 50/0; the legacy scripts drew them on 500/0). The geometry is computed in database units with the same pya calls as the legacy code (including its float→int truncation), so it XORs clean against the legacy cells. The scripts set the finger PCells’ parameters, so KLayout first runs the legacy coerce_parameters_impl (coerce_straight() / coerce_bent(): e.g. a 0.6 µm bent finger widens its 1 µm lead to 1.26 µm); the cells apply the same rules.

Spacer gradient (PDK 51–53/0, design decision #4): the three shades are three dose levels of the 50/0 spacer. A rectangular spacer (the HSQ sidewall boxes) is split across its width into three nested strips of width / 3; windows (spacers with a hole) and concentric spacers are split into three rings (spacer_gradient_levels()). spacer_1 (51/0) is the level nearest the junction (legacy hsqi, inner), spacer_3 (53/0) the farthest (hsqo, outer). On by default where a spacer is drawn (PDK switch JunctionProcess.spacer_gradient); the legacy XOR tests compare 2/0, 4/0 and 50/0 only.

Sizing (design decisions #1 / #21): lj_nH > 0 sizes the straight finger from the PDK junction rule (quantcore_circuits.circuit.bridges.fingers_for_lj(): Δ = 1.4 meV, R_n·A of quantcore_circuits.pdk.JunctionProcess; SQUID cells: lj_nH is the parallel total, each junction gets twice it), keeping second_finger_width (0 → the PDK bent finger, 0.6 µm). Otherwise KQC’s junction_width (what a KQC qubit passes to its junction) sets the straight finger when it is at least the PDK minimum finger (0.1 µm; KQC’s 0.02 µm default is ignored), else finger_width is used as given.

clearer draws the legacy CLEARER: a base_metal_addition box (window − clearer_inset on each side, full window height) so the 1/0 etch leaves base metal in the junction gap and the 2/0 / 4/0 windows cut the fingers from it. The Quantcore* cells (QuantcoreJunction, QuantcoreSquid) are the PDK junctions for any qubit: TrilayerJunction / TrilayerSquid geometry with the PDK nominal fingers (0.5 × 0.6 µm → R_n = 45 kΩ), the clearer and the gradient on (junction_type: "Quantcore Junction" / "Quantcore Squid"). Simulation builds replace every junction_type by "Sim", so the clearer never shorts a FEM model.

Frame: KQC junction convention. origin_squid = (0, 0) at the centre of the window’s ground-side edge, port_common = (0, window_height) on the island side; the legacy junction cell is centred on the window, so its geometry is shifted up by window_height / 2.

Attributes

Classes

QuantcoreJunction

The Quantcore PDK junction (junction_type: "Quantcore Junction" in any KQC / Quantcore qubit): a

QuantcoreSquid

The Quantcore PDK SQUID (junction_type: "Quantcore Squid"): a symmetric TrilayerSquid whose whole SQUID

TrilayerJunction

Single Nb trilayer cross junction (legacy xjc_junction_TL_mod.create_junction).

TrilayerSquid

Two trilayer junctions forming a SQUID (legacy xjc_squid_TL_mod.create_squid).

Functions

bent_finger(dbu, pad_width, pad_height, finger_width, ...)

Legacy JJ_finger Bottom (the bent finger), in dbu. Returns a Region.

coerce_bent(pad_width, conn_height, finger_width, ...) → tuple[float, float, float]

Legacy JJ_finger Bottom.coerce_parameters_impl: (pad_width, conn_height, x), including its quirk of

coerce_straight(pad_width, pad_height, finger_width) → tuple[float, float]

Legacy JJ_finger Top.coerce_parameters_impl: (pad_width, pad_height).

coerced_bent_finger(dbu, pad_width, finger_width, ...)

bent_finger() (pad height 2, read-only in the legacy cell) after the legacy coercion.

coerced_straight_finger(dbu, pad_width, pad_height, ...)

straight_finger() after the legacy parameter coercion.

insert_spacer(cell, layout, spacer, gradient[, centres]) → None

Draw a spacer on qcc hsq (50/0) and, with gradient, its dose levels on spacer_1..3 (51–53/0).

is_squid_class(cls) → bool

place_trilayer(element, jtype, gap, a, b[, ...])

Insert the trilayer cell jtype (a Junction Library name, e.g. "Quantcore Junction") into

spacer_gradient_levels(spacer, dbu[, shades, centres]) → list

The spacer gradient (PDK spacer_1 … spacer_<shades>) of a spacer region, inner level first.

spacer_gradient_rings(hsq, step, dbu[, shades]) → list

Earlier (pre-#4) gradient: nested rings around the spacer, step µm wide each, inner first. Kept for

straight_finger(dbu, pad_width, pad_height, ...[, ...])

Legacy JJ_finger_top (the straight finger), in dbu. Returns a Region.

trilayer_classes() → dict

KQC junction-library name → class, for the trilayer junction cells ("Quantcore Junction" → ...).

trilayer_junction_values(junction_type[, params, pdk])

Electrical values (JunctionValues) of the junction a trilayer

trilayer_on_line(gap, a, b, dbu) → tuple[kqcircuits.pya_resolver.pya.DCplxTrans, float, float]

(transformation, window height, window width) of a trilayer junction cell bridging the gap that the

Module Contents

class quantcore_circuits.layouts.junctions.trilayer.QuantcoreJunction

Bases: TrilayerJunction

The Quantcore PDK junction (junction_type: "Quantcore Junction" in any KQC / Quantcore qubit): a TrilayerJunction with the PDK nominal fingers (straight 0.5 × bent 0.6 µm → R_n = 45 kΩ, L_J ≈ 6.7 nH on the default rule), the CLEARER box and the spacer gradient on. Size it with lj_nH or, from a KQC qubit, with the qubit’s junction_width (straight finger, µm).

clearer
finger_width
qcc_category = 'junction'
second_finger_width
class quantcore_circuits.layouts.junctions.trilayer.QuantcoreSquid

Bases: TrilayerSquid

The Quantcore PDK SQUID (junction_type: "Quantcore Squid"): a symmetric TrilayerSquid whose whole SQUID sits at the PDK nominal R_n (2026-11-13: the 40–50 kΩ window is for the SQUID; its junctions are higher): two junctions of 90 kΩ each (0.25 × 0.6 µm), parallel 45 kΩ, L_J ≈ 6.7 nH at zero flux. CLEARER and gradient on. lj_nH sizes the parallel total.

clearer
finger_width
qcc_category = 'junction'
second_finger_width
class quantcore_circuits.layouts.junctions.trilayer.TrilayerJunction

Bases: _TrilayerBase

Single Nb trilayer cross junction (legacy xjc_junction_TL_mod.create_junction).

build()
bent_conn_height
bent_finger_x
hsq_overlap
class quantcore_circuits.layouts.junctions.trilayer.TrilayerSquid

Bases: _TrilayerBase

Two trilayer junctions forming a SQUID (legacy xjc_squid_TL_mod.create_squid).

build()
hsq_overlap
junction_spacing
lead_length
quantcore_circuits.layouts.junctions.trilayer.bent_finger(dbu, pad_width, pad_height, finger_width, finger_length, conn_height, width, height, x, y, invert, negative=True)

Legacy JJ_finger Bottom (the bent finger), in dbu. Returns a Region.

quantcore_circuits.layouts.junctions.trilayer.coerce_bent(pad_width, conn_height, finger_width, finger_length, x, y, width, height) → tuple[float, float, float]

Legacy JJ_finger Bottom.coerce_parameters_impl: (pad_width, conn_height, x), including its quirk of resetting x (not y) when y is out of the window.

quantcore_circuits.layouts.junctions.trilayer.coerce_straight(pad_width: float, pad_height: float, finger_width: float) → tuple[float, float]

Legacy JJ_finger Top.coerce_parameters_impl: (pad_width, pad_height).

quantcore_circuits.layouts.junctions.trilayer.coerced_bent_finger(dbu, pad_width, finger_width, finger_length, conn_height, width, height, x, y, invert)

bent_finger() (pad height 2, read-only in the legacy cell) after the legacy coercion.

quantcore_circuits.layouts.junctions.trilayer.coerced_straight_finger(dbu, pad_width, pad_height, finger_width, finger_length, width, height, x, y)

straight_finger() after the legacy parameter coercion.

quantcore_circuits.layouts.junctions.trilayer.insert_spacer(cell: kqcircuits.pya_resolver.pya.Cell, layout: kqcircuits.pya_resolver.pya.Layout, spacer: kqcircuits.pya_resolver.pya.Region, gradient: bool, centres=None) → None

Draw a spacer on qcc hsq (50/0) and, with gradient, its dose levels on spacer_1..3 (51–53/0).

quantcore_circuits.layouts.junctions.trilayer.is_squid_class(cls) → bool
quantcore_circuits.layouts.junctions.trilayer.place_trilayer(element, jtype: str, gap: kqcircuits.pya_resolver.pya.Region, a: kqcircuits.pya_resolver.pya.DPoint, b: kqcircuits.pya_resolver.pya.DPoint, junction_params='{}')

Insert the trilayer cell jtype (a Junction Library name, e.g. "Quantcore Junction") into element across the gap of the junction line a (island side, port_common) → b (origin_squid), with the CLEARER on and junction_params (JSON / dict) passed on; returns the window footprint (dbu region). Raises ValueError for an unknown type or parameter.

quantcore_circuits.layouts.junctions.trilayer.spacer_gradient_levels(spacer: kqcircuits.pya_resolver.pya.Region, dbu: float, shades: int = 3, centres: list | None = None) → list

The spacer gradient (PDK spacer_1 … spacer_<shades>) of a spacer region, inner level first.

  • rectangles: shades nested strips of width / shades across the short side; the strip nearest one of centres (junction centres, DPoint µm or Point dbu; default: the spacer’s own centre) is level 1;

  • windows (a polygon with holes): shades rings of equal width from the hole outwards (level 1 at the hole);

  • other (concentric / round) spacers: shades rings of equal width from the outside in, level 1 the core.

The levels lie inside the spacer and tile it (disjoint, union = spacer).

quantcore_circuits.layouts.junctions.trilayer.spacer_gradient_rings(hsq: kqcircuits.pya_resolver.pya.Region, step: float, dbu: float, shades: int = 3) → list

Earlier (pre-#4) gradient: nested rings around the spacer, step µm wide each, inner first. Kept for reference only; the cells draw spacer_gradient_levels().

quantcore_circuits.layouts.junctions.trilayer.straight_finger(dbu, pad_width, pad_height, finger_width, finger_length, width, height, x, y, negative=True)

Legacy JJ_finger_top (the straight finger), in dbu. Returns a Region.

quantcore_circuits.layouts.junctions.trilayer.trilayer_classes() → dict

KQC junction-library name → class, for the trilayer junction cells ("Quantcore Junction" → …).

quantcore_circuits.layouts.junctions.trilayer.trilayer_junction_values(junction_type: str, params: dict | None = None, pdk=None)

Electrical values (JunctionValues) of the junction a trilayer cell draws for params (lj_nH, finger_width, second_finger_width, KQC junction_width), on the PDK rule; None when junction_type is not a trilayer cell.

quantcore_circuits.layouts.junctions.trilayer.trilayer_on_line(gap: kqcircuits.pya_resolver.pya.Region, a: kqcircuits.pya_resolver.pya.DPoint, b: kqcircuits.pya_resolver.pya.DPoint, dbu: float) → tuple[kqcircuits.pya_resolver.pya.DCplxTrans, float, float]

(transformation, window height, window width) of a trilayer junction cell bridging the gap that the junction line a (island side) → b crosses: origin_squid on the b-side gap edge, port_common on the a-side edge, the window as wide as fits (≤ 32 µm, 1 µm inside the gap on both sides).

quantcore_circuits.layouts.junctions.trilayer.MAX_WINDOW_WIDTH = 32.0