qml.labs.resource_estimation.ResourceIsingXY¶
- class ResourceIsingXY(eps=None, wires=None)[source]¶
Bases:
ResourceOperator
Resource class for the IsingXY gate.
- Parameters:
eps (float, optional) – error threshold for Clifford+T decomposition of this operation
wires (Sequence[int], optional) – the wire the operation acts on
- Resources:
Ising (XX + YY) coupling gate
\[\begin{split}\mathtt{XY}(\phi) = \exp\left(i \frac{\theta}{4} (X \otimes X + Y \otimes Y)\right) = \begin{bmatrix} 1 & 0 & 0 & 0 \\ 0 & \cos(\phi / 2) & i \sin(\phi / 2) & 0 \\ 0 & i \sin(\phi / 2) & \cos(\phi / 2) & 0 \\ 0 & 0 & 0 & 1 \end{bmatrix}.\end{split}\]The cost for implementing this transformation is given by:
0: ──H─╭●─────RY────╭●──H─┤ 1: ────╰Y─────RX────╰Y────┤
See also
Example
The resources for this operation are computed using:
>>> ising_xy = plre.ResourceIsingXY() >>> gate_set = {"Hadamard", "CY", "RY", "RX"} >>> print(plre.estimate_resources(ising_xy, gate_set)) --- Resources: --- Total qubits: 2 Total gates : 6 Qubit breakdown: clean qubits: 0, dirty qubits: 0, algorithmic qubits: 2 Gate breakdown: {'Hadamard': 2, 'CY': 2, 'RY': 1, 'RX': 1}
Attributes
Returns a dictionary containing the minimal information needed to compute the resources.
- num_wires = 2¶
- resource_keys = {'eps'}¶
- resource_params¶
Returns a dictionary containing the minimal information needed to compute the resources.
- Returns:
A dictionary containing the resource parameters: * eps (float): error threshold for clifford plus T decomposition of this operation
- Return type:
dict
Methods
adjoint_resource_decomp
(*args, **kwargs)Returns a list of actions that define the resources of the operator.
Returns a list representing the resources for a controlled version of the operator.
Returns a list representing the resources for the adjoint of the operator.
default_controlled_resource_decomp
(...[, eps])Returns a list representing the resources for a controlled version of the operator.
default_pow_resource_decomp
(pow_z[, eps])Returns a list representing the resources for an operator raised to a power.
default_resource_decomp
([eps])Returns a list of GateCount objects representing the operator's resources.
dequeue
(op_to_remove[, context])Remove the given resource operator(s) from the Operator queue.
pow_resource_decomp
(pow_z, *args, **kwargs)Returns a list representing the resources for an operator raised to a power.
queue
([context])Append the operator to the Operator queue.
resource_decomp
(*args, **kwargs)Returns a list of actions that define the resources of the operator.
resource_rep
([eps])Returns a compressed representation containing only the parameters of the Operator that are needed to compute a resource estimation.
Returns a compressed representation directly from the operator
set_resources
(new_func[, override_type])Set a custom function to override the default resource decomposition.
tracking_name
(*args, **kwargs)Returns a name used to track the operator during resource estimation.
Returns the tracking name built with the operator's parameters.
- classmethod adjoint_resource_decomp(*args, **kwargs)¶
Returns a list of actions that define the resources of the operator.
- classmethod controlled_resource_decomp(ctrl_num_ctrl_wires, ctrl_num_ctrl_values, *args, **kwargs)¶
Returns a list representing the resources for a controlled version of the operator.
- Parameters:
ctrl_num_ctrl_wires (int) – the number of qubits the operation is controlled on
ctrl_num_ctrl_values (int) – the number of control qubits, that are controlled when in the \(|0\rangle\) state
- classmethod default_adjoint_resource_decomp(eps=None)[source]¶
Returns a list representing the resources for the adjoint of the operator.
- Parameters:
eps (float, optional) – error threshold for clifford plus T decomposition of this operation
- Resources:
The adjoint of this operator just changes the sign of the phase angle, thus the resources of the adjoint operation results in the original operation.
- Returns:
A list of GateCount objects, where each object represents a specific quantum gate and the number of times it appears in the decomposition.
- Return type:
list[GateCount]
- classmethod default_controlled_resource_decomp(ctrl_num_ctrl_wires, ctrl_num_ctrl_values, eps=None)[source]¶
Returns a list representing the resources for a controlled version of the operator.
- Parameters:
ctrl_num_ctrl_wires (int) – the number of qubits the operation is controlled on
ctrl_num_ctrl_values (int) – the number of control qubits, that are controlled when in the \(|0\rangle\) state
eps (float, optional) – error threshold for clifford plus T decomposition of this operation
- Resources:
The resources are derived from the following identity. If an operation \(\hat{A}\) can be expressed as \(\hat{A} \ = \ \hat{U} \cdot \hat{B} \cdot \hat{U}^{\dagger}\) then the controlled operation \(C\hat{A}\) can be expressed as:
\[C\hat{A} \ = \ \hat{U} \cdot C\hat{B} \cdot \hat{U}^{\dagger}\]Specifically, the resources are one multi-controlled RY-gate, one multi-controlled RX-gate, a pair of
ResourceCY
gates and a pair ofResourceHadamard
gates.
- Returns:
A list of GateCount objects, where each object represents a specific quantum gate and the number of times it appears in the decomposition.
- Return type:
list[GateCount]
- classmethod default_pow_resource_decomp(pow_z, eps=None)[source]¶
Returns a list representing the resources for an operator raised to a power.
- Parameters:
pow_z (int) – the power that the operator is being raised to
eps (float, optional) – error threshold for clifford plus T decomposition of this operation
- Resources:
Taking arbitrary powers of a rotation produces a sum of rotations. The resources simplify to just one total Ising rotation.
- Returns:
A list of GateCount objects, where each object represents a specific quantum gate and the number of times it appears in the decomposition.
- Return type:
list[GateCount]
- classmethod default_resource_decomp(eps=None, **kwargs)[source]¶
Returns a list of GateCount objects representing the operator’s resources.
- Parameters:
eps (float, optional) – error threshold for clifford plus T decomposition of this operation
- Resources:
IsingXY coupling gate
\[\begin{split}\mathtt{XY}(\phi) = \exp\left(i \frac{\theta}{4} (X \otimes X + Y \otimes Y)\right) = \begin{bmatrix} 1 & 0 & 0 & 0 \\ 0 & \cos(\phi / 2) & i \sin(\phi / 2) & 0 \\ 0 & i \sin(\phi / 2) & \cos(\phi / 2) & 0 \\ 0 & 0 & 0 & 1 \end{bmatrix}.\end{split}\]The cost for implementing this transformation is given by:
0: ──H─╭●─────RY────╭●──H─┤ 1: ────╰Y─────RX────╰Y────┤
- Returns:
A list of GateCount objects, where each object represents a specific quantum gate and the number of times it appears in the decomposition.
- Return type:
list[GateCount]
- static dequeue(op_to_remove, context=<class 'pennylane.queuing.QueuingManager'>)¶
Remove the given resource operator(s) from the Operator queue.
- classmethod pow_resource_decomp(pow_z, *args, **kwargs)¶
Returns a list representing the resources for an operator raised to a power.
- Parameters:
pow_z (int) – exponent that the operator is being raised to
- queue(context=<class 'pennylane.queuing.QueuingManager'>)¶
Append the operator to the Operator queue.
- classmethod resource_decomp(*args, **kwargs)¶
Returns a list of actions that define the resources of the operator.
- classmethod resource_rep(eps=None)[source]¶
Returns a compressed representation containing only the parameters of the Operator that are needed to compute a resource estimation.
- Parameters:
eps (float, optional) – error threshold for clifford plus T decomposition of this operation
- Returns:
the operator in a compressed representation
- Return type:
- resource_rep_from_op()¶
Returns a compressed representation directly from the operator
- classmethod set_resources(new_func, override_type='base')¶
Set a custom function to override the default resource decomposition.
This method allows users to replace any of the resource_decomp, adjoint_resource_decomp, ctrl_resource_decomp, or pow_resource_decomp methods globally for every instance of the class.
- classmethod tracking_name(*args, **kwargs)¶
Returns a name used to track the operator during resource estimation.
- tracking_name_from_op()¶
Returns the tracking name built with the operator’s parameters.