class FineAmplitudeCal(physical_qubits, calibrations, schedule_name, backend=None, cal_parameter_name='amp', auto_update=True, gate=None, measurement_qubits=None)[source]

A calibration version of the FineAmplitude experiment.


FineAmplitudeCal is a subclass of FineAmplitude. In the calibration experiment the circuits that are run have a custom gate with the pulse schedule attached to it through the calibrations.

Analysis class reference


Experiment options

These options can be set by the set_experiment_options() method.

  • Defined in the class FineAmplitudeCal:

    • target_angle (float)

      Default value: 3.141592653589793
      The target angle of the pulse.
  • Defined in the class BaseCalibrationExperiment:

    • result_index (int)

      Default value: -1
      The index of the result from which to update the calibrations.
    • group (str)

      Default value: "default"
      The calibration group to which the parameter belongs. This will default to the value “default”.
  • Defined in the class FineAmplitude:

    • repetitions (List[int])

      Default value: [1, 2, 3, 4, 5, …]
      A list of the number of times that the gate is repeated.
    • gate (Gate)

      Default value: None
      This is a gate class such as XGate, so that one can obtain a gate by doing options.gate().
    • normalization (bool)

      Default value: True
      If set to True the DataProcessor will normalized the measured signal to the interval [0, 1]. Defaults to True.
    • add_cal_circuits (bool)

      Default value: True
      If set to True then two circuits to calibrate 0 and 1 points will be added. These circuits are often needed to properly calibrate the amplitude of the ping-pong oscillation that encodes the errors. This helps account for state preparation and measurement errors.
  • Defined in the class BaseExperiment:

    • max_circuits (Optional[int])

      Default value: None
      The maximum number of circuits per job when running an experiment on a backend.

See also


See class FineAmplitude for details.

  • physical_qubits (Sequence[int]) – Sequence containing the qubit(s) for which to run the fine amplitude calibration. This can be a pair of qubits which correspond to control and target qubit.

  • calibrations (Calibrations) – The calibrations instance with the schedules.

  • schedule_name (str) – The name of the schedule to calibrate.

  • backend (Optional[Backend]) – Optional, the backend to run the experiment on.

  • cal_parameter_name (Optional[str]) – The name of the parameter in the schedule to update.

  • auto_update (bool) – Whether or not to automatically update the calibrations. By default this variable is set to True.

  • gate (Optional[Gate]) – The gate to repeat in the quantum circuit. If this argument is None (the default), then the gate is built from the schedule name.

  • measurement_qubits (Optional[Sequence[int]]) – The qubits in the given physical qubits that need to be measured.



Return the analysis instance for the experiment.


Return the backend for the experiment


Return the calibrations.


Return the options for the experiment.


Return experiment type.


Return the number of qubits for the experiment.


Return the device qubits for the experiment.


Return options values for the experiment run() method.


Return the transpiler options for the run() method.



Create the circuits for the fine amplitude calibration experiment.


Return the config dataclass for this experiment


Return a copy of the experiment


Enables a restless experiment by setting the restless run options and the restless data processor.


Initialize an experiment from experiment config[backend, analysis, ...])

Run an experiment and perform analysis.


Set the experiment options.


Set options values for the experiment run() method.


Add a warning message.


Update the amplitude of the pulse in the calibrations.