quantcore_circuits.circuit.schema

circuit.json (schema version qcd/0.1 or later): the lumped model bound to a layout.

Nodes are conductors: ground or an island that matches FEM nets (layout.island = the C-matrix label, e.g. "Q1.island", plus aliases when several layout nets are one conductor). Branches connect two nodes; their value holds an explicit number, a component estimate and/or where it is filled from ("fem": "cmatrix", "source": "design"). HANGER is a coupled-line section between a λ/4 resonator and a feedline (κ). A branch may carry a knob linking it to a design.json parameter the optimiser may change. controls lists control lines (flux bias). Validation: a ground exists, branches reference known nodes, no node floats (every node is connected to ground through branches), and each island maps to exactly one node.

Attributes

Classes

Functions

load_circuit(source) → CircuitModel

save_circuit(model, path) → pathlib.Path

Module Contents

class quantcore_circuits.circuit.schema.BranchSpec

Bases: _M

knob: dict[str, Any] | None = None
nodes: tuple[str, str]
type: BranchType
value: dict[str, Any]
class quantcore_circuits.circuit.schema.CircuitModel

Bases: _M

islands() → dict[str, str]

FEM net label → node (aliases included).

to_json_dict() → dict
to_networkx()
unmapped_nets(labels: list[str]) → list[str]

C-matrix nets with no node (the circuit ignores them; they are usually stubs or cut-off routes).

branches: dict[str, BranchSpec]
controls: dict[str, dict[str, Any]]
design: str | None = None
estimators: list[str]
property ground: str
group: str | None = None
knobs: dict[str, tuple[float, float]]
name: str = 'circuit'
nodes: dict[str, NodeSpec]
schema_: str
targets: dict[str, TargetSpec]
truncation: dict[str, int]
class quantcore_circuits.circuit.schema.NodeSpec

Bases: _M

ground: bool = False
property island: str | None
layout: dict[str, Any]
property nets: list[str]

All FEM net labels of this conductor (main island + aliases).

class quantcore_circuits.circuit.schema.TargetSpec

Bases: _M

max: float | None = None
min: float | None = None
tol: float | None = None
value: float | None = None
quantcore_circuits.circuit.schema.load_circuit(source) → CircuitModel
quantcore_circuits.circuit.schema.save_circuit(model: CircuitModel, path) → pathlib.Path
quantcore_circuits.circuit.schema.BranchType
quantcore_circuits.circuit.schema.CIRCUIT_SCHEMA = 'qcc-circuit/0.1'