qml.labs.resource_estimation.ResourceBasisRotation

class ResourceBasisRotation(dim_N, wires=None)

Bases: ResourceOperator

Resource class for the BasisRotation gate.

Parameters:

• dim_N (int) – The dimensions of the input unitary_matrix. This is computed as the number of columns of the matrix.

• wires (Sequence[int], optional) – the wires the operation acts on

Resources:

The resources are obtained from the construction scheme given in Optica, 3, 1460 (2016). Specifically, the resources are given as \(dim_N \times (dim_N - 1) / 2\) instances of the ResourceSingleExcitation gate, and \(dim_N \times (1 + (dim_N - 1) / 2)\) instances of the ResourcePhaseShift gate.

See also

BasisRotation

Example

The resources for this operation are computed using:

>>> basis_rot = plre.ResourceBasisRotation(dim_N = 5)
>>> print(plre.estimate_resources(basis_rot))
--- Resources: ---
Total qubits: 5
Total gates : 1.740E+3
Qubit breakdown:
 clean qubits: 0, dirty qubits: 0, algorithmic qubits: 5
Gate breakdown:
 {'T': 1.580E+3, 'S': 60, 'Z': 40, 'Hadamard': 40, 'CNOT': 20}

Attributes

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

num_wires = 0

resource_keys = {'dim_N'}

resource_params

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

Returns:

A dictionary containing the resource parameters:

• dim_N (int): The dimensions of the input unitary_matrix. This is computed as the number of columns of the matrix.

Return type:

dict

Methods

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(*args, **kwargs)	Returns a list representing the resources for the adjoint of the operator.
default_controlled_resource_decomp(...)	Returns a list representing the resources for a controlled version of the operator.
default_pow_resource_decomp(pow_z, *args, ...)	Returns a list representing the resources for an operator raised to a power.
default_resource_decomp(dim_N, **kwargs)	Returns a dictionary representing the resources 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(dim_N)	Returns a compressed representation containing only the parameters of the Operator that are needed to compute a resource estimation.
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(dim_N)	Returns the tracking name built with the operator's parameters.
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(*args, **kwargs)

Returns a list representing the resources for the adjoint of the operator.

classmethod default_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_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

classmethod default_resource_decomp(dim_N, **kwargs)

Returns a dictionary representing the resources of the operator. The keys are the operators and the associated values are the counts.

Parameters:

dim_N (int) – The dimensions of the input unitary_matrix. This is computed as the number of columns of the matrix.

Resources:

The resources are obtained from the construction scheme given in Optica, 3, 1460 (2016). Specifically, the resources are given as \(dim_N * (dim_N - 1) / 2\) instances of the ResourceSingleExcitation gate, and \(dim_N * (1 + (dim_N - 1) / 2)\) instances of the ResourcePhaseShift gate.

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(dim_N)

Returns a compressed representation containing only the parameters of the Operator that are needed to compute a resource estimation.

Parameters:

dim_N (int) – The dimensions of the input unitary_matrix. This is computed as the number of columns of the matrix.

Returns:

the operator in a compressed representation

Return type:

CompressedResourceOp

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(dim_N)

Returns the tracking name built with the operator’s parameters.

tracking_name_from_op()

Returns the tracking name built with the operator’s parameters.

code/api/api/pennylane.labs.resource_estimation.ResourceBasisRotation

 

Download Python script

 

Download Notebook

 

View on GitHub