Skip to content

laboneq_applications.contrib.experiments.bosonic_qubits.displacement_calibration

This module defines the displacement calibration experiment for bosonic qubits.

The displacement calibration experiment has the following pulse sequence:

qb --- [ memory drive (swept amplitude) ] ---
--- [ transmon x180 (swept frequency) ] --- [ measure ]

The idea is to calibrate the displacement operation on the memory cavity by sweeping the amplitude of the memory drive pulse and the frequency of the transmon pi pulse. For each displacement amplitude, the transmon spectroscopy reveals peaks at frequencies separated by the dispersive shift chi, corresponding to different photon number states |n⟩ in the memory cavity. The relative heights of these peaks encode the photon number distribution, allowing one to calibrate the displacement amplitude to a desired mean photon number.

If multiple qubits are passed to the run workflow, the above pulses are applied in parallel on all the qubits.

DisplacementCalibrationExperimentOptions

Options for the displacement calibration experiment.

Attributes:

Name Type Description
memory_drive_pulse dict | None

Dictionary of pulse overrides for the memory drive (displacement) pulse. By default, the pulse parameters from the qubit's memory_drive_pulse are used.

memory_drive_length float | None

Override for the memory drive pulse length. If None, the qubit parameter memory_drive_length is used.

Default: None

transmon_pi_pulse dict | None

Dictionary of pulse overrides for the transmon pi pulse. By default, the pulse parameters from the qubit's transmon_drive_pulse_when_memory_in_zero_state are used.

create_experiment(qpu, qubits, amplitudes, frequencies, options=None)

Creates a displacement calibration experiment.

The pulse sequence for each qubit is:

  1. Memory drive (displacement) pulse with swept amplitude.
  2. Transmon pi pulse (x180) with swept frequency.
  3. Readout pulse and acquisition.

This is a 2D sweep: for each displacement amplitude, the transmon pi pulse frequency is swept. The resulting transmon spectrum shows peaks at frequencies f_transmon - n * chi, where n is the photon number in the memory cavity. The relative peak heights reveal the photon number distribution produced by the displacement, enabling calibration of the displacement amplitude.

Parameters:

Name Type Description Default
qpu QPU

The qpu consisting of the original qubits and quantum operations.

required
qubits QuantumElements

The qubits to run the experiments on. May be either a single qubit or a list of qubits.

required
amplitudes QubitSweepPoints

The displacement amplitudes to sweep over for the memory cavity drive for each qubit.

required
frequencies QubitSweepPoints

The RF frequencies to sweep over for the transmon pi pulse for each qubit.

required
options DisplacementCalibrationExperimentOptions | None

The options for building the experiment. See DisplacementCalibrationExperimentOptions and BaseExperimentOptions for accepted options.

None

Returns:

Name Type Description
experiment Experiment

The generated LabOne Q experiment instance to be compiled and executed.

Raises:

Type Description
ValueError

If amplitudes or frequencies is not a list of numbers or array when a single qubit is passed.

Example
options = {
    "count": 10,
    "averaging_mode": "cyclic",
    "acquisition_type": "integration_trigger",
}
options = DisplacementCalibrationExperimentOptions(**options)
# QPU from a single-qubit device setup
qpu = QPU(
    quantum_elements=BosonicQubit.from_device_setup(setup),
    quantum_operations=BosonicQubitOperations(),
)
q0 = qpu["q0"]
create_experiment(
    qpu=qpu,
    qubits=q0,
    amplitudes=np.linspace(0.0, 1.0, 51),
    frequencies=np.linspace(4.9e9, 5.1e9, 101),
    options=options,
)

experiment_workflow(session, qpu, qubits, *, amplitudes, frequencies, temporary_parameters=None, options=None)

The displacement calibration workflow.

The workflow consists of the following steps:

Parameters:

Name Type Description Default
session Session

The connected session to use for running the experiment.

required
qpu QPU

The qpu consisting of the original qubits and quantum operations.

required
qubits list[str] | str

The qubits to run the experiments on, passed by UID. May be either a single qubit or a list of qubits.

required
amplitudes QubitSweepPoints

The displacement amplitudes to sweep over for the memory cavity drive for each qubit.

required
frequencies QubitSweepPoints

The RF frequencies to sweep over for the transmon pi pulse for each qubit.

required
temporary_parameters dict[str, dict | QuantumParameters] | None

The temporary parameters to update the qubits with.

None
options TuneUpWorkflowOptions | None

The options for building the workflow, passed as an instance of TuneUpWorkflowOptions. In addition to options from WorkflowOptions, the following custom options are supported:

  • create_experiment: The options for creating the experiment.

Setting update to True stores the calibrated displacement_amp_per_unit_beta in the qpu.

None

Returns:

Name Type Description
result None

The result of the workflow.

Example
options = experiment_workflow.options()
options.count(10)
# QPU from a single-qubit device setup
qpu = QPU(
    quantum_elements=BosonicQubit.from_device_setup(setup),
    quantum_operations=BosonicQubitOperations(),
)
result = experiment_workflow(
    session=session,
    qpu=qpu,
    qubits="q0",
    amplitudes=np.linspace(0.0, 1.0, 51),
    frequencies=np.linspace(4.9e9, 5.1e9, 101),
    options=options,
).run()