boulder-opal-scale-up-sdk 1.0.3__py3-none-any.whl → 1.0.5__py3-none-any.whl

boulderopalscaleupsdk/device/device.py

@@ -12,14 +12,56 @@
 # License for the specific language.
 
 
+from pydantic import BaseModel
 from pydantic.dataclasses import dataclass
 
+from boulderopalscaleupsdk.common.dtypes import ISO8601DatetimeUTCLike
+from boulderopalscaleupsdk.device.controller import (
+    QBLOXControllerInfo,
+    QuantumMachinesControllerInfo,
+)
+from boulderopalscaleupsdk.device.defcal import DefCalData
+from boulderopalscaleupsdk.device.processor import SuperconductingProcessor
+
 
 @dataclass
-class InvalidDevice:
+class EmptyDefCalData:
     message: str
 
 
+DeviceName = str
+
+
 @dataclass
-class InvalidDeviceComponent:
-    message: str
+class DeviceData:
+    # TODO: retire DeviceInfo the next SDK release
+    qpu: SuperconductingProcessor  # | OtherSDKProcessorType
+    controller_info: QBLOXControllerInfo | QuantumMachinesControllerInfo
+    _defcals: dict[tuple[str, tuple[str, ...]], DefCalData]
+
+    def get_defcal(self, gate: str, addr: tuple[str, ...]) -> DefCalData | EmptyDefCalData:
+        """
+        Get the defcal data for a specific gate and address alias.
+        """
+        if self._defcals == {}:
+            return EmptyDefCalData(message="No defcal data available in a fresh device.")
+        _addr = tuple(i.lower() for i in sorted(addr))
+        defcal = self._defcals.get((gate, _addr))
+        if defcal is None:
+            return EmptyDefCalData(
+                message=f"No defcal data found for gate '{gate}' and address '{_addr}'.",
+            )
+        return defcal
+
+
+class DeviceSummary(BaseModel):
+    id: str
+    organization_id: str
+    name: str
+    provider: str
+    updated_at: ISO8601DatetimeUTCLike
+    created_at: ISO8601DatetimeUTCLike
+    copied_from: DeviceName | None = None
+
+    def __str__(self):
+        return f'DeviceSummary(name="{self.name}", id="{self.id}")'

boulderopalscaleupsdk/device/processor/__init__.py

@@ -14,7 +14,6 @@
 __all__ = [
     "CalibrationThresholds",
     "ComponentParameter",
-    "DurationComponentParameter",
     "FloatComponentParameter",
     "SuperconductingProcessor",
     "SuperconductingProcessorTemplate",
@@ -24,7 +23,6 @@ __all__ = [
 from .common import (
     CalibrationThresholds,
     ComponentParameter,
-    DurationComponentParameter,
     FloatComponentParameter,
     update_parameter,
 )

boulderopalscaleupsdk/device/processor/common.py

@@ -200,7 +200,7 @@ class ComponentParameter(Generic[T]):
         ):
             self.calibration_status = _get_calibration_status_from_thresholds(
                 value=to_float(self.value),
-                confidence_interval=to_float(self.err_plus) - to_float(self.err_minus),
+                confidence_interval=to_float(self.err_plus) + to_float(self.err_minus),
                 calibration_thresholds=calibration_thresholds,
             )
         self.updated_at = datetime.now(UTC)
@@ -272,8 +272,3 @@ FloatComponentParameter = Annotated[
     ComponentParameter[float],
     BeforeValidator(lambda value: ComponentParameter.from_value(value, float)),
 ]
-
-DurationComponentParameter = Annotated[
-    ComponentParameter[Duration],
-    BeforeValidator(lambda value: ComponentParameter.from_value(value, Duration)),
-]

boulderopalscaleupsdk/device/processor/superconducting_processor.py

@@ -26,7 +26,6 @@ from boulderopalscaleupsdk.device.common import (
 )
 from boulderopalscaleupsdk.device.processor import (
     ComponentParameter,
-    DurationComponentParameter,
     FloatComponentParameter,
 )
 
@@ -44,15 +43,15 @@ class Transmon(Component[Literal["tunable"]]):
         default=ComponentParameter(value=0.0),
         json_schema_extra={"display": {"label": "anharm", "unit": "MHz", "scale": 1e-6}},
     )
-    t1: DurationComponentParameter = Field(
+    t1: ComponentParameter[Duration] = Field(
         default=ComponentParameter(value=Duration(0, TimeUnit.NS)),
         json_schema_extra={"display": {"label": "t1", "unit": "µs", "scale": 1e6}},
     )
-    t2: DurationComponentParameter = Field(
+    t2: ComponentParameter[Duration] = Field(
         default=ComponentParameter(value=Duration(0, TimeUnit.NS)),
         json_schema_extra={"display": {"label": "t2", "unit": "µs", "scale": 1e6}},
     )
-    t2_echo: DurationComponentParameter = Field(
+    t2_echo: ComponentParameter[Duration] = Field(
         default=ComponentParameter(value=Duration(0, TimeUnit.NS)),
         json_schema_extra={"display": {"label": "t2_echo", "unit": "µs", "scale": 1e6}},
     )
@@ -64,6 +63,14 @@ class Transmon(Component[Literal["tunable"]]):
         default=ComponentParameter(value=0.0),
         json_schema_extra={"display": {"label": "sx_vp", "unit": "V", "scale": 1}},
     )
+    x_ef_vp: FloatComponentParameter = Field(
+        default=ComponentParameter(value=0.0),
+        json_schema_extra={"display": {"label": "x_ef_vp", "unit": "V", "scale": 1}},
+    )
+    sx_ef_vp: FloatComponentParameter = Field(
+        default=ComponentParameter(value=0.0),
+        json_schema_extra={"display": {"label": "sx_ef_vp", "unit": "V", "scale": 1}},
+    )
 
     # Tunable transmon parameters.
     dc_bias: FloatComponentParameter = Field(
@@ -154,7 +161,27 @@ class Feedline(Component[Literal["feedline"]]):
     traits: list = Field(default=[])
 
 
-SuperconductingComponentType = Transmon | Resonator | Port | Feedline | Filter | Coupler
+class TWPA(Component[Literal["twpa"]]):
+    dtype: Literal["twpa"] = "twpa"
+    traits: list = Field(default=[])
+
+    impedance: FloatComponentParameter = Field(
+        default=ComponentParameter(value=0.0),
+        json_schema_extra={"display": {"label": "impedance", "unit": "Ohm", "scale": 1}},
+    )
+
+    # Tunable TWPA parameters
+    pump_power: FloatComponentParameter = Field(
+        default=ComponentParameter(value=0.0),
+        json_schema_extra={"display": {"label": "pump_power", "unit": "dBm", "scale": 1}},
+    )
+    pump_freq: FloatComponentParameter = Field(
+        default=ComponentParameter(value=(0.0)),
+        json_schema_extra={"display": {"label": "pump_freq", "unit": "MHz", "scale": 1e-6}},
+    )
+
+
+SuperconductingComponentType = Transmon | Resonator | Port | Feedline | Filter | Coupler | TWPA
 
 
 class Edge(BaseModel):
@@ -169,14 +196,14 @@ class TemplateParam(BaseModel):
 
 
 class ProcessorTemplate(BaseModel):
-    elements: dict[str, Transmon | Resonator | Port | Feedline | Filter | Coupler]
+    elements: dict[str, SuperconductingComponentType]
     edges: list[Edge]
 
 
 class SuperconductingProcessorTemplate(BaseModel):
     build: list[TemplateParam]
     templates: dict[str, ProcessorTemplate]
-    device_parameters: dict[str, Transmon | Resonator | Port | Feedline | Filter | Coupler] = Field(
+    device_parameters: dict[str, SuperconductingComponentType] = Field(
         default={},
     )
 

boulderopalscaleupsdk/experiments/__init__.py

@@ -19,32 +19,44 @@ __all__ = [
     "CWSIterable",
     "Chi01Scan",
     "ConstantWaveform",
+    "DragCosineWaveform",
+    "DragLeakageCalibration",
     "Experiment",
+    "FineAmplitudeCalibration",
     "GaussianWaveform",
     "HypIterable",
     "LinspaceIterable",
+    "LogspaceIterable",
     "PowerRabi",
+    "PowerRabiEF",
     "Ramsey",
     "RangeIterable",
     "ReadoutClassifierCalibration",
     "ResonatorSpectroscopy",
     "ResonatorSpectroscopyByBias",
     "ResonatorSpectroscopyByPower",
+    "T2Echo",
     "TransmonAnharmonicity",
     "TransmonSpectroscopy",
+    "VoltageBiasFineTune",
+    "Waveform",
+    "ZZRamsey",
+    "update_amplitude",
 ]
 
 from .chi01_scan import Chi01Scan
 from .common import (
-    ConstantWaveform,
     CWSIterable,
     Experiment,
-    GaussianWaveform,
     HypIterable,
     LinspaceIterable,
+    LogspaceIterable,
     RangeIterable,
 )
+from .drag_leakage_calibration import DragLeakageCalibration
+from .fine_amplitude_calibration import FineAmplitudeCalibration
 from .power_rabi import PowerRabi
+from .power_rabi_ef import PowerRabiEF
 from .ramsey import Ramsey
 from .readout_classifier_calibration import ReadoutClassifierCalibration
 from .resonator_spectroscopy import ResonatorSpectroscopy
@@ -52,5 +64,15 @@ from .resonator_spectroscopy_by_bias import ResonatorSpectroscopyByBias
 from .resonator_spectroscopy_by_power import ResonatorSpectroscopyByPower
 from .t1 import T1
 from .t2 import T2
+from .t2_echo import T2Echo
 from .transmon_anharmonicity import TransmonAnharmonicity
 from .transmon_spectroscopy import TransmonSpectroscopy
+from .voltage_bias_fine_tune import VoltageBiasFineTune
+from .waveforms import (
+    ConstantWaveform,
+    DragCosineWaveform,
+    GaussianWaveform,
+    Waveform,
+    update_amplitude,
+)
+from .zz_ramsey import ZZRamsey

boulderopalscaleupsdk/experiments/chi01_scan.py

@@ -11,19 +11,18 @@
 # distributed under the License is distributed on an "AS IS" BASIS. See the
 # License for the specific language.
 
+from typing import Literal
+
 from pydantic import PrivateAttr
 
 from .common import (
-    ConstantWaveform,
     CWSIterable,
     Experiment,
     HypIterable,
     LinspaceIterable,
     RangeIterable,
 )
-
-DEFAULT_RECYCLE_DELAY_NS = 10_000
-DEFAULT_SHOT_COUNT = 100
+from .waveforms import ConstantWaveform
 
 
 class Chi01Scan(Experiment):
@@ -34,20 +33,22 @@ class Chi01Scan(Experiment):
     Attributes
     ----------
     transmon : str
-        The reference for the transmon to target in the experiment.
-    frequencies : list[int] or LinspaceIterable or RangeIterable or CWSIterable
+        The reference for the transmon to target.
+    frequencies : list[int] or LinspaceIterable or RangeIterable or CWSIterable \
                   or HypIterable or None, optional
-        The frequencies at which to scan.
-        If None, frequencies around the readout frequency will be used.
+        The frequencies at which to scan, in Hz.
+        Defaults to a scan around the readout frequency.
     recycle_delay_ns : int, optional
-        The delay time between consecutive shots of the experiment, in nanoseconds.
-        Defaults to 10000 ns.
+        The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
-        The number of shots to be taken in the experiment.
-        Defaults to 100.
+        The number of shots to take. Defaults to 100.
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
-        If not provided, the measurement defcal will be used.
+        Defaults to the measurement defcal.
+    run_mixer_calibration: bool
+        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.
     """
 
     _experiment_name: str = PrivateAttr("chi01_scan")
@@ -56,6 +57,8 @@ class Chi01Scan(Experiment):
     frequencies: list[int] | LinspaceIterable | RangeIterable | CWSIterable | HypIterable | None = (
         None
     )
-    recycle_delay_ns: int = DEFAULT_RECYCLE_DELAY_NS
-    shot_count: int = DEFAULT_SHOT_COUNT
+    recycle_delay_ns: int = 200_000
+    shot_count: int = 100
     measure_waveform: ConstantWaveform | None = None
+    run_mixer_calibration: bool = False
+    update: Literal["auto", "off", "prompt"] = "auto"

boulderopalscaleupsdk/experiments/common.py

@@ -14,7 +14,6 @@
 from typing import Literal
 
 from pydantic import BaseModel, ConfigDict, Field
-from pydantic.dataclasses import dataclass
 
 
 class Experiment(BaseModel):
@@ -98,18 +97,3 @@ class HypIterable(_RangeIterable):
     width: float
     # The number of values. Defaults to 51.
     count: int = Field(default=51)
-
-
-@dataclass
-class ConstantWaveform:
-    duration_ns: int
-    scale: float
-    waveform_type: Literal["constant"] = "constant"
-
-
-@dataclass
-class GaussianWaveform:
-    duration_ns: int
-    amplitude: float
-    sigma: float
-    waveform_type: Literal["gaussian"] = "gaussian"

boulderopalscaleupsdk/experiments/drag_leakage_calibration.py

@@ -0,0 +1,66 @@
+# Copyright 2025 Q-CTRL. All rights reserved.
+#
+# Licensed under the Q-CTRL Terms of service (the "License"). Unauthorized
+# copying or use of this file, via any medium, is strictly prohibited.
+# Proprietary and confidential. You may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+#    https://q-ctrl.com/terms
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS. See the
+# License for the specific language.
+
+from typing import Literal
+
+from pydantic import PrivateAttr, field_validator
+
+from .common import CWSIterable, Experiment
+
+
+class DragLeakageCalibration(Experiment):
+    """
+    Parameters for running a DRAG leakage calibration experiment for
+    a specified gate on a transmon.
+
+    Attributes
+    ----------
+    transmon : str
+        The reference for the transmon to target.
+    recycle_delay_ns : int
+        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.
+    alphas: list[float] or CWSIterable
+        List of values to sweep for DRAG parameter alpha.
+    repetitions : list[int]
+        List of repetition counts for the calibration experiment.
+    gate : "sx" or "x"
+        The gate to calibrate.
+    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.
+    """
+
+    _experiment_name: str = PrivateAttr("drag_leakage_calibration")
+
+    transmon: str
+    recycle_delay_ns: int = 10_000
+    shot_count: int = 1_000
+    alphas: list[float] | CWSIterable
+    repetitions: list[int]
+    gate: Literal["x", "sx"]
+    anharmonicity: float | None = None
+    drag_guess: float
+    update: Literal["auto", "off", "prompt"] = "auto"
+
+    @field_validator("alphas")
+    @classmethod
+    def validate_alphas(cls, value: list[float] | CWSIterable):
+        if isinstance(value, CWSIterable) and value.center is None:
+            raise TypeError("The center of alphas must not be None.")
+        return value

boulderopalscaleupsdk/experiments/fine_amplitude_calibration.py

@@ -0,0 +1,54 @@
+# Copyright 2025 Q-CTRL. All rights reserved.
+#
+# Licensed under the Q-CTRL Terms of service (the "License"). Unauthorized
+# copying or use of this file, via any medium, is strictly prohibited.
+# Proprietary and confidential. You may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+#    https://q-ctrl.com/terms
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS. See the
+# License for the specific language.
+
+from typing import Literal
+
+from pydantic import Field, PrivateAttr
+
+from .common import Experiment
+from .waveforms import ConstantWaveform
+
+
+class FineAmplitudeCalibration(Experiment):
+    """
+    Parameters for running a fine amplitude calibration experiment for
+    a specified gate on a transmon.
+
+    Attributes
+    ----------
+    transmon : str
+        The reference for the transmon to target.
+    gate : Literal["sx", "x"]
+        The gate to be calibrated.
+    repetitions : list[int]
+        List of repetition counts for the calibration experiment.
+    recycle_delay_ns : int
+        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.
+    measure_waveform : ConstantWaveform or None, optional
+        The waveform to use for the measurement pulse.
+        Defaults to the measurement defcal.
+    update : "auto" or "off" or "prompt", optional
+        How the device should be updated after an experiment run. Defaults to auto.
+    """
+
+    _experiment_name: str = PrivateAttr("fine_amplitude_calibration")
+
+    transmon: str
+    gate: Literal["sx", "x"]
+    repetitions: list[int] = Field(default=list(range(0, 100, 4)))
+    recycle_delay_ns: int = 10_000
+    shot_count: int = 1000
+    measure_waveform: ConstantWaveform | None = None
+    update: Literal["auto", "off", "prompt"] = "auto"

boulderopalscaleupsdk/experiments/power_rabi.py

@@ -11,51 +11,57 @@
 # distributed under the License is distributed on an "AS IS" BASIS. See the
 # License for the specific language.
 
+from typing import Literal
+
 from pydantic import PrivateAttr
 
 from .common import (
-    ConstantWaveform,
     CWSIterable,
     Experiment,
-    GaussianWaveform,
     HypIterable,
     LinspaceIterable,
     RangeIterable,
 )
-
-DEFAULT_SHOT_COUNT = 400
+from .waveforms import ConstantWaveform, Waveform
 
 
 class PowerRabi(Experiment):
     """
     Parameters for running a Power Rabi experiment.
 
-    Parameters
+    Attributes
     ----------
     transmon : str
-        The reference for the transmon to target in the experiment.
-    scales : list[float] or LinspaceIterable or RangeIterable
+        The reference for the transmon to target.
+    scales : list[float] or LinspaceIterable or RangeIterable \
             or CWSIterable or HypIterable or None, optional
-        The scaling factors for the drive pulse amplitude. If None, a default scan will be used.
-    drive_waveform : GaussianWaveform
+        The scaling factors for the drive pulse amplitude.
+        If None, a default scan will be used.
+    drive_waveform : Waveform
         The waveform to use for the drive pulse.
     recycle_delay_ns : int
-        The delay time between consecutive shots of the experiment, in nanoseconds.
+        The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
-        The number of shots to be taken in the experiment. Defaults to 400.
+        The number of shots to take. Defaults to 400.
     pulse_vp : float, optional
-        The voltage per pulse. If None, a default value will be used.
+        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.
-        If not provided, the measurement defcal will be used.
+        Defaults to the measurement defcal.
+    run_mixer_calibration: bool
+        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.
     """
 
     _experiment_name: str = PrivateAttr("power_rabi")
 
     transmon: str
     scales: list[float] | LinspaceIterable | RangeIterable | CWSIterable | HypIterable | None = None
-    drive_waveform: GaussianWaveform
-    recycle_delay_ns: int
-    shot_count: int = DEFAULT_SHOT_COUNT
+    drive_waveform: Waveform
+    recycle_delay_ns: int = 200_000
+    shot_count: int = 400
     pulse_vp: float | None = None
     measure_waveform: ConstantWaveform | None = None
+    run_mixer_calibration: bool = False
+    update: Literal["auto", "off", "prompt"] = "auto"

boulderopalscaleupsdk/experiments/power_rabi_ef.py

@@ -0,0 +1,67 @@
+# Copyright 2025 Q-CTRL. All rights reserved.
+#
+# Licensed under the Q-CTRL Terms of service (the "License"). Unauthorized
+# copying or use of this file, via any medium, is strictly prohibited.
+# Proprietary and confidential. You may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+#    https://q-ctrl.com/terms
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS. See the
+# License for the specific language.
+
+from typing import Literal
+
+from pydantic import PrivateAttr
+
+from .common import (
+    CWSIterable,
+    Experiment,
+    HypIterable,
+    LinspaceIterable,
+    RangeIterable,
+)
+from .waveforms import ConstantWaveform, Waveform
+
+
+class PowerRabiEF(Experiment):
+    """
+    Parameters for running a Power Rabi EF experiment.
+
+    Attributes
+    ----------
+    transmon : str
+        The reference for the transmon to target.
+    scales : list[float] or LinspaceIterable or RangeIterable \
+            or CWSIterable or HypIterable or None, optional
+        The scaling factors for the drive pulse amplitude.
+        If None, a default scan will be used.
+    drive_waveform : Waveform
+        The waveform to use for the drive pulse.
+    recycle_delay_ns : int
+        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.
+    measure_waveform : ConstantWaveform or None, optional
+        The waveform to use for the measurement pulse.
+        Defaults to the measurement defcal.
+    run_mixer_calibration: bool
+        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.
+    """
+
+    _experiment_name: str = PrivateAttr("power_rabi_ef")
+
+    transmon: str
+    scales: list[float] | LinspaceIterable | RangeIterable | CWSIterable | HypIterable | None = None
+    drive_waveform: Waveform
+    recycle_delay_ns: int = 200_000
+    shot_count: int = 400
+    pulse_vp: float | None = None
+    measure_waveform: ConstantWaveform | None = None
+    run_mixer_calibration: bool = False
+    update: Literal["auto", "off", "prompt"] = "auto"

boulderopalscaleupsdk/experiments/ramsey.py

@@ -11,49 +11,52 @@
 # distributed under the License is distributed on an "AS IS" BASIS. See the
 # License for the specific language.
 
-from pydantic import PrivateAttr
+from typing import Literal
 
-from .common import ConstantWaveform, Experiment
+from pydantic import PrivateAttr
 
-DEFAULT_RECYCLE_DELAY_NS = 10_000
-DEFAULT_SHOT_COUNT = 400
-DEFAULT_DURATION_NS = 2_000
+from .common import Experiment
+from .waveforms import ConstantWaveform
 
 
 class Ramsey(Experiment):
     """
     Parameters for running a Ramsey experiment.
 
-    Parameters
+    Attributes
     ----------
     transmon : str
-        The reference for the transmon to target in the experiment.
-    max_delay_ns : int
-        The maximum delay time, in nanoseconds.
+        The reference for the transmon to target.
     min_delay_ns : int
         The minimum delay time, in nanoseconds.
+    max_delay_ns : int
+        The maximum delay time, in nanoseconds.
     delay_step_ns : int
         The step for generating the list of delays, in nanoseconds.
     virtual_detuning : float
-        The difference between the drive signal frequency and the qubit frequency, in Hz.
+        The virtual detuning added between SX pulses, in Hz.
     recycle_delay_ns : int, optional
-        The delay time between consecutive shots of the experiment, in nanoseconds.
-        Defaults to 10000 ns.
+        The delay between consecutive shots, in nanoseconds. Defaults to 200,000 ns.
     shot_count : int, optional
-        The number of shots to be taken in the experiment.
-        Defaults to 400.
+        The number of shots to take. Defaults to 400.
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
-        If not provided, the measurement defcal will be used.
+        Defaults to the measurement defcal.
+    run_mixer_calibration: bool
+        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.
     """
 
     _experiment_name: str = PrivateAttr("ramsey")
 
     transmon: str
-    max_delay_ns: int
     min_delay_ns: int
+    max_delay_ns: int
     delay_step_ns: int
     virtual_detuning: float
-    recycle_delay_ns: int = DEFAULT_RECYCLE_DELAY_NS
-    shot_count: int = DEFAULT_SHOT_COUNT
+    recycle_delay_ns: int = 200_000
+    shot_count: int = 400
     measure_waveform: ConstantWaveform | None = None
+    run_mixer_calibration: bool = False
+    update: Literal["auto", "off", "prompt"] = "auto"