qml.labs.resource_estimation.ResourceRot

class ResourceRot(eps=None, wires=None)[source]

Bases: ResourceOperator

Resource class for the Rot-gate.

Parameters:
  • eps (float) – error threshold for clifford plus T decomposition of this operation

  • wires (Any, Wires, optional) – the wire the operation acts on

Resources:

The resources are obtained according to the definition of the Rot gate:

\[\hat{R}(\omega, \theta, \phi) = \hat{RZ}(\omega) \cdot \hat{RY}(\theta) \cdot \hat{RZ}(\phi).\]

See also

Rot

Example

The resources for this operation are computed using:

>>> plre.ResourceRot.resource_decomp()
[(1 x RY), (2 x RZ)]

num_wires

resource_keys

resource_params

Returns a dictionary containing the minimal information needed to compute the resources.

num_wires = 1
resource_keys = {'eps'}
resource_params

Returns a dictionary containing the minimal information needed to compute the resources.

Returns:

  • eps (Union[float, None]): error threshold for the approximation

Return type:

A dictionary containing the resource parameters

adjoint_resource_decomp(*args, **kwargs)

Returns a list of actions that define the resources of the operator.

controlled_resource_decomp(...)

Returns a list representing the resources for a controlled version of the operator.

default_adjoint_resource_decomp([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[, eps])

Returns a list representing the resources for an operator raised to a power.

default_resource_decomp([eps])

Returns a list representing the resources of the operator.

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 the resources.

resource_rep_from_op()

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.

tracking_name_from_op()

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.

Resources:

The adjoint of a general single qubit rotation changes the sign of the rotation angles, 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) – error threshold for clifford plus T decomposition of this operation

Resources:

For a single control wire, the cost is a single instance of ResourceCRot. Two additional ResourceX gates are used to flip the control qubit if it is zero-controlled. In the case where multiple controlled wires are provided, the resources are derived from Figure 1b of the paper T-count and T-depth of any multi-qubit unitary. The resources are derived with the following identities:

\[\begin{split}\begin{align} \hat{RZ}(\theta) = \hat{X} \cdot \hat{RZ}(- \theta) \cdot \hat{X}, \\ \hat{RY}(\theta) = \hat{X} \cdot \hat{RY}(- \theta) \cdot \hat{X}. \end{align}\end{split}\]

This identity is applied along with some clever choices for the angle values to combine rotations; the final circuit takes the form:

ctrl: ─────╭●─────────╭●─────────┤
trgt: ──RZ─╰X──RZ──RY─╰X──RY──RZ─┤

The CNOT gates are replaced with multi-controlled X-gates to generalize to the multi-controlled case.

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

Resources:

Taking arbitrary powers of a general single qubit rotation produces a sum of rotations. The resources simplify to just one total single qubit 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 representing the resources of the operator. Each object represents a quantum gate and the number of times it occurs in the decomposition.

Resources:

The resources are obtained according to the definition of the Rot gate:

\[\hat{R}(\omega, \theta, \phi) = \hat{RZ}(\omega) \cdot \hat{RY}(\theta) \cdot \hat{RZ}(\phi).\]
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 the resources.

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.