quantcore_circuits.optimise =========================== .. py:module:: quantcore_circuits.optimise .. autoapi-nested-parse:: Closed-loop design feedback: tune geometry knobs in ``design.json`` until extracted parameters hit targets. Knobs are dotted paths into the design: ``"Q1.cross_length"`` (instance parameter), ``"R1.length"`` (route field), ``"R1.to.length"`` (nested route field, e.g. a hanger coupler length), ``"Q1.junction.Lj_nH"`` (an instance field). Parameter paths may go deeper (:func:`get_knob`): ``"Q2.cpl_length.1"`` (an element of a list parameter), ``"Q2.arm_length.*"`` (every element of a list, scaled together; the knob value is their mean) and ``"Q11.connection_pads.readout.pad_width"`` (a nested option, e.g. a Metal connection pad; unset options take the cell's default). Lengths with a unit (Metal ``"30um"``, ``"0.1mm"``) read as µm and are written back in their unit. Targets are ``"."``, e.g. ``"Q1.f_q_GHz"``. The evaluator maps a design to extracted parameters (``{"Q1": {"f_q_GHz": ...}}``); the default :func:`pipeline_evaluator` runs build → simulation job → solver → parse → extract. Few, expensive evaluations: 1 knob uses a bounded secant method, n knobs a finite-difference Gauss-Newton step. Attributes ---------- .. autoapisummary:: quantcore_circuits.optimise.Evaluator quantcore_circuits.optimise.INSTANCE_FIELDS Classes ------- .. autoapisummary:: quantcore_circuits.optimise.Iteration quantcore_circuits.optimise.OptimiseResult Functions --------- .. autoapisummary:: quantcore_circuits.optimise.get_knob quantcore_circuits.optimise.knob_number quantcore_circuits.optimise.knob_path quantcore_circuits.optimise.optimise quantcore_circuits.optimise.pipeline_evaluator quantcore_circuits.optimise.set_knob Module Contents --------------- .. py:class:: Iteration .. py:attribute:: design_hash :type: str .. py:attribute:: error :type: dict .. py:attribute:: knobs :type: dict .. py:attribute:: metrics :type: dict .. py:class:: OptimiseResult .. py:attribute:: converged :type: bool .. py:attribute:: design :type: quantcore_circuits.design.Design .. py:attribute:: history :type: list[Iteration] :value: [] .. py:function:: get_knob(design: quantcore_circuits.design.Design, knob: str) The value of ``knob`` (module docstring): the design's own value, else the cell default (Metal: the class's default options, and for a nested option such as ``connection_pads..