qml.labs.resource_estimation.ResourceMultiRZ¶
- class ResourceMultiRZ(num_wires, eps=None, wires=None)[source]¶
Bases:
ResourceOperator
Resource class for the MultiRZ gate.
- Parameters:
num_wires (int) – the number of qubits the operation acts upon
eps (float, optional) – error threshold for Clifford+T decomposition of this operation
wires (Sequence[int], optional) – the wires the operation acts on
- Resources:
The resources come from Section VIII (Figure 3) of The Bravyi-Kitaev transformation for quantum computation of electronic structure paper.
Specifically, the resources are given by one
ResourceRZ
gate and a cascade of \(2 * (n - 1)\)ResourceCNOT
gates where \(n\) is the number of qubits the gate acts on.
See also
Example
The resources for this operation are computed using:
>>> multi_rz = plre.ResourceMultiRZ(num_wires=3) >>> gate_set = {"CNOT", "RZ"} >>> >>> print(plre.estimate_resources(multi_rz, gate_set)) --- Resources: --- Total qubits: 3 Total gates : 5 Qubit breakdown: clean qubits: 0, dirty qubits: 0, algorithmic qubits: 3 Gate breakdown: {'CNOT': 4, 'RZ': 1}
Attributes
Returns a dictionary containing the minimal information needed to compute the resources.
- num_wires = 0¶
- resource_keys = {'eps', 'num_wires'}¶
- resource_params¶
Returns a dictionary containing the minimal information needed to compute the resources.
- Returns:
A dictionary containing the resource parameters: * num_wires (int): the number of qubits the operation acts upon * 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.
default_adjoint_resource_decomp
(num_wires[, eps])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, num_wires)Returns a list representing the resources for an operator raised to a power.
default_resource_decomp
(num_wires[, eps])Returns a list representing the resources for a controlled version of the operator.
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
(num_wires[, 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(num_wires, eps=None)[source]¶
Returns a list representing the resources for the adjoint of the operator.
- Parameters:
num_wires (int) – the number of qubits the operation acts upon
eps (float) – error threshold for clifford plus T decomposition of this operation
- Resources:
The adjoint of this operator just changes the sign of the phase, 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, num_wires, 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
num_wires (int) – the number of qubits the base operation acts upon
eps (float) – 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 RZ-gate and a cascade of \(2 * (n - 1)\)
ResourceCNOT
gates where \(n\) is the number of qubits the gate acts on.
- 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, num_wires, 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
num_wires (int) – the number of qubits the base operation acts upon
eps (float) – error threshold for clifford plus T decomposition of this operation
- Resources:
Taking arbitrary powers of a general rotation produces a sum of rotations. The resources simplify to just one total multi-RZ 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(num_wires, eps=None, **kwargs)[source]¶
Returns a list representing the resources for a controlled version of the operator.
- Parameters:
num_wires (int) – the number of qubits the operation acts upon
eps (float) – error threshold for clifford plus T decomposition of this operation
- Resources:
The resources come from Section VIII (Figure 3) of The Bravyi-Kitaev transformation for quantum computation of electronic structure paper.
Specifically, the resources are given by one
ResourceRZ
gate and a cascade of \(2 * (n - 1)\)ResourceCNOT
gates where \(n\) is the number of qubits the gate acts on.
- 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(num_wires, eps=None)[source]¶
Returns a compressed representation containing only the parameters of the Operator that are needed to compute a resource estimation.
- Parameters:
num_wires (int) – the number of qubits the operation acts upon
eps (float) – 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.