qml.labs.resource_estimation.ResourceControlledSequence

class ResourceControlledSequence(base, num_control_wires, wires=None)

Bases: ResourceOperator

Resource class for the ControlledSequence gate.

This operator represents a sequence of controlled gates, one for each control wire, with the base operator (base) raised to decreasing powers of 2.

Parameters:

• base (ResourceOperator) – The operator that we will be applying controlled powers of.

• num_control_wires (int) – the number of controlled wires to run the sequence over

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

Resources:

The resources are obtained as a direct result of the definition of the operator:

0: ──╭●───────────────┤
1: ──│────╭●──────────┤
2: ──│────│────╭●─────┤
t: ──╰U⁴──╰U²──╰U¹────┤

See also

ControlledSequence

Example

The resources for this operation are computed using:

>>> ctrl_seq = plre.ResourceControlledSequence(
...     base = plre.ResourceRX(),
...     num_control_wires = 3,
... )
>>> gate_set={"CRX"}
>>> print(plre.estimate(ctrl_seq, gate_set))
--- Resources: ---
 Total qubits: 4
 Total gates : 3
 Qubit breakdown:
  clean qubits: 0, dirty qubits: 0, algorithmic qubits: 4
 Gate breakdown:
  {'CRX': 3}

Attributes

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

num_wires = 1

resource_keys = {'base_cmpr_op', 'num_ctrl_wires'}

resource_params

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

Returns:

A dictionary containing the resource parameters:

• base_cmpr_op (CompressedResourceOp): A compressed resource operator, corresponding to the operator that we will be applying controlled powers of.

• num_ctrl_wires (int): the number of controlled wires to run the sequence over

Return type:

dict

Methods

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(base_cmpr_op, ...)	Returns a list representing the resources of the operator.
resource_rep(base_cmpr_op, num_ctrl_wires)	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
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(base_cmpr_op, num_ctrl_wires, **kwargs)

Returns a list representing the resources of the operator. Each object in the list represents a gate and the number of times it occurs in the circuit.

Parameters:

• base_cmpr_op (CompressedResourceOp) – A compressed resource operator, corresponding to the operator that we will be applying controlled powers of.

• num_ctrl_wires (int) – the number of controlled wires to run the sequence over

Resources:

The resources are obtained as a direct result of the definition of the operator:

0: ──╭●───────────────┤
1: ──│────╭●──────────┤
2: ──│────│────╭●─────┤
t: ──╰U⁴──╰U²──╰U¹────┤

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(base_cmpr_op, num_ctrl_wires)

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

Parameters:

• base_cmpr_op (CompressedResourceOp) – A compressed resource operator, corresponding to the operator that we will be applying controlled powers of.

• num_ctrl_wires (int) – the number of controlled wires to run the sequence over

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.

code/api/api/pennylane.labs.resource_estimation.ResourceControlledSequence

 

Download Python script

 

Download Notebook

 

View on GitHub