Note

This is the documentation for the current state of the development branch of Qiskit Experiments. The documentation or APIs here can change prior to being released.

EFRoughXSXAmplitudeCal

class EFRoughXSXAmplitudeCal(physical_qubits, calibrations, amplitudes=None, backend=None, ef_pulse_label='12')

A rough amplitude calibration of $X$ and $SX$ gates on the $|1⟩$ <-> $|2⟩$ transition.

Analysis class reference

OscillationAnalysis

Experiment options

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

Options

• Defined in the class RoughAmplitudeCal:

  • result_index (int)

    Default value: -1

    The index of the result from which to update the calibrations.

  • angles_schedules (list(float, str, str, float))

    Default value: [(3.141592653589793, "amp", "x", None)]

    A list of parameter update information. Each entry of the list is a tuple with four entries: the target angle of the rotation, the name of the amplitude parameter to update, the name of the schedule containing the amplitude parameter to update, and the previous value of the amplitude parameter to update. This allows one experiment to update several schedules, see for example RoughXSXAmplitudeCal.

  • group (str)

    Default value: "default"

    The calibration group to which the parameter belongs. This will default to the value “default”.

• Defined in the class Rabi:

  • amplitudes (iterable)

    Default value: array(-0.95, -0.9119999999999999, -0.874, -0.836, -0.7979999999999999, ..., size=51)

    The list of amplitude values to scan.

  • schedule (ScheduleBlock)

    Default value: None

    The schedule for the Rabi pulse. This schedule must have exactly one free parameter. The drive channel should match the qubit.

• 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

• Superclass qiskit_experiments.library.calibration.rough_amplitude_cal.RoughAmplitudeCal

• Superclass qiskit_experiments.calibration_management.base_calibration_experiment.BaseCalibrationExperiment

• Superclass qiskit_experiments.library.characterization.rabi.Rabi

Initialization

A rough amplitude calibration that updates both the sx and x pulses on the $|1⟩$ <-> $|2⟩$ transition.

Parameters:

• physical_qubits (Sequence[int]) – Sequence containing the index of the qubit (technically a qutrit) to run on.

• calibrations (Calibrations) – The calibrations instance that stores the pulse schedules.

• amplitudes (Optional[Iterable[float]]) – The amplitudes to scan.

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

• ef_pulse_label (str) – A label that is post-pended to “x” and “sx” to obtain the name of the pulses that drive a $\pi$ and $\pi /2$ rotation on the $|1⟩$ <-> $|2⟩$ transition.

Attributes

EFRoughXSXAmplitudeCal.analysis	Return the analysis instance for the experiment.
EFRoughXSXAmplitudeCal.backend	Return the backend for the experiment
EFRoughXSXAmplitudeCal.calibrations	Return the calibrations.
EFRoughXSXAmplitudeCal.experiment_options	Return the options for the experiment.
EFRoughXSXAmplitudeCal.experiment_type	Return experiment type.
EFRoughXSXAmplitudeCal.num_qubits	Return the number of qubits for the experiment.
EFRoughXSXAmplitudeCal.physical_qubits	Return the device qubits for the experiment.
EFRoughXSXAmplitudeCal.run_options	Return options values for the experiment run() method.
EFRoughXSXAmplitudeCal.transpile_options	Return the transpiler options for the run() method.

Methods

EFRoughXSXAmplitudeCal.circuits()	Create the circuits for the Rabi experiment.
EFRoughXSXAmplitudeCal.config()	Return the config dataclass for this experiment
EFRoughXSXAmplitudeCal.copy()	Return a copy of the experiment
EFRoughXSXAmplitudeCal.enable_restless([...])	Enables a restless experiment by setting the restless run options and the restless data processor.
EFRoughXSXAmplitudeCal.from_config(config)	Initialize an experiment from experiment config
EFRoughXSXAmplitudeCal.run([backend, ...])	Run an experiment and perform analysis.
EFRoughXSXAmplitudeCal.set_experiment_options(...)	Set the experiment options.
EFRoughXSXAmplitudeCal.set_run_options(**fields)	Set options values for the experiment run() method.
EFRoughXSXAmplitudeCal.set_transpile_options(...)	Add a warning message.
EFRoughXSXAmplitudeCal.update_calibrations(...)	Update the amplitude of one or several schedules.