Design notebooks¶
The notebooks in examples/designs/ rebuild published chips (from Qiskit Metal, KQCircuits, IBM, Google, QPDK and
other open projects) on the Quantcore PDK. Each one builds its chip one segment at a time, with a picture after each
segment: die, bond pads, readout, qubits, resonators, coupling, control lines, whole chip. Then it walks the same
steps as the plugin: Check, LOM, Simulate, Results, Fab.
Pick the chip closest to the one you want and read how it is built.
The groups¶
Group |
Where the designs come from |
Notebooks |
Build today |
|---|---|---|---|
Qiskit Metal tutorials and circuit examples (Apache-2.0) |
19 |
all 19 |
|
KQC’s own chips, test chips and a wafer mask (GPL-3.0) |
22 |
all 22 |
|
gdsfactory’s quantum-rf-pdk test chips (MIT) |
8 |
all 8 |
|
IBM’s 5-qubit bowtie and 27-qubit Falcon, laid out from published device data |
2 |
both |
|
Google’s tunable-coupler cell and a 2 × 2 plaquette, laid out from the papers |
2 |
both |
|
AWS DeviceLayout.jl examples (MIT), incl. a 17-qubit surface code |
2 |
both |
|
public repositories and data sets (licences on each page) |
8 |
all 8 |
|
SQDMetal example notebooks (Apache-2.0) |
4 |
all 4 |
|
SQuADDS tutorial 5, a fab-ready four-qubit chip (MIT) |
1 |
yes |
|
JPAs and TWPAs from QPDK, twpa-sim and UNSW |
6 |
all 6 |
|
Quantcore’s own earlier chips (notebooks not rewritten; rebuilt from their saved designs for the pictures) |
20 |
all 20 designs |
“Build today” means the notebook’s Setup and Design cells ran without error on 2026-11-19: 74 of 74. The 20 legacy
designs were rebuilt from their saved design.json (their notebooks were not run): 20 of 20.
Reading a design page¶
Every page has the same order:
What it is: two short paragraphs and a picture of the whole chip.
At a glance: the notebook, the source and licence, the chip size, what is on it, and whether it builds today.
How the notebook builds it: one picture per segment and one line on what each segment adds.
LOM estimates: qubit and resonator frequencies, anharmonicity, κ and χ from the lumped model (not FEM).
Build spec: the detailed spec the notebook was written from (every component, port, route and length).
Run one yourself¶
Open the notebook in Jupyter from the
qcdenvironment (see getting started).Run it top to bottom. KLayout opens live by default; set
QCC_LIVE=0before starting Jupyter for no window.The switch cell at the top keeps every FEM solve off (
RUN_FEM = False): the Simulate cells export the jobs and the Results cells load kept results if there are any. Turn it on only with AEDT 2024 R1 or later installed.The Design 8 cell (Design 6 in the amplifiers) should print “Same design as before”.
How a design notebook works explains the template, the switches, the variants and a checklist
for the first full run. The old one-cell version of each notebook is kept beside it as <id>.v1.ipynb, with its
outputs.