quantcore_circuits.cli¶
qcc command line.
Attributes¶
Functions¶
|
Job results → circuit.json → Metal LOM / QuCat / SQcircuit / scqubits / QuTiP → consensus vs targets. |
|
Build DESIGN (.json/.py) into a KQC chip and write it. |
|
Layout → LOM netlist: components' lumped models joined along routes/snaps (values = component estimates). |
|
LOM -> layout: transmon + lambda/4 pairs with targets -> knobs -> a laid-out feedline chip. |
|
LOM simulation: QuCat normal modes + kappa, QuTiP dressed spectrum -> f_q, alpha, f_r, chi, kappa. |
|
List available components (Quantcore, KQC, Quantum Metal) by category, or the ports of one. |
|
Live dashboard that follows the notebooks' tracked runs ( |
|
Connectivity DRC: dangling ports, components without LOM, outside chip, overlaps, crossings, opens/shorts. |
|
|
|
Each junction as the LOM and the eigenmode / driven exports take it: L_J0, C_J, flux Φ/Φ0, asymmetry d, L at |
|
M3 netlist check: declared connections vs. the KQC geometric netlist (opens/shorts with coordinates). |
|
JSON of the junction values a new CELL gets when placed ( |
|
All resolved ports of a design (absolute positions), e.g. for the KLayout plugin's connect dialog. |
|
Write a readable Python script (the Designer API) that rebuilds DESIGN: the GUI prototype continues as code. |
|
|
|
Read JOB's rendered .aedt back: stack, metal sheets, ports / terminations, nets and every solver setting. |
|
Re-export a solved job from its saved project as it is now (no solve), e.g. after you changed the setup in AEDT |
|
Render DESIGN (whole chip or a sim group) into an AEDT project: geometry, stack, ports, Lj boundaries. |
|
Solve an exported Ansys JOB directory (new batch AEDT, a new window or the open AEDT) and collect results. |
|
Fetch the KQCircuits files its PyPI package lacks: the simulation scripts and the label font. |
|
Quantcore circuits CLI. |
|
Fab export with the PDK fab rules: layers 1/0–4/0, 50–53/0, 100/0, 300/301, 700, 800+, 1000/0+; --positive M1 |
|
DESIGN with the proposal's knobs set (refuses when the design changed since the proposal). |
|
Parse solver outputs in JOB into results/results.json. |
|
Extract Hamiltonian parameters from JOB results and compare with design targets. |
|
Read solved results back (a job folder, its results/ folder or a results.json: format in qcc results template --format), check them against the design and analyse them (the KLayout Results tab shows the outcome). |
|
Propose the next design revision (loop.feedback: every qubit with a LOM model and a lambda/4 or lambda/2 |
|
|
|
A results.json skeleton with this design's net names (with --format: the format description). |
|
Open the live dashboard for DESIGN: steps, goal, plots, circuit, Hamiltonian, jobs, screenshots. |
|
Process the filesystem queue (run on the lab server). |
|
|
|
Check this install: imports of every extra, a Q1 + R1 chip (build, DRC, LOM, job export), ansysedt lookup. |
|
Automatic simulation: subset -> export -> solve in a NEW AEDT (never the one you have open) -> analyse. Fills |
|
Create a simulation job directory for a sim group. |
|
Print as JSON what qcc sim subset would render (no file is written): the box, the components and routes in it |
|
Run a job locally (AEDT / Elmer / Palace) and collect results. |
|
|
|
Export the job folder of a subset (no solve): geometry, AEDT scripts, job.json, README.md (what to run and |
|
LOM-first synthesis: targets → Lj, C_Σ, Cg, λ/4 length. |
|
Rebuild on every save and reload KLayout (klive). |
Module Contents¶
- quantcore_circuits.cli.analyse(design: pathlib.Path, job: pathlib.Path, group: str = typer.Option(None, '--group', '-g', help="Sim group (default: the job's)"), run_dir: pathlib.Path = typer.Option(None, help='Dashboard run directory (default build/<design name>)'), readout: bool = typer.Option(True, help='Simulate the readout (χ from transmission) with QuTiP'), propose: bool = typer.Option(False, '--feedback', help='Also propose the next design revision (surrogate)'))¶
Job results → circuit.json → Metal LOM / QuCat / SQcircuit / scqubits / QuTiP → consensus vs targets.
- quantcore_circuits.cli.build(design: pathlib.Path, out: pathlib.Path = typer.Option(None, '-o', help='Output .oas/.gds (default build/<name>.oas)'), show: bool = typer.Option(False, help='Send to KLayout via klive'), keep_going: bool = typer.Option(False, '--keep-going', help="A route that cannot be built is left out (named in the sidecar's failed_routes, its last good route kept in <name>.last_good_routes.json) instead of failing the build. The default is strict."), label_height: float = typer.Option(None, '--label-height', help=LABEL_HEIGHT_HELP))¶
Build DESIGN (.json/.py) into a KQC chip and write it.
- quantcore_circuits.cli.circuit_export(design: pathlib.Path, group: str = typer.Option('chip', '--group', '-g', help="'chip' (all) or a sim_groups name"), out: pathlib.Path = typer.Option(None, '-o', help='Output circuit.json (default build/<name>.circuit.json)'))¶
Layout → LOM netlist: components’ lumped models joined along routes/snaps (values = component estimates).
- quantcore_circuits.cli.circuit_layout(circuit: pathlib.Path, out: pathlib.Path = typer.Option(..., '-o', help='Output design.json'), live: bool = typer.Option(False, help='Lay it out live in KLayout'))¶
LOM -> layout: transmon + lambda/4 pairs with targets -> knobs -> a laid-out feedline chip.
- quantcore_circuits.cli.circuit_simulate(source: pathlib.Path = typer.Argument(..., help='circuit.json, or a design (its layout LOM is used)'), job: pathlib.Path = typer.Option(None, help='Fill capacitances from this simulation job (design input only)'), group: str = typer.Option('chip', '--group', '-g'), json_out: pathlib.Path = typer.Option(None, '--json', help='Also write the result (modes, params, netlist values) as JSON'), png: pathlib.Path = typer.Option(None, '--png', help='Also draw the circuit schematic (matplotlib) to this PNG'))¶
LOM simulation: QuCat normal modes + kappa, QuTiP dressed spectrum -> f_q, alpha, f_r, chi, kappa.
- quantcore_circuits.cli.components(cell: str = typer.Argument(None, help='Show ports of this cell (name, dotted path or metal:<Class>)'), category: str = typer.Option(None, '--category', '-c', help='Only this category (qubit, coupler, launcher, ...)'), source: str = typer.Option(None, '--source', '-s', help='Only this source: quantcore, kqc or metal'), as_json: bool = typer.Option(False, '--json', help='Machine-readable: refs (or ports with CELL)'), details: bool = typer.Option(False, '--details', help='With --json: full catalog records instead of refs'), show_all: bool = typer.Option(False, '--all', help='Include whole KQC chips and Metal routes (not cells)'), outline: bool = typer.Option(False, '--outline', help='With CELL --json: also its bbox and a simplified outline (the KLayout placement ghost)'), params: str = typer.Option('{}', '--params', help='With CELL: PCell parameters as JSON'), schema: bool = typer.Option(False, '--schema', help='With CELL: its editable parameters and defaults (JSON)'), schemas: bool = typer.Option(False, '--schemas', help="Every listed cell's editable parameters in one JSON (the KLayout PCell library)"), oas: pathlib.Path = typer.Option(None, '--oas', help='With CELL: write its geometry (a static cell) to this OASIS file'), design: pathlib.Path = typer.Option(None, '--design', help='With CELL --oas: build it as in this design (chip-inherited parameters, PDK junction)'))¶
List available components (Quantcore, KQC, Quantum Metal) by category, or the ports of one.
- quantcore_circuits.cli.dashboard(run: str = typer.Argument(None, help='Run name (build/<run>); default: follow the run with the latest activity'), port: int = 8765, open_browser: bool = True, root: pathlib.Path = typer.Option(None, help='Folder with the run directories (default: <repo>/build)'))¶
Live dashboard that follows the notebooks’ tracked runs (
track.start(...)/QCC_TRACK=1).
- quantcore_circuits.cli.design_drc(design: pathlib.Path, netlist: bool = typer.Option(True, help='Also run the KQC netlist check'), keep_going: bool = typer.Option(False, '--keep-going', help='Report a route that cannot be built (route_failed) and check the rest, instead of stopping at it'))¶
Connectivity DRC: dangling ports, components without LOM, outside chip, overlaps, crossings, opens/shorts.
- quantcore_circuits.cli.design_hash_cmd(design: pathlib.Path)¶
- quantcore_circuits.cli.design_junctions(design: pathlib.Path, names: list[str] = typer.Argument(None, help='Only these instances (default: every component with a junction)'), as_json: bool = typer.Option(False, '--json'), default: bool = typer.Option(False, '--default', help='No names: the qubits of the default simulation subset'))¶
Each junction as the LOM and the eigenmode / driven exports take it: L_J0, C_J, flux Φ/Φ0, asymmetry d, L at that flux and the source (design or drawn trilayer junction, PDK rule). Exit 1 when one has no L_J.
- quantcore_circuits.cli.design_netlist(design: pathlib.Path)¶
M3 netlist check: declared connections vs. the KQC geometric netlist (opens/shorts with coordinates).
- quantcore_circuits.cli.design_placement_junction(cell: str, params: str = typer.Option('{}', '--params', help='Cell parameters as JSON'))¶
JSON of the junction values a new CELL gets when placed (
{"Lj_nH", "Cj_fF", "source"}: the drawn trilayer junction’s PDK value, else the PDK nominal SQUID), ornullfor a component without a junction.
- quantcore_circuits.cli.design_ports(design: pathlib.Path, as_json: bool = typer.Option(False, '--json'))¶
All resolved ports of a design (absolute positions), e.g. for the KLayout plugin’s connect dialog.
- quantcore_circuits.cli.design_to_python_cmd(design: pathlib.Path, out: pathlib.Path = typer.Option(None, '-o', help='Output script (default: <design name>.py next to the design)'), check: bool = typer.Option(True, help='Run the script here and require the same design hash (default on)'))¶
Write a readable Python script (the Designer API) that rebuilds DESIGN: the GUI prototype continues as code.
The script writes the design.json again (
python design.py); the round trip is checked (sameqcc design hash). Entries the Designer calls cannot say are written as plain data with a comment.
- quantcore_circuits.cli.design_validate(design: pathlib.Path)¶
- quantcore_circuits.cli.hfss_check(job: pathlib.Path)¶
Read JOB’s rendered .aedt back: stack, metal sheets, ports / terminations, nets and every solver setting.
- quantcore_circuits.cli.hfss_collect(job: pathlib.Path, aedt: str = typer.Option('batch', '--aedt', help='batch (a new non-graphical AEDT, default) | gui (a new window)'))¶
Re-export a solved job from its saved project as it is now (no solve), e.g. after you changed the setup in AEDT and solved there; then
qcc results import DESIGN JOB. Close the project in your own AEDT first, or runscripts/qcc_collect.pyin that AEDT (Tools > Run Script) instead.
- quantcore_circuits.cli.hfss_render(design: pathlib.Path, group: str = typer.Option('chip', '--group', '-g', help="'chip' (whole chip) or a sim_groups name"), analysis: str = typer.Option('eigenmode_epr', '--analysis', '-a', help='eigenmode_epr (default) | hfss_eigenmode | q3d_cmatrix | hfss_driven'), out: pathlib.Path = typer.Option(None, '-o', help='Job directory (default build/jobs/<sim name>)'), solve: bool = typer.Option(False, help='Also solve (qcc_solve.py in a new non-graphical AEDT) and collect results'), settings: list[str] = typer.Option(None, '--set', help='Solver setting key=value (JSON value), repeatable, e.g. --set percent_error=1 --set mesh_size={"1t1_gap":10}'), airbridges: bool = typer.Option(None, '--airbridges/--no-airbridges', help="Keep airbridges in the simulated geometry (default: the group's setting, else dropped)"), timeout: float = typer.Option(None, help='Seconds before qcc kills the AEDT process tree it started'), open_gui: bool = typer.Option(False, '--open', help='Open the rendered project in a new AEDT GUI'), graphical: bool = typer.Option(False, help='Run the render with the AEDT window instead of -ng'), aedt: str = typer.Option(None, '--aedt', help='batch (new -ng AEDT, default) | gui (new AEDT window, left open) | attach (the open AEDT)'), show: bool = typer.Option(False, help='Also send the chip to KLayout via klive'), dry_run: bool = typer.Option(False, help='Export the job and print the AEDT command only'))¶
Render DESIGN (whole chip or a sim group) into an AEDT project: geometry, stack, ports, Lj boundaries.
- quantcore_circuits.cli.hfss_solve(job: pathlib.Path, timeout: float = typer.Option(None, help='Seconds before qcc kills the AEDT process tree it started'), graphical: bool = typer.Option(False, help='Run with the AEDT window instead of -ng'), aedt: str = typer.Option(None, '--aedt', help='batch (new -ng AEDT, default) | gui (new AEDT window, left open) | attach (the open AEDT)'))¶
Solve an exported Ansys JOB directory (new batch AEDT, a new window or the open AEDT) and collect results.
- quantcore_circuits.cli.kqc_files(version: str = typer.Option(None, '--version', help='kqcircuits version (default: the installed one).'), source: pathlib.Path = typer.Option(None, '--source', help='A KQCircuits checkout or a source zip, instead of the download.'), force: bool = typer.Option(False, '--force', help='Fetch again even when the cache has them.'))¶
Fetch the KQCircuits files its PyPI package lacks: the simulation scripts and the label font.
Downloads them for the installed kqcircuits release from github.com/iqm-finland/KQCircuits into the user cache (the HFSS / Q3D / Elmer export and KQC’s chip-frame labels need them). Nothing to do for a KQCircuits checkout.
- quantcore_circuits.cli.main(version: bool = typer.Option(False, '--version', callback=_version, is_eager=True, help='Show version.'))¶
Quantcore circuits CLI.
- quantcore_circuits.cli.mask(design: pathlib.Path, out: pathlib.Path = typer.Option(None, '-o'), positive: list[str] = typer.Option(None), cheese: bool = typer.Option(True, help="Cheese: the build's (PDK band or the original design's own); --no-cheese writes none"), round_corners: bool = typer.Option(True, '--round/--no-round', help='PDK corner rounding (r ∝ shortest dim.)'), grid: bool = typer.Option(False, help="KQC's whole-area ground grid (with_grid) instead of the PDK band"))¶
Fab export with the PDK fab rules: layers 1/0–4/0, 50–53/0, 100/0, 300/301, 700, 800+, 1000/0+; –positive M1 inverts a layer. Corner rounding is on by default; the cheese is the build’s own (the PDK band unless the design has its own cheese, which wins). Simulation exports never get either.
- quantcore_circuits.cli.results_apply_cmd(design: pathlib.Path, proposal: pathlib.Path = typer.Argument(..., help='proposal.json from `qcc results propose -o`'), out: pathlib.Path = typer.Option(None, '-o', help='Write the new design here (default: overwrite DESIGN)'))¶
DESIGN with the proposal’s knobs set (refuses when the design changed since the proposal).
- quantcore_circuits.cli.results_collect(job: pathlib.Path)¶
Parse solver outputs in JOB into results/results.json.
- quantcore_circuits.cli.results_extract(design: pathlib.Path, job: pathlib.Path, store: pathlib.Path = typer.Option(None, help='Results store (sqlite)'))¶
Extract Hamiltonian parameters from JOB results and compare with design targets.
- quantcore_circuits.cli.results_import_cmd(design: pathlib.Path, sources: list[pathlib.Path] = typer.Argument(..., help='Solved job folder(s) or results.json file(s)'), group: str = typer.Option(None, '--group', '-g', help='Sim group the results belong to (default: from the job)'))¶
Read solved results back (a job folder, its results/ folder or a results.json: format in qcc results template –format), check them against the design and analyse them (the KLayout Results tab shows the outcome).
- quantcore_circuits.cli.results_propose_cmd(design: pathlib.Path, job: list[pathlib.Path] = typer.Option(None, '--job', help="Job folder(s) to analyse (default: the last run's, else the layout estimates)"), out: pathlib.Path = typer.Option(None, '-o', help='Write the proposal (JSON) here'))¶
Propose the next design revision (loop.feedback: every qubit with a LOM model and a lambda/4 or lambda/2 readout) as old -> new knob values; nothing is written to the design.
qcc results applysets them.
- quantcore_circuits.cli.results_show(design: pathlib.Path, store: pathlib.Path = typer.Option(Path('results.sqlite')))¶
- quantcore_circuits.cli.results_template_cmd(design: pathlib.Path, out: pathlib.Path = typer.Option(None, '-o', help='Write the skeleton here (default: print it)'), group: str = typer.Option('chip', '--group', '-g'), analysis: str = typer.Option('q3d_cmatrix', '--analysis', '-a'), show_format: bool = typer.Option(False, '--format', help='Print the results.json format description instead'))¶
A results.json skeleton with this design’s net names (with –format: the format description).
- quantcore_circuits.cli.review(design: pathlib.Path, port: int = 8765, open_browser: bool = True, run_dir: pathlib.Path = typer.Option(None, help='Run directory (default build/<design name>)'))¶
Open the live dashboard for DESIGN: steps, goal, plots, circuit, Hamiltonian, jobs, screenshots.
- quantcore_circuits.cli.runner_serve(queue: pathlib.Path, poll: float = 5.0, once: bool = False)¶
Process the filesystem queue (run on the lab server).
- quantcore_circuits.cli.runner_status(queue: pathlib.Path)¶
- quantcore_circuits.cli.selftest(allow_missing: bool = typer.Option(False, '--allow-missing', help='A missing extra (analysis, sim, notebook) is skipped instead of failing.'), as_json: bool = typer.Option(False, '--json', help='Print the checks as JSON.'))¶
Check this install: imports of every extra, a Q1 + R1 chip (build, DRC, LOM, job export), ansysedt lookup.
- quantcore_circuits.cli.sim_auto_cmd(design: pathlib.Path, instances: str = typer.Option('', '--instances', '-i', help='Qubits and/or readout routes, comma separated'), default: bool = typer.Option(False, '--default', help='No --instances: the first qubit with its readout'), whole: bool = typer.Option(False, '--whole', help='The whole chip (slow, memory hungry)'), analysis: str = typer.Option('q3d_cmatrix', '--analysis', '-a'), aedt: str = typer.Option('batch', '--aedt', help='batch (a new non-graphical AEDT, default) | gui (a new window)'), fast: bool = typer.Option(True, '--fast/--full', help='Fast solver settings (default)'), margin: float = typer.Option(300.0, help='Margin (um) around the selection'), name: str = typer.Option('gui_sim', help='Name of the sim group(s) written into the design'), timeout: float = typer.Option(3600.0, help='Seconds per solve before qcc stops the AEDT it started'), status: pathlib.Path = typer.Option(None, help='Status file (JSON) the KLayout plugin polls'), set_: list[str] = typer.Option(None, '--set', help='Solver setting key=value, repeatable (with --full: on top of the analysis defaults), e.g. --set maximum_passes=12 --set percent_error=1'))¶
Automatic simulation: subset -> export -> solve in a NEW AEDT (never the one you have open) -> analyse. Fills the LOM of the simulated components;
qcc analyse/ the KLayout Results tab show it against the targets.
- quantcore_circuits.cli.sim_build(design: pathlib.Path, group: str = typer.Option(..., '--group', '-g'), analysis: str = typer.Option(..., '--analysis', '-a', help='q3d_cmatrix | hfss_eigenmode | eigenmode_epr | elmer_cap | palace_cap | palace_eig'), out: pathlib.Path = typer.Option(None, '-o', help='Job directory'), overwrite: bool = False)¶
Create a simulation job directory for a sim group.
- quantcore_circuits.cli.sim_preview_cmd(design: pathlib.Path, instances: str = typer.Option('', '--instances', '-i', help='Components, as for `qcc sim subset`'), default: bool = typer.Option(False, '--default', help='No --instances: the first qubit with its readout'), whole: bool = typer.Option(False, '--whole', help='The whole chip'), group: str = typer.Option(None, '--group', '-g', help='A saved sim_groups entry, as it is'), analysis: str = typer.Option(None, '--analysis', '-a', help="Default q3d_cmatrix; with --group the group's first"), margin: float = typer.Option(300.0, help='Margin (um) around the selection'), name: str = typer.Option('gui_sim', help='Name of the sim group(s) the export would write'))¶
Print as JSON what qcc sim subset would render (no file is written): the box, the components and routes in it and every port (50 ohm edge ports, cut stubs, junction ports) with its position. The KLayout plugin draws it.
- quantcore_circuits.cli.sim_run(job: pathlib.Path, dry_run: bool = typer.Option(False, help='Only print the command'))¶
Run a job locally (AEDT / Elmer / Palace) and collect results.
- quantcore_circuits.cli.sim_submit(job: pathlib.Path, queue: pathlib.Path = typer.Option(..., help='Queue directory'))¶
- quantcore_circuits.cli.sim_subset_cmd(design: pathlib.Path, instances: str = typer.Option('', '--instances', '-i', help="Components to simulate, comma separated. q3d_cmatrix: qubits and/or their readout routes (Q1,R1), resonators cut to a stub port; eigenmode / driven: exactly these components (plus the routes joining them and the pads at a selected line's ends), lines leaving the box end in 50 ohm"), default: bool = typer.Option(False, '--default', help='No --instances: the first qubit with its readout'), whole: bool = typer.Option(False, '--whole', help='The whole chip (slow, memory hungry)'), out: pathlib.Path = typer.Option(None, '-o', help='Job folder (one box) or the folder that holds one job per box'), analysis: str = typer.Option('q3d_cmatrix', '--analysis', '-a', help='q3d_cmatrix (cheap, fills the LOM) | eigenmode_epr | hfss_eigenmode | hfss_driven'), fast: bool = typer.Option(True, '--fast/--full', help='Fast solver settings (default) or the analysis defaults'), margin: float = typer.Option(300.0, help='Margin (um) around the selection'), name: str = typer.Option('gui_sim', help='Name of the sim group(s) written into the design'), write_group: bool = typer.Option(True, '--write-group/--no-write-group', help='Store the sim group in the design'), group: str = typer.Option(None, '--group', '-g', help='Export a saved sim_groups entry as it is (writes nothing)'), set_: list[str] = typer.Option(None, '--set', help='Solver setting key=value, repeatable (with --full: on top of the analysis defaults), e.g. --set maximum_passes=12 --set percent_error=1'))¶
Export the job folder of a subset (no solve): geometry, AEDT scripts, job.json, README.md (what to run and what to bring back) and results_template.json. Solve it by hand or elsewhere; read it back with
qcc results import.
- quantcore_circuits.cli.synth(f_q: float = typer.Option(..., help='Qubit f01 [GHz]'), alpha: float = typer.Option(..., help='α [MHz]'), f_r: float = typer.Option(..., help='Resonator [GHz]'), g: float = typer.Option(..., help='g [MHz]'), a: float = 10.0, b: float = 6.0)¶
LOM-first synthesis: targets → Lj, C_Σ, Cg, λ/4 length.
- quantcore_circuits.cli.watch(design: pathlib.Path, out: pathlib.Path = typer.Option(None, '-o'), klive: bool = typer.Option(True, help='Use klive'), extra: list[pathlib.Path] = typer.Option(None, help='More files to watch (e.g. imported modules)'), label_height: float = typer.Option(None, '--label-height', help=LABEL_HEIGHT_HELP))¶
Rebuild on every save and reload KLayout (klive).
- quantcore_circuits.cli.LABEL_HEIGHT_HELP = "Height of the instance name labels in µm (capital letters; 0 = none). Default: KQC's 280. An...¶
- quantcore_circuits.cli.app¶
- quantcore_circuits.cli.circuit_app¶
- quantcore_circuits.cli.design_app¶
- quantcore_circuits.cli.hfss_app¶
- quantcore_circuits.cli.results_app¶
- quantcore_circuits.cli.runner_app¶
- quantcore_circuits.cli.sim_app¶