The simulation PC¶
Some work needs a PC with 32 GB of RAM or more and AEDT 2024 R1 (v241) or newer: converged FEM solves, whole-chip eigenmodes and the big chips. The notebooks mark every such spot with a note that starts “Simulation PC (32 GB+ RAM)”. This page is the checklist to follow there, in order. The work runs through the same notebooks; only the switches change.
Set up the PC¶
Install the package from PyPI as in getting started:
pip install torch --index-url https://download.pytorch.org/whl/cpu, thenpip install "quantcore-circuits[all]", thenqcc kqc-files(KQCircuits’ simulation scripts and label font, which its PyPI package lacks). Clone the repository too: the notebooks and the tests are in it. Without internet on this PC, use the offline wheelhouse instead: on a machine with the repository and the upstream libraries runpython scripts/build_wheelhouse.py, copydist/wheelhouse/into the clone on the PC, and runscripts/install_sim_pc.ps1(Windows) orscripts/install_sim_pc.sh. The script creates the conda envqcc, installs torch, the pinned packages ofrequirements/sim-pc.txt, the wheels andquantcore-circuits[all], runsqcc selftestand, from a checkout,pytest -m "not slow". It stops at the first failure. Options: env name (-EnvName/QCC_ENV), wheelhouse folder (-Wheelhouse/WHEELHOUSE),-SkipTorch/SKIP_TORCH=1,-SkipTests/SKIP_TESTS=1. Other packages the wheels pull in still come from PyPI.Run
qcc selftestand fix what it reports before any solve.ansysedtis only reported: if it says “not found”, install AEDT or setQCC_ANSYS_EXECUTABLEto theansysedtexecutable.Check that AEDT starts (
AEDT_MODE = "batch"opens its own non-graphical process; it never touches a window you have open).Close other heavy programs. Run one AEDT job at a time.
The switches¶
Each tutorial has them in its first code cell (“The FEM part in two stages, and its switches”).
Switch |
Set to |
Meaning |
|---|---|---|
|
|
solve the exported jobs in AEDT, one after the other |
|
|
converged settings instead of the fast test settings |
|
|
solve again although a kept result of the same job exists (needed once on the current library: the kept results are stale) |
|
|
|
On a smaller PC leave RUN_FEM = False: the cells export the jobs and load kept results only.
Order of work¶
1. The tutorials¶
Each solved job’s results.json and job.json are copied to examples/tutorials/fem/<job>/. Keep that folder
after each notebook. Times are the ones measured on a 31 GB workstation at fast settings; converged runs take longer.
Notebook |
Marked before |
What to run |
Expected AEDT time |
|---|---|---|---|
|
section 9 (stage 1) |
the three jobs of Q1 + R1: Q3D, eigenmode + EPR, driven; set |
Q3D 3 min, eigenmode 20-30 min, driven about 40 min |
section 10 (stage 2) |
LOM vs FEM on the filled netlist: the calibration check |
no AEDT |
|
section 11 (feedback) |
FEM point, surrogate, revision |
no AEDT |
|
|
section 10 |
Q3D groups, |
Q3D about 3 min each; eigenmodes not yet timed (a whole-readout box timed out at 20 min on 31 GB); whole-chip eigenmode hours, over 30 GB |
section 11 |
fill the 9-qubit LOM, J on FEM values |
no AEDT |
|
the feedback cell |
feedback on every component |
no AEDT |
|
|
section 9 |
whole-chip Q3D, qubit-only eigenmodes, the readout boxes |
Q3D about 3 min; eigenmodes not yet timed (one 9.5 mm box needs over 11 GB at fast settings) |
section 10 |
the filled 12-branch netlist, circuit by circuit |
LOM over 10 min |
|
section 10 (b) |
feedback and revision |
no AEDT |
|
|
section A11 |
|
Q3D about 1 min; eigenmodes not yet timed |
section A11 (stage 2) |
fill the 17-qubit LOM one qubit group at a time; the |
no AEDT; whole chip needs the big PC |
|
Part B |
|
like A11 |
|
|
section 6 |
revision 0: |
3-5 min, 20-30 min, about 40 min |
section 7 |
LOM vs FEM table (the calibration) |
no AEDT |
|
section 8 |
FEM - LOM into the next knobs |
no AEDT |
|
section 9 |
revision 1 solved again: does the FEM land on target? |
as section 6 |
|
section 10 |
redesign for a wanted f_q1, solve, compare |
as section 6 |
Two jobs of tutorial 3 need a fix before they give real values: the StarQubit pin ports on the 45 degree lattice (the coupler and readout pads come out as ground, so the LOM keeps the component estimates).
2. Converged runs for tutorials 0 and 4¶
Set FEM_FAST = False in tutorials 0 and 4. This is the first converged eigenmode + EPR and driven run; so far every
eigenmode stopped after at most 3 passes. Check the convergence table (ΔF below 1 %) before you keep the result.
3. The design notebooks¶
Each of the 74 v2 design notebooks under examples/designs/ has one marker before its # Simulate section. Work
through them group by group, one notebook at a time, with RUN_FEM = True and FEM_FAST = False.
Group |
Notebooks |
Big chips (do last, or give a subset) |
|---|---|---|
|
19 |
|
|
21 |
test chips; most have no qubit |
|
6 |
|
|
4 |
|
|
1 |
|
|
5 |
|
|
6 |
|
|
2 |
|
|
2 |
|
|
2 |
|
For a big chip solve the sim-group subsets, not the whole chip, unless the machine has the memory. Keep each notebook’s
fem/ folder.
4. Library work that follows the FEM results¶
These need the kept results above. They are code work, done after the solves.
Calibrate the LOM against FEM: hanger κ per kind, TransmonCross claws, claw-to-ground C, χ.
Close the FEM feedback loop on target (tutorial 4) and document how many FEM iterations it takes.
Surrogates from FEM sweeps (levels M11 and M12).
Flip-chip two-face FEM export, Q3D nets above 8000 points (unite pieces in AEDT after import), and the whole-chip LOM of the big chips.
Future development goals¶
Solving with Palace, Elmer and Sonnet is not part of this checklist. Only their input files are written today; see the status page.