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_length |
float | None
|
Override for the memory drive pulse length. If None,
the qubit parameter Default: |
transmon_pi_pulse |
dict | None
|
Dictionary of pulse overrides for the transmon pi pulse.
By default, the pulse parameters from the qubit's
|
create_experiment(qpu, qubits, amplitudes, frequencies, options=None)
¶
Creates a displacement calibration experiment.
The pulse sequence for each qubit is:
- Memory drive (displacement) pulse with swept amplitude.
- Transmon pi pulse (x180) with swept frequency.
- 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:
Setting |
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()