Skip to content

laboneq_applications.contrib.experiments.bosonic_qubits.memory_spectroscopy

This module defines the memory spectroscopy experiment for bosonic qubits.

The memory spectroscopy experiment has the following pulse sequence:

qb --- [ memory spectroscopy drive (swept frequency) ] ---
--- [ transmon x180 (when memory in |0⟩) ] --- [ measure ]

The idea is to probe the memory cavity resonance by sweeping the frequency of a long spectroscopy tone applied to the memory cavity. After the spectroscopy pulse, a transmon pi pulse (calibrated for the memory in |0⟩) is applied. If the spectroscopy tone populated the memory, the transmon frequency is shifted by chi and the pi pulse will not fully excite the transmon, resulting in a change in the readout signal.

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

MemorySpectroscopyExperimentOptions

Options for the memory spectroscopy experiment.

Attributes:

Name Type Description
spectroscopy_pulse dict | None

Dictionary of pulse overrides for the memory spectroscopy pulse. By default, the pulse parameters from the qubit's memory_spectroscopy_pulse are used.

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

Creates a memory spectroscopy experiment.

The pulse sequence for each qubit is:

  1. Memory spectroscopy drive with swept frequency.
  2. Transmon pi pulse (x180), calibrated for the memory cavity in |0⟩.
  3. Readout pulse and acquisition.

When the spectroscopy tone is resonant with the memory cavity, it populates the cavity. This shifts the transmon frequency by the dispersive shift chi, causing the subsequent pi pulse to be off-resonant and resulting in a measurable change in the readout signal.

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
frequencies QubitSweepPoints

The RF frequencies to sweep over for the memory cavity spectroscopy drive for each qubit.

required
options MemorySpectroscopyExperimentOptions | None

The options for building the experiment. See MemorySpectroscopyExperimentOptions 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 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 = MemorySpectroscopyExperimentOptions(**options)
# QPU from a two-qubit device setup
qpu = QPU(
    quantum_elements=BosonicQubit.from_device_setup(setup),
    quantum_operations=BosonicQubitOperations(),
)
q0, q1 = qpu["q0"], qpu["q1"]
create_experiment(
    qpu=qpu,
    qubits=[q0, q1],
    frequencies=[
        np.linspace(6.0e9, 6.2e9, 101),
        np.linspace(6.0e9, 6.2e9, 101),
    ],
    options=options,
)

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

The memory spectroscopy 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
frequencies QubitSweepPoints

The RF frequencies to sweep over for the memory cavity spectroscopy drive 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 fitted memory_resonance_frequency 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 two-qubit device setup
qpu = QPU(
    quantum_elements=BosonicQubit.from_device_setup(setup),
    quantum_operations=BosonicQubitOperations(),
)
result = experiment_workflow(
    session=session,
    qpu=qpu,
    qubits=["q0", "q1"],
    frequencies=[
        np.linspace(6.0e9, 6.2e9, 101),
        np.linspace(6.0e9, 6.2e9, 101),
    ],
    options=options,
).run()