Install and environments¶
Questions about setting the project up, and about the files and programs it expects to find. The steps themselves are on Getting started.
Environments¶
How do I install it?¶
From PyPI, in a Python 3.11 or newer environment. Install the CPU build of PyTorch first (SQcircuit needs it), then the package. The current release is 0.0.2:
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install "quantcore-circuits[all]"
qcc kqc-files
qcc selftest
To pin it, use pip install "quantcore-circuits[all]==0.0.2".
qcc kqc-files fetches KQCircuits’ simulation scripts and label font once (a few seconds, from the KQCircuits release on GitHub): the kqcircuits package on PyPI does not include them, and the HFSS / Q3D / Elmer export and KQC’s chip-frame labels need them.
The KLayout plugin installs through KLayout’s package manager (Salt, package quantcore-circuits). See
Getting started.
Which environments do I need?¶
One for the library, the qcc command, the notebooks and the plugin’s calls. Building these docs is a separate matter:
the docs tools live in their own environment so they never change the tested versions. Do not install the docs
requirements into the library environment. See Building these docs.
Can I install without internet?¶
Yes. Build the wheel and an offline wheelhouse on a machine with internet (python scripts/build_wheel.py,
python scripts/build_wheelhouse.py), copy it over and install from it. This is also useful for whole-chip LOM runs on
a bigger machine. See the simulation PC page.
Do I need the build/ folder?¶
No. build/ is generated output (layouts, job folders, run state) and is git-ignored. Do not wipe it casually: kept FEM
results live there. The golden comparison tests against the legacy reference chips skip when that reference folder is
absent.
Programs¶
Which AEDT version do I need?¶
AEDT 2024 R1 (v241) or newer, only for HFSS and Q3D. The library finds it through QCC_ANSYS_EXECUTABLE, then the usual
install folders. Everything else (design, DRC, LOM, notebooks with RUN_FEM = False) runs without AEDT. See
Simulation.
Which KLayout version?¶
KLayout 0.30.5; the matching Python package klayout==0.30.5 comes with the library. If KLayout is not found, set
QCC_KLAYOUT to klayout_app.exe. See Getting started.
Which environment variables matter?¶
Variable |
Effect |
|---|---|
|
The tutorials and design notebooks run headless: they do not push to or open KLayout (default |
|
Path of |
|
KLayout’s settings folder (default |
|
The AEDT executable to use, any version |
|
Default AEDT mode: |
|
Fast solver settings for every export |
|
Feed the dashboard from a notebook or script |
|
Set before starting Jupyter on a small PC so numerical libraries do not take every core |
Why does a notebook say qcc or KLayout is missing?¶
Activate the env first (conda activate qcd), so qcc is on PATH. The plugin also looks for qcc in the qcd env
by itself. See the plugin.