# Tutorial 0: Quickstart `examples/tutorials/00_quickstart_klive_and_pdk.ipynb` builds a one-qubit chip from nothing, one component per cell: two pads, a feedline, an Xmon with a trilayer junction and a λ/4 hanger readout. After every step it shows the layout, the DRC, the netlist and the LOM. It ends with the FEM round trip, a feedback step and the fab export. Start here: tutorials 1 to 4 repeat the same steps on bigger chips. ```{figure} ../images/tutorials/t00_chip.png :width: 50% The finished chip (section 6): two pads, the feedline, the Xmon and its meandered λ/4 readout. ``` ## The sections | Section | What it does | Call | What comes out | |---|---|---|---| | 1 PDK | Reads the process design kit every build uses | `get_pdk()`, `T.pdk_md(pdk)` | A table of the stack, the CPW, the die frame and the pad, junction and keep-out rules, then the fab layer map | | 2 Die and live view | Starts an empty 7.5 × 7.5 mm die | `Designer(name, box=..., live=LIVE)` | An empty die with the QCT frame | | 3 Pads | Two bond pads at the 100 µm rule | `d.add("PAD_W", "BondPad", ..., edge="auto")` | Pads slid to 100 µm from the die edge; DRC with 2 `dangling_port` warnings | | 4 Feedline | One CPW between the pads | `d.route("FL", pw.a, pe.a)` | DRC clean; a netlist with nodes `gnd` and `FL` and two 50 Ω ports | | 5 Qubit | An Xmon with one claw and a trilayer junction sized from a target | `size_junction(f_q, C_Σ)`, `trilayer_junction("Xmon")` | C_Σ ≈ 99.2 fF, L_J 6.92 nH, R_n 46.2 kΩ (inside 40 to 50 kΩ) | | 6 Readout | A λ/4 hanger from the claw to the feedline | `d.route("R1", q1.claw_n, fl.hanger(near=..., length=300), meander=L_R1)` | R1 of 4501 µm; DRC clean | | 7 Netlist and LOM | Builds the netlist and simulates it | `d.lom()`, `C.simulate_lom(lb, d.design)` | Modes and a table of values against the targets | | 8 Iterate | Rescales the R1 length until f_r is within 0.2 % | `r1.set(meander=...)` in a loop | A before/after table | | 9 FEM stage 1 | One sim group, three jobs, and the subset check | `C.export_sims`, `T.solve_or_load(...)` | Convergence table, C-matrix, eigenmodes, S21 notch, FEM-filled capacitances | | 10 FEM stage 2 | The subset values in the whole LOM | `fill(model, DESIGN, job)`, `fem_kappa` | Three LOM-versus-FEM tables (Q3D, eigenmode, driven) | | 11 Feedback | One consensus and the next revision | `loop.analyse`, `loop.feedback` | A table of proposed knobs and revision 1 (DRC clean) | | 12 Fab export | Cheese, rounding and the 3/0 keep-out | `export_fab(T.built(d), path, report=report)` | A fab layer table and the qubit's fab picture | | 13 Snapshots | The junction close up | `T.snap(...)`, `gui_snapshot` | Two junction pictures | | 14 Summary | A table of the whole run | | | The header cells also explain the loop (design, DRC, LOM, FEM, feedback) and the two FEM stages and their switches. ### 1 to 4: PDK, die, pads, feedline The PDK is `quantcore_nb_sapphire_v1`: sapphire 650 µm, εr 10.25, Nb film, CPW 10/6 µm (about 50 Ω), a 100 µm pad edge, Nb/AlOx/Nb trilayer junctions with R_n 40 to 50 kΩ, and a negative-mask fab layer map. See [the PDK page](../library/pdk.md). ```{figure} ../images/tutorials/t00_die.png :width: 40% Section 2: the empty die with the PDK frame (dicing marks, alignment grids, device ID `QS1`). ``` `edge="auto"` is the 100 µm rule at work. The notebook asks for the pads at x = 1125 and x = 6375 µm and prints where the ports end up: `PAD_W.a` at 1225 µm and `PAD_E.a` at 6275 µm. The pad slides until its outer etch edge is 100 µm from the die edge. Without `edge="auto"` the DRC adds a `pad_edge` design warning. ### 5 and 6: the qubit and its readout The Xmon has a 450 µm cross. A 300 µm cross would have needed R_n of about 66 kΩ for 5.5 GHz, outside the PDK window, so the capacitance sets the frequency here and the junction is sized from it. ```{figure} ../images/tutorials/t00_qubit.png :width: 40% Section 5: the Xmon with its claw (top) and the junction at the foot of the south arm. ``` The readout length starts from the bare λ/4 for 7.0 GHz (v_ph = 0.4204 c on the PDK stack). `near=(x, y)` centres the coupler at the feedline point nearest to (x, y), so it stays put if the feedline start moves. ### 7 and 8: LOM and the first iteration `simulate(fill(model, design))` runs QuCat for the normal modes and κ, then QuTiP for the dressed values. With component estimates only: | Quantity | LOM | Target | |---|---|---| | Q1 f_q | 5.51 GHz | 5.5 GHz | | Q1 α | -182.18 MHz | | | R1 f_r | 6.2518 GHz | 7 GHz | | R1 χ | -1.1288 MHz | | | R1 κ | 0.13536 MHz | | The qubit lands on target. The resonator is 0.75 GHz low: the claw (about 80 fF at the open end) loads the λ/4. Section 8 scales the drawn length by f_r / target. It needs two steps: 4020 µm gives 6.9153 GHz, 3971 µm gives 6.9904 GHz, within 0.2 % of 7.0 GHz. ### 9 and 10: the FEM round trip `Q1R1` is the qubit and its readout with a 300 µm margin; here it is the whole chip minus the two pads. Each analysis makes its own job in `build/jobs/t00_quickstart_Q1R1_/`: | Analysis | What the box holds | Gives | |---|---|---| | `q3d_cmatrix` | The qubit and a 100 µm stub of R1 (cut at the claw) | The C-matrix: island, claw, C_g | | `eigenmode_epr` | The qubit, R1, and the feedline cut into two 50 Ω ports | Modes with f, Q, p_J; pyEPR f, α, χ | | `hfss_driven` | The same box, driven | The S21 notch of R1: f0, κ_ext | The kept results (fast settings): | Job | Passes | Last Δ / target | Converged | Wall time | |---|---|---|---|---| | Q3D | 7 | 1.94 / 2.0 % | no | 41.6 s | | Eigenmode | 3 | 3.14 / 1.0 % | no | 392.8 s | | Driven | 2 | 0.0476 / 0.05 | yes | 167.3 s | The C-matrix gives C_island 101.4 fF and C_g 2.943 fF. In stage 2 the same LOM is run on three sets of values: | Quantity | LOM (estimates) | LOM on Q3D | Eigenmode + pyEPR | Driven S21 fit | |---|---|---|---|---| | Q1 f_q (GHz) | 5.511 | 5.462 (-0.9 %) | 5.157 (-6.4 %) | | | Q1 α (MHz) | -182.9 | -179.5 (+1.8 %) | -153.4 (+16.1 %) | | | R1 f_r (GHz) | 6.99 | 7.086 (+1.4 %) | 6.855 (-1.9 %) | 6.698 (-4.2 %) | | R1 χ (MHz) | -0.43 | -0.3159 (+26.5 %) | -0.1889 (+56.1 %) | | | R1 κ (MHz) | 0.1873 | 0.1978 (+5.6 %) | 0.2886 (+54.1 %) | 0.3213 (+71.5 %) | ### 11: feedback `loop.analyse` puts every result into one consensus: the C-matrix fills the circuit, the eigenmode adds the `pyepr` estimator and the driven fit fills the hanger κ. `loop.feedback` then solves for knobs that put every target inside its tolerance and writes `build/t00/revisions/rev1.json`. The proposed knobs: | Knob | Now | Proposed | |---|---|---| | `Q1.junction.Lj_nH` | 6.8719 | 6.064 | | `R1.length` | 3971.5 | 3880.7 | The predicted effect is f_q 5.1565 to 5.4999 GHz and f_r 6.8554 to 7.0 GHz. The revision passes the DRC. Nothing is re-simulated in this notebook; [tutorial 4](04-feedback-loop.md) closes that loop. ### 12 to 14: fab export ```{figure} ../images/tutorials/t00_fab.png :width: 50% Section 12: the fab view of the qubit: etch, the 3/0 keep-out, the cheese band and rounded corners. ``` `export_fab` writes only the PDK fab layers (flat), keeps the cheese the build drew (2772 holes: the PDK band of 5 µm squares around the 3/0 keep-outs) and rounds the corners. The report lists the polygons per fab layer (`M1` 2778, `M3` 2776, `JJ_STRAIGHT` 1, `JJ_BENT` 1, `MARKERS_ALIGN` 36, `MARKERS_DICING` 4, and so on). The CLI does the same: `qcc mask examples/tutorials/designs/t00_quickstart.json` (`--no-cheese`, `--no-round` switch the rules off). See [Fab](../library/fab.md). ```{figure} ../images/tutorials/t00_junction.png :width: 40% Section 13: the trilayer junction (finger overlap and spacer layers). ``` ## Pitfalls - The claw loads the resonator's open end, so the bare λ/4 length is always too long. Iterate (section 8). - The FEM tables of section 9 are fast-setting results: the eigenmode job reached 3.14 % against a 1 % target. The qubit frequency spans 5.157 to 5.511 GHz across the three methods; the feedback step works from that spread, it is not a verdict on the design. - Every kept result prints the "solved for another revision" note. That is expected (see [the index](index.md)). - A DRC warning about a dangling port right after placing a component is normal: nothing is connected yet. [Tutorial 1](01-chip12.md) applies the same steps to a nine-qubit chip.