Skip to content

laboneq_applications.contrib.experiments.zz_coupling_strength

Cross ZZ Echo Ramsey experiment used to characterize residual ZZ interaction.

In this experiment, we sweep the flux bias applied to the coupler. At each bias point we perform a Cross ZZ Echo Ramsey experiment between the two qubits to determine the frequency shift of qubits[0] when qubits[1] is in the excited vs ground state.

The decoupling experiment has the following pulse sequence: [tau] and the static dc bias are swept

     q0 -[X_pi/2]-[tau]-[X_pi]-[tau]-[Y_pi/2]-[measure][passive reset]
     q1 ----------------[X_pi]-------[X_pi]---[measure][passive reset]
coupler ----------------------------------------------------------- (static dc bias)

create_experiment(qpu, qubit_pairs, biases, delays, options=None)

Creates a ZZ coupling strength experiment.

Parameters:

Name Type Description Default
qpu QPU

The QPU consisting of the original qubits, coupler, and quantum operations.

required
qubit_pairs list[list[str]]

A list of UIDs of qubit pairs with the format [["q0", "q1"], ["q2", "q4"], ...]. The workflow will be executed in parallel on these pairs, throwing an error if there is a conflict of resources in the sequence, for example the same qubit UID appearing in multiple pairs.

required
biases QubitSweepPoints

Voltage offset to be applied to the flux channel connected to the tunable coupler of each pair.

required
delays QubitSweepPoints

Delays to be used in the Ramsey experiment executed to characterize the frequency shift between the two qubits.

required
options TuneupExperimentOptions | None

The options for building the experiment. See TuneupExperimentOptions 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 the qubits and delays and biases are not of the same length.

ValueError

If qubits passed have conflicting resources, for example a qubit appears more than once per pair.

ValueError

If one of the coupler edges between the pairs has no quantum element or its quantum element has no flux line.

ValueError

If the experiment uses calibration traces and the averaging mode is sequential.

evaluate_experiment(analysis_results, qubit_pairs, evaluation_parameters=None)

Evaluates the ZZ coupling strength analysis workflow result.

Parameters:

Name Type Description Default
analysis_results WorkflowResult

The analysis workflow results.

required
qubit_pairs list[QuantumElements]

The qubits pairs to run the experiments on.

required
evaluation_parameters dict[str, Any] | None

The evaluation parameters.

None

Returns:

Type Description
dict[str, dict[str, bool]]

The evaluation flags.

experiment_workflow(session, qpu, qubit_pairs, *, biases, delays, evaluation_parameters=None, temporary_parameters=None, options=None)

The ZZ coupling strength workflow.

The workflow consists of the following steps:

Changed in version 26.4.0

The evaluation_parameters argument has been added, which is the dictionary of parameters used for the newly added evaluation task. 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, coupler, and quantum operations.

required
qubit_pairs list[list[str]]

The qubit pairs on which to run the experiment, passed as a list of UID lists.

required
biases QubitSweepPoints

The DC voltage biases applied to the coupler. This is the inner sweep parameter (fast axis).

required
delays QubitSweepPoints

The delays (in seconds) of the time between the first X90 and the X180, and the X180 and the Y90. This is the outer sweep parameter (slow axis).

required
evaluation_parameters dict[str, Any] | None

The dictionary of parameters used for the evaluation task. The default evaluation parameters are defined in the evaluate_experiment task.

None
temporary_parameters dict[str, dict | TunableTransmonQubitParameters] | None

The temporary parameters with which to update the QPU.

None
options TuneUpWorkflowOptions | None

The options for building the workflow, passed as an instance of TuneUpWorkflowOptions.

None

Returns:

Name Type Description
WorkflowBuilder None

The builder for the experiment workflow.