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:
- temporary_qpu
- create_experiment
- compile_experiment
- run_experiment
- analysis_workflow
- evaluate_experiment
- update_qpu
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 |
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. |