boulder-opal-scale-up-sdk 1.0.6__py3-none-any.whl → 1.0.8__py3-none-any.whl

boulderopalscaleupsdk/device/processor/superconducting_processor.py

@@ -142,6 +142,14 @@ class Coupler(Component[Literal["tunable"]]):
         default=ComponentParameter(value=0.0),
         json_schema_extra={"display": {"label": "bias_period", "unit": "V", "scale": 1}},
     )
+    freq_01: FloatComponentParameter = Field(
+        default=ComponentParameter(value=(0.0)),
+        json_schema_extra={"display": {"label": "freq_01", "unit": "MHz", "scale": 1e-6}},
+    )
+    anharm: FloatComponentParameter = Field(
+        default=ComponentParameter(value=0.0),
+        json_schema_extra={"display": {"label": "anharm", "unit": "MHz", "scale": 1e-6}},
+    )
 
 
 class Port(Component[Literal["drive", "readout", "flux"]]):
@@ -151,10 +159,19 @@ class Port(Component[Literal["drive", "readout", "flux"]]):
     )
 
 
+# TODO: [SCUP-2169] Rename Filter to PurcellFilter
 class Filter(Component[Literal["filter"]]):
     dtype: Literal["filter"] = "filter"
     traits: list = Field(default=[])
 
+    # TODO: [SCUP-2167] Move resonator filter parameters to Filter/PurcellFilter class
+    # TODO: Use better name for this field. "Center Frequency"?
+    # TODO: Handle the same rename in the SDK
+    frequency: FloatComponentParameter = Field(
+        default=ComponentParameter(value=0.0),
+        json_schema_extra={"display": {"label": "frequency", "unit": "MHz", "scale": 1}},
+    )
+
 
 class Feedline(Component[Literal["feedline"]]):
     dtype: Literal["feedline"] = "feedline"
@@ -201,6 +218,7 @@ class ProcessorTemplate(BaseModel):
 
 
 class SuperconductingProcessorTemplate(BaseModel):
+    qpu_model: str
     build: list[TemplateParam]
     templates: dict[str, ProcessorTemplate]
     device_parameters: dict[str, SuperconductingComponentType] = Field(
@@ -209,12 +227,14 @@ class SuperconductingProcessorTemplate(BaseModel):
 
 
 class SuperconductingProcessor(BaseModel):
+    # TODO: Fast5, remove default after SCUP-2205
+    qpu_model: str = Field(default="quantware-soprano-a")
     nodes: dict[ComponentRef, SuperconductingComponentType]
     edges: list[Edge]
 
     @staticmethod
     def from_template(template: SuperconductingProcessorTemplate) -> "SuperconductingProcessor":
-        _qpu = SuperconductingProcessor(nodes={}, edges=[])
+        _qpu = SuperconductingProcessor(qpu_model=template.qpu_model, nodes={}, edges=[])
         for build in template.build:
             qpu_template = template.templates[build.template]
             for idx, subs in build.vars.items():

boulderopalscaleupsdk/experiments/chi01_scan.py

@@ -45,7 +45,7 @@ class Chi01Scan(Experiment):
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/cz_spectroscopy_by_bias.py

@@ -15,70 +15,51 @@ from typing import Literal
 
 from pydantic import PrivateAttr
 
-from .common import Experiment
-
-DEFAULT_PREP_PADDING_NS = 16
-DEFAULT_MEASUREMENT_PADDING_NS = 16
-DEFAULT_MIN_DURATION_NS = 16
-DEFAULT_MAX_DURATION_NS = 200
-DEFAULT_TIME_STEP_NS = 8
-DEFAULT_RECYCLE_DELAY_NS = 500_000
-DEFAULT_SHOT_COUNT = 200
+from .common import Experiment, LinspaceIterable, RangeIterable
 
 
 class CZSpectroscopyByBias(Experiment):
     """
-    Parameters for running a Ramsey experiment.
+    Parameters for running a CZ spectroscopy by bias experiment.
 
-    Parameters
+    Attributes
     ----------
     control_transmon : str
-        The control transmon to target in the experiment.
+        The reference for the transmon to use as control.
     target_transmon : str
-        The target transmon to pair with the control transmon.
-    min_vp : float
-        The minimum voltage point, in volts.
-    max_vp : float
-        The maximum voltage point, in volts.
-    num_vp : int
-        The number of voltage points to sample.
-    min_duration_ns : int
-        The minimum duration for the pulse in the experiment, in nanoseconds.
-    max_duration_ns : int
-        The maximum duration for the pulse in the experiment, in nanoseconds.
-    duration_step_ns : int
-        The step size for the duration, in nanoseconds.
-    prep_padding_ns : int
+        The reference for the transmon to use as target.
+    vps : LinspaceIterable
+        The voltage points to sample, in volts.
+    coupler_flux_vp : float
+        The flux voltage point for the coupler, in volts.
+    durations_ns : RangeIterable, optional
+        The pulse durations to sample, in nanoseconds.
+        Defaults to RangeIterable(start=16, stop=200, step=8).
+    prep_padding_ns : int, optional
         The padding to apply before the CZ pulse, in nanoseconds.
-    measurement_padding_ns : int
+        Defaults to 16 ns.
+    measurement_padding_ns : int, optional
         The padding to apply after the CZ pulse, in nanoseconds.
-    recycle_delay_ns : float
-        The delay time between consecutive shots of the experiment, in nanoseconds.
-        Defaults to 500000 ns.
-    shot_count : int,
-        The number of shots to be taken in the experiment.
+        Defaults to 16 ns.
+    recycle_delay_ns : float, optional
+        The delay between consecutive shots, in nanoseconds.
+        Defaults to 500,000 ns.
+    shot_count : int, optional
+        The number of shots to take.
         Defaults to 200.
-    batch_analysis : bool
-        Whether to perform batch analysis on the results.
-    spectroscopy_waveform : ConstantWaveform
-        The waveform to use in the spectroscopy pulse.
+    update : "auto" or "off" or "prompt", optional
+        How the device should be updated after an experiment run. Defaults to auto.
     """
 
     _experiment_name: str = PrivateAttr("cz_spectroscopy_by_bias")
 
     control_transmon: str
     target_transmon: str
-    coupler: str
-    min_vp: float
-    max_vp: float
-    num_vp: int
+    vps: LinspaceIterable
     coupler_flux_vp: float
-    min_duration_ns: int = DEFAULT_MIN_DURATION_NS
-    max_duration_ns: int = DEFAULT_MAX_DURATION_NS
-    duration_step_ns: int = DEFAULT_TIME_STEP_NS
-    prep_padding_ns: int = DEFAULT_PREP_PADDING_NS
-    measurement_padding_ns: int = DEFAULT_MEASUREMENT_PADDING_NS
-    recycle_delay_ns: int = DEFAULT_RECYCLE_DELAY_NS
-    shot_count: int = DEFAULT_SHOT_COUNT
-    batch_analysis: bool = False
+    durations_ns: RangeIterable = RangeIterable(start=16, stop=200, step=8)
+    prep_padding_ns: int = 16
+    measurement_padding_ns: int = 16
+    recycle_delay_ns: int = 500_000
+    shot_count: int = 200
     update: Literal["auto", "off", "prompt"] = "auto"

boulderopalscaleupsdk/experiments/drag_leakage_calibration.py

@@ -27,7 +27,7 @@ class DragLeakageCalibration(Experiment):
     ----------
     transmon : str
         The reference for the transmon to target.
-    recycle_delay_ns : int
+    recycle_delay_ns : int, optional
         The delay between consecutive shots, in nanoseconds. Defaults to 10,000 ns.
     shot_count : int, optional
         The number of shots to take. Defaults to 1,000.
@@ -40,8 +40,6 @@ class DragLeakageCalibration(Experiment):
     anharmonicity : float or None, optional
         The anharmonicity of the transmon, in Hz.
         Defaults to None, in which case the anharmonicity of the transmon will be used.
-    drag_guess : float
-        Initial guess for the DRAG parameter.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.
     """
@@ -55,7 +53,6 @@ class DragLeakageCalibration(Experiment):
     repetitions: list[int]
     gate: Literal["x", "sx"]
     anharmonicity: float | None = None
-    drag_guess: float
     update: Literal["auto", "off", "prompt"] = "auto"
 
     @field_validator("alphas")

boulderopalscaleupsdk/experiments/fine_amplitude_calibration.py

@@ -30,12 +30,13 @@ class FineAmplitudeCalibration(Experiment):
         The reference for the transmon to target.
     gate : Literal["sx", "x"]
         The gate to be calibrated.
-    repetitions : list[int]
+    repetitions : list[int], optional
         List of repetition counts for the calibration experiment.
-    recycle_delay_ns : int
+        Defaults to every fourth number from 0 to 100.
+    recycle_delay_ns : int, optional
         The delay between consecutive shots, in nanoseconds. Defaults to 10,000 ns.
     shot_count : int, optional
-        The number of shots to take. Defaults to 1000.
+        The number of shots to take. Defaults to 1,000.
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.

boulderopalscaleupsdk/experiments/power_rabi.py

@@ -39,16 +39,16 @@ class PowerRabi(Experiment):
         If None, a default scan will be used.
     drive_waveform : Waveform
         The waveform to use for the drive pulse.
-    recycle_delay_ns : int
+    recycle_delay_ns : int, optional
         The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
         The number of shots to take. Defaults to 400.
     pulse_vp : float, optional
-        The voltage per pulse, in Volts. Defaults to the amplitude of the X gate.
+        The voltage per pulse, in volts. Defaults to the amplitude of the X gate.
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/power_rabi_ef.py

@@ -39,16 +39,16 @@ class PowerRabiEF(Experiment):
         If None, a default scan will be used.
     drive_waveform : Waveform
         The waveform to use for the drive pulse.
-    recycle_delay_ns : int
+    recycle_delay_ns : int, optional
         The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
         The number of shots to take. Defaults to 400.
     pulse_vp : float, optional
-        The voltage per pulse, in Volts. Defaults to the amplitude of the X gate.
+        The voltage per pulse, in volts. Defaults to the amplitude of the X gate.
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/ramsey.py

@@ -42,7 +42,7 @@ class Ramsey(Experiment):
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/ramsey_ef.py

@@ -21,7 +21,7 @@ from .waveforms import ConstantWaveform
 
 class RamseyEF(Experiment):
     """
-    Parameters for running a EF Ramsey experiment.
+    Parameters for running an EF Ramsey experiment.
 
     Attributes
     ----------

boulderopalscaleupsdk/experiments/readout_classifier.py

@@ -31,14 +31,14 @@ class ReadoutClassifier(Experiment):
     ----------
     transmon : str
         The reference for the transmon to target.
-    recycle_delay_ns : int
+    recycle_delay_ns : int, optional
         The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
         The number of shots to take. Defaults to 5,000.
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/readout_optimization.py

@@ -28,7 +28,7 @@ class ReadoutOptimization(Experiment):
     """
     Parameters for optimizing the readout classifier.
 
-    Parameters
+    Attributes
     ----------
     transmon : str
         The reference for the transmon to target.
@@ -36,11 +36,11 @@ class ReadoutOptimization(Experiment):
         The readout frequencies to sweep, in Hz.
     amplitudes : list[float]
         The readout amplitudes to sweep.
-    recycle_delay_ns : int
+    recycle_delay_ns : int, optional
         The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
         The number of shots to take. Defaults to 5,000.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/resonator_spectroscopy.py

@@ -44,7 +44,7 @@ class ResonatorSpectroscopy(Experiment):
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/resonator_spectroscopy_by_bias.py

@@ -27,7 +27,7 @@ from .waveforms import ConstantWaveform
 
 class ResonatorSpectroscopyByBias(Experiment):
     """
-    Parameters for running a resonator spectroscopy by power experiment.
+    Parameters for running a resonator spectroscopy by bias experiment.
 
     Attributes
     ----------
@@ -42,7 +42,7 @@ class ResonatorSpectroscopyByBias(Experiment):
         Defaults to a scan around the readout frequency.
     biases : list[int] or LinspaceIterable or RangeIterable or CWSIterable \
              or HypIterable, optional
-        The biases at which to scan, in Volts.
+        The biases at which to scan, in volts.
         Defaults to 21 points between -0.49 and 0.49.
     recycle_delay_ns : int, optional
         The delay between consecutive shots, in nanoseconds. Defaults to 1,000 ns.
@@ -51,7 +51,7 @@ class ResonatorSpectroscopyByBias(Experiment):
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/resonator_spectroscopy_by_power.py

@@ -45,7 +45,7 @@ class ResonatorSpectroscopyByPower(Experiment):
         The delay between consecutive shots, in nanoseconds. Defaults to 1,000 ns.
     shot_count : int, optional
         The number of shots to take. Defaults to 100.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/t1.py

@@ -32,7 +32,7 @@ class T1(Experiment):
         The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
         The number of shots to take. Defaults to 400.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/t2.py

@@ -22,7 +22,7 @@ class T2(Experiment):
     """
     Parameters for running a T2 experiment.
 
-    Parameters
+    Attributes
     ----------
     transmon : str
         The reference for the transmon to target.
@@ -34,7 +34,7 @@ class T2(Experiment):
         The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
         The number of shots to take. Defaults to 400.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/t2_echo.py

@@ -34,7 +34,7 @@ class T2Echo(Experiment):
         The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
         The number of shots to take. Defaults to 400.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/transmon_anharmonicity.py

@@ -51,7 +51,7 @@ class TransmonAnharmonicity(Experiment):
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/transmon_spectroscopy.py

@@ -40,13 +40,13 @@ class TransmonSpectroscopy(Experiment):
     recycle_delay_ns : int, optional
         The delay between consecutive shots, in nanoseconds. Defaults to 50,000 ns.
     shot_count : int, optional
-        The number of shots to take. Defaults to 100.
+        The number of shots to take. Defaults to 400.
     spectroscopy_waveform : ConstantWaveform
         The waveform to use in the spectroscopy pulse.
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.
-    run_mixer_calibration: bool
+    run_mixer_calibration: bool, optional
         Whether to run mixer calibrations before running a program. Defaults to False.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.

boulderopalscaleupsdk/experiments/voltage_bias_fine_tune.py

@@ -25,7 +25,7 @@ class VoltageBiasFineTune(Experiment):
     Attributes
     ----------
     transmon : str
-        The reference for the transmon to XY drive in the experiment.
+        The reference for the transmon to XY drive.
     delays_ns : list[int] or RangeIterable
         The delay times, in nanoseconds.
     flux_count : int
@@ -35,14 +35,16 @@ class VoltageBiasFineTune(Experiment):
     virtual_detuning : float
         The difference between the drive signal frequency and the qubit frequency, in Hz.
     bias_transmon : str or None, optional
-        The reference for the transmon to flux tune in the experiment.
+        The reference for the transmon to flux tune.
         Defaults to transmon.
     recycle_delay_ns : int, optional
-        The delay time between consecutive shots of the experiment, in nanoseconds.
-        Defaults to 100_000 ns.
+        The delay between consecutive shots, in nanoseconds.
+        Defaults to 100,000 ns.
     shot_count : int, optional
-        The number of shots to be taken in the experiment.
+        The number of shots to take.
         Defaults to 400.
+    update : "auto" or "off" or "prompt", optional
+        How the device should be updated after an experiment run. Defaults to auto.
     """
 
     _experiment_name: str = PrivateAttr("voltage_bias_fine_tune")

boulderopalscaleupsdk/experiments/waveforms.py

@@ -29,6 +29,9 @@ class ConstantWaveform(_Waveform):  # pragma: no cover
     amplitude: float
     waveform_type: Literal["Constant"] = "Constant"
 
+    def __str__(self):
+        return f"ConstantWaveform(duration_ns={self.duration_ns}, amplitude={self.amplitude})"
+
 
 @dataclass
 class GaussianWaveform(_Waveform):  # pragma: no cover
@@ -37,6 +40,12 @@ class GaussianWaveform(_Waveform):  # pragma: no cover
     sigma: float
     waveform_type: Literal["Gaussian"] = "Gaussian"
 
+    def __str__(self):
+        return (
+            f"GaussianWaveform(duration_ns={self.duration_ns}, "
+            f"amplitude={self.amplitude}, sigma={self.sigma})"
+        )
+
 
 @dataclass
 class DragCosineWaveform(_Waveform):  # pragma: no cover
@@ -47,6 +56,12 @@ class DragCosineWaveform(_Waveform):  # pragma: no cover
     center: float
     waveform_type: Literal["DragCosineWaveform"] = "DragCosineWaveform"
 
+    def __str__(self):
+        return (
+            f"DragCosineWaveform(duration_ns={self.duration_ns}, amplitude={self.amplitude}, "
+            f"drag={self.drag}, buffer_ns={self.buffer_ns}, center={self.center})"
+        )
+
 
 Waveform = Annotated[
     ConstantWaveform | GaussianWaveform | DragCosineWaveform,

boulderopalscaleupsdk/experiments/zz_ramsey.py

@@ -15,7 +15,7 @@ from typing import Literal
 
 from pydantic import PrivateAttr
 
-from .common import Experiment
+from .common import Experiment, RangeIterable
 
 
 class ZZRamsey(Experiment):
@@ -25,22 +25,18 @@ class ZZRamsey(Experiment):
     Attributes
     ----------
     control_transmon : str
-        The control transmon to target in the experiment.
+        The reference for the transmon to use as control.
     target_transmon : str
-        The target transmon to pair with the control transmon.
-    max_delay_ns : int
-        The maximum delay time, in nanoseconds.
-    min_delay_ns : int
-        The minimum delay time, in nanoseconds.
-    delay_step_ns : int
-        The step for generating the list of delays, in nanoseconds.
+        The reference for the transmon to use as target.
+    delays_ns : RangeIterable
+        The delay times, in nanoseconds.
     virtual_detuning : float
         The difference between the drive signal frequency and the qubit frequency, in Hz.
     recycle_delay_ns : int, optional
-        The delay time between consecutive shots of the experiment, in nanoseconds.
+        The delay between consecutive shots, in nanoseconds.
         Defaults to 10,000 ns.
     shot_count : int, optional
-        The number of shots to be taken in the experiment.
+        The number of shots to take.
         Defaults to 400.
     update : "auto" or "off" or "prompt", optional
         How the device should be updated after an experiment run. Defaults to auto.
@@ -50,9 +46,7 @@ class ZZRamsey(Experiment):
 
     control_transmon: str
     target_transmon: str
-    max_delay_ns: int
-    min_delay_ns: int
-    delay_step_ns: int
+    delays_ns: RangeIterable
     virtual_detuning: float
     recycle_delay_ns: int = 10_000
     shot_count: int = 400

boulderopalscaleupsdk/plotting/dtypes.py

@@ -141,7 +141,7 @@ class Marker:
     y: float
     label: str
     color: str
-    symbol: Literal["star"]
+    symbol: Literal["star", "circle", "square", "diamond", "cross", "x"]
 
 
 @dataclass