Skip to content

laboneq_applications.contrib.experiments.resonator_photons_time_resolved

This module defines the resonator photon number time resolution experiment.

In this experiment, we perform a short qubit spectroscopy during the qubit readout, and sweeping the spectroscopy pulse over the measurement pulse to time resolve the photon number n. For superconducting qubits the qubit frequency changes with resonator photons according to:

Δf_ge(t) = -2𝛘n(t)

The pulse sequence for the resonator photon number time resolution experiment is as follows:

   ----------------------- [ delay(sweep)][ spectr ]
qb - [ prep transition ] - [    measure inspect    ] - [ clear time ] - [ measure ]

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

ResonatorPhotonsExperimentOptions

Options for the time-resolved resonator photons experiment.

Attributes:

Name Type Description
delay_between_measurements float

Time between inspect measure pulse and spectroscopy measure for better contrast.

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

Creates a Photon Number Resolution Experiment.

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. Multi qubit operation is only possible with multiple QA channels.

required
times QubitSweepPoints

The array of times that were swept over the measurement pulse in the experiment. If qubits is a single qubit, times must be a list of numbers or an array. Otherwise, it must be a list of lists of numbers or arrays.

required
frequencies QubitSweepPoints

The array of frequencies that were swept over in the experiment. If qubits is a single qubit, frequencies must be a list of numbers or an array. Otherwise, it must be a list of lists of numbers or arrays.

required
options ResonatorPhotonsExperimentOptions | None

The options for building the experiment. See ResonatorPhotonsExperimentOptions and QubitSpectroscopyExperimentOptions for accepted options.

None

Returns:

Name Type Description
experiment None

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

Raises:

Type Description
ValueError

If the qubits, times, and frequencies are not of the same length.

ValueError

If times and frequencies are not a list of numbers when a single qubit is passed.

ValueError

If frequencies is not a list of lists of numbers. If times is not a list of lists of numbers.

Example
options = ResonatorPhotonsExperimentOptions()
options.count = 2**9
options.delay_between_measurements = 1e-6
# QPU from a two-qubit device setup
qpu = QPU(
    quantum_elements=TunableTransmonQubit.from_device_setup(setup),
    quantum_operations=TunableTransmonOperations(),
)
q0, q1 = qpu["q0"], qpu["q1"]
qubits = [q0, q1]
center_q1 = 6.0e9
center_q2 = 6.1e9
span = 0.2e9
create_experiment(
    qpu=qpu,
    qubits=qubits,
    times=[np.linspace(0, 3e-6, 21), np.linspace(0, 3e-6, 21)],
    frequencies=[
        np.linspace(center_q1 - span / 2, center_q1 + span / 2, 151),
        np.linspace(center_q2 - span / 2, center_q2 + span / 2, 151),
    ],
    options=options,
)

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

The Resonator Photon Number Time Resolution Workflow.

The workflow consists of the following steps:

Removed in version 26.7.0

The qubits argument of type QuantumElements has been removed. Please pass qubits of type list[str] | str instead, i.e., the quantum element UIDs instead of the quantum element instances.

Changed in version 26.4.0

All arguments apart from session, qpu, and qubits are now keyword arguments.

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. Multi qubit operation is only possible with multiple QA channels.

required
times QubitSweepPoints

The array of times that were swept over the measurement pulse in the experiment. If qubits is a single qubit, times must be a list of numbers or an array.Otherwise, it must be a list of lists of numbers or arrays.

required
frequencies QubitSweepPoints

The array of frequencies that were swept over in the experiment. If qubits is a single qubit, frequencies must be a list of numbers or an array. Otherwise, it must be a list of lists of numbers or arrays.

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

The temporary parameters to update the qubits with.

None
options TuneUpWorkflowOptions | None

The options for building the workflow. In addition to options from WorkflowOptions, the following custom options are supported:

  • create_experiment: The options for creating the experiment.
None

Returns:

Name Type Description
WorkflowBuilder None

The builder for the experiment workflow.

Example
options = experiment_workflow.options()
options.count(2**9)
options.delay_between_measurements(1e-6)
# QPU from a two-qubit device setup
qpu = QPU(
    quantum_elements=TunableTransmonQubit.from_device_setup(setup),
    quantum_operations=TunableTransmonOperations(),
)
qubits = qpu.quantum_elements

temporary_parameters = {}
for q in qubits:
    temp_pars = deepcopy(q.parameters)
    temp_pars.drive_range = -10
    temp_pars.spectroscopy_amplitude = 0.25
    temp_pars.spectroscopy_length = 80e-9
    temporary_parameters[q.uid] = temp_pars

center_q1 = 6.0e9
center_q2 = 6.1e9
span = 0.2e9
result = experiment_workflow(
    session=session,
    qpu=qpu,
    qubits=["q0", "q1"],
    times=[np.linspace(0, 3e-6, 21), np.linspace(0, 3e-6, 21)],
    frequencies=[
        np.linspace(center_q1 - span / 2, center_q1 + span / 2, 151),
        np.linspace(center_q2 - span / 2, center_q2 + span / 2, 151),
    ],
    temporary_parameters=temporary_parameters,
    options=options,
).run()