qml.labs.resource_estimation.ResourceSingleExcitation

class ResourceSingleExcitation(precision=None, wires=None)[source]

Bases: ResourceOperator

Resource class for the SingleExcitation gate.

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

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

Resources:

The resources are obtained by decomposing the following matrix into fundamental gates.

\[\begin{split}U(\phi) = \begin{bmatrix} 1 & 0 & 0 & 0 \\ 0 & \cos(\phi/2) & -\sin(\phi/2) & 0 \\ 0 & \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: ──T†──H───S─╭X──RZ-─╭X──S†──H──T─┤
1: ──T†──S†──H─╰●──RY──╰●──H───S──T─┤

See also

SingleExcitation

Example

The resources for this operation are computed using:

>>> se = plre.ResourceSingleExcitation()
>>> print(plre.estimate(se, plre.StandardGateSet))
--- Resources: ---
Total qubits: 2
Total gates : 16
Qubit breakdown:
 clean qubits: 0, dirty qubits: 0, algorithmic qubits: 2
Gate breakdown:
 {'Adjoint(T)': 2, 'Hadamard': 4, 'S': 2, 'Adjoint(S)': 2, 'CNOT': 2, 'RZ': 1, 'RY': 1, 'T': 2}

num_wires

resource_keys

resource_params

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

num_wires = 2
resource_keys = {'precision'}
resource_params

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

Returns:

A dictionary containing the resource parameters:
  • precision (float): error threshold for clifford plus T decomposition of this operation

Return type:

dict

adjoint_resource_decomp(*args, **kwargs)

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

controlled_resource_decomp(...)

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([precision])

Returns a list of GateCount objects representing the operator's resources.

resource_rep([precision])

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

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 representing the resources for the adjoint 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

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(precision=None, **kwargs)[source]

Returns a list of GateCount objects representing the operator’s resources.

Parameters:

precision (float, optional) – error threshold for clifford plus T decomposition of this operation

Resources:

The resources are obtained by decomposing the following matrix into fundamental gates.

\[\begin{split}U(\phi) = \begin{bmatrix} 1 & 0 & 0 & 0 \\ 0 & \cos(\phi/2) & -\sin(\phi/2) & 0 \\ 0 & \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: ──T†──H───S─╭X──RZ-─╭X──S†──H──T─┤
1: ──T†──S†──H─╰●──RY──╰●──H───S──T─┤
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 resource_rep(precision=None)[source]

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

Parameters:

precision (float, optional) – error threshold for clifford plus T decomposition of this operation

Returns:

the operator in a compressed representation

Return type:

CompressedResourceOp

resource_rep_from_op()

Returns a compressed representation directly from the operator

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.