Experiment Calibration¶

Experiments can have their own associated Calibration object. In the event that a certain calibration property is defined in an experiment, its value has precedence over the value set in the baseline calibration on the device setup. However, subsequent experiments in which this property is not defined within that experiment’s calibration, will revert to the baseline calibration values.

This is useful if, for example, one wants to verify the qubit frequency by sweeping the drive frequency, but still wants to keep track of the previously calibrated value.

An experimental calibration is defined and set on the experiment in analogy to the baseline Calibration object on the device setup, through

my_exp_calibration = Calibration()

my_exp_calibration['exp_signal'] = SignalCalibration(
    // .... define calibration properties of experimental line
)

my_exp.set_calibration(my_exp_calibration)

It is important to ensure that the keys defined in the experimental calibration object correspond to the ids of the ExperimentSignal defined in the experiment.

The experimental Calibration acts together with the signal map set on the Experiment on execution to ensure the proper adjustment of calibrated parameters for the duration of the experiment.

The calibration properties that can be defined on an ExperimentSignal are the union of the properties of LogicalSignals and PhysicalChannels, so that all relevant parameters can be adjusted to the current experiments' needs. For a list of supported properties, sorted by instrument and channel type, see the table below.

Table 1: Experiment signal calibration properties by instrument and channel type
Instrument	channel type	supported properties
HDAWG	`iq_channel`	`oscillator` `delay_signal` `mixer_calibration` `port_delay`
HDAWG	`rf_channel`	`oscillator` `delay_signal` `port_delay`
UHFQA	`iq_channel`	`oscillator` `delay_signal` `port_delay` (input channels only) `threshold` (input channels only)
SHFQA	`iq_channel`	`oscillator` `delay_signal` `port_delay` `threshold` (input channels only) `local_oscillator` `range`
SHFSG	`iq_channel`	`oscillator` `delay_signal` `port_delay` `local_oscillator` `range` `port_mode`