Use cases¶
Each recipe below is one thing people do with quantcore-circuits, with the steps in short and where to read more. All of
them end in the same design.json, so you can combine them.
Draw a qubit by hand in KLayout¶
For when you want to see and move the geometry yourself.
Install the plugin (plugin) and open KLayout.
Place an
Xmon, two bond pads and a readout resonator from the panel; connect them with Connect or Route handles.Run the Flow strip: Check, LOM, Simulate, Fab (flow strip).
Follow the Q1 + R1 tutorial. Pins and routing: place and route.
Script a chip in Python¶
For repeatable designs, sweeps and notebooks.
Create a
Designer, add components withadd, connect them withroute.Call
show()to build; withlive=Trueevery change is redrawn in KLayout.Call
drc()andlom(); save withsave("my_chip.json").
Start with getting started, then the Designer guide and tutorial 0.
Start from target frequencies¶
For when you know the qubit frequency, anharmonicity, readout frequency and coupling, but not the geometry.
Run
qcc synth --f-q 5.1 --alpha -220 --f-r 7.2 --g 90. It prints L_J, the total capacitance, the coupling capacitance and the lambda/4 length.Turn a circuit file into a layout with
qcc circuit layout build/<name>.circuit.json -o build/synth.json.Open the result in KLayout and refine it.
Limit: this works for one template only, an Xmon with a lambda/4 readout on one feedline. See LOM and tutorial 4.
Check a chip before it goes to fab¶
For a new or imported design.
Run the DRC:
qcc design drc DESIGN(dangling pins, overlaps, crossings, the 100 µm pad rule, die-frame keep-outs).Run the netlist check:
qcc design netlist DESIGN(declared against drawn connections: opens and shorts).Export the mask:
qcc mask DESIGN. The layer map, cheese and corner rounding come from the PDK.
Rules and layers: routing and DRC, PDK, fab export.
Simulate part of a chip and bring the numbers back¶
For when the lumped estimates are not enough and you have HFSS or Q3D (AEDT 2024 R1 or later).
Define a sim group: the instances and routes to cut out, plus a margin (the plugin’s Simulate dialog, or
Designer.sim_group).Build the job (
qcc sim build), solve it (qcc sim run), or render it into an AEDT project without solving (qcc hfss render).Read the results back (
qcc results collect). They fill the LOM, which then uses FEM values.
Details: simulation, results. No converged AEDT run has been made yet; see status.
Tune a design toward its targets¶
For when the simulated numbers miss the goals you set.
Set
targetsin the design (for examplef_q_GHzandalpha_MHzper qubit,f_GHzandg_MHzper resonator).Run
qcc analyse DESIGN JOB --feedback. The estimators vote, the consensus is compared with the targets, and a new revision is proposed.Apply it (
qcc results apply), rebuild and check again. Openqcc dashboardto follow the residuals.
Details: feedback, dashboard, tutorial 4.
Rebuild a published chip¶
For learning from a real design or starting from one.
Open the design notebooks. Each one rebuilds a chip from the literature or a design library (Qiskit Metal, KQCircuits, qpdk and others) with the Quantcore library and PDK.
Run its Setup and Design cells; the whole chip appears in KLayout or as a picture.
Change a parameter and rebuild, or continue with the LOM and FEM cells.
How the notebooks are built: notebook template.