qml.labs.resource_estimation.ResourceSelectTHC¶
- class ResourceSelectTHC(compact_ham, rotation_precision=None, select_swap_depth=None, wires=None)[source]¶
Bases:
ResourceOperatorResource class for creating the custom Select operator for tensor hypercontracted Hamiltonian. This operator customizes the Select circuit to use the structure of THC Hamiltonian.
Note
This decomposition assumes that an appropriately sized phase gradient state is available. Users should ensure that the cost of constructing this state has been accounted for. See also
ResourcePhaseGradient.- Parameters:
compact_ham (CompactHamiltonian) – a tensor hypercontracted Hamiltonian on which the select operator is being applied
rotation_precision (int, optional) – The number of bits used to represent the precision for loading the rotation angles for basis rotation. If
Noneis provided, the default value from theresource_configis used.select_swap_depth (int, optional) – A parameter of
ResourceQROMused to trade-off extra qubits for reduced circuit depth. Defaults toNone, which internally determines the optimal depth.wires (list[int] or optional) – the wires on which the operator acts
- Resources:
The resources are calculated based on Figure 5 in arXiv:2011.03494
Example
The resources for this operation are computed using:
>>> compact_ham = plre.CompactHamiltonian.thc(num_orbitals=20, tensor_rank=40) >>> res = plre.estimate(plre.ResourceSelectTHC(compact_ham, rotation_precision=15)) >>> print(res) --- Resources: --- Total qubits: 371 Total gates : 1.959E+4 Qubit breakdown: clean qubits: 313, dirty qubits: 0, algorithmic qubits: 58 Gate breakdown: {'Toffoli': 2.219E+3, 'CNOT': 1.058E+4, 'X': 268, 'Hadamard': 6.406E+3, 'S': 80, 'Z': 41}
Attributes
Returns a dictionary containing the minimal information needed to compute the resources.
- num_wires = 1¶
- resource_keys = {'compact_ham', 'rotation_precision', 'select_swap_depth'}¶
- resource_params¶
Returns a dictionary containing the minimal information needed to compute the resources.
- Returns:
- A dictionary containing the resource parameters:
compact_ham (CompactHamiltonian): a tensor hypercontracted Hamiltonian on which the select operator is being applied
rotation_precision (int, optional): The number of bits used to represent the precision for loading the rotation angles for basis rotation. If
Noneis provided, the default value from theresource_configis used.select_swap_depth (int, optional): A parameter of
ResourceQROMused to trade-off extra qubits for reduced circuit depth. Defaults toNone, which internally determines the optimal depth.
- 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 the 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(compact_ham[, ...])Returns a list representing the resources of the operator.
resource_rep(compact_ham[, ...])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
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 representing the resources for the adjoint of the operator.
- classmethod controlled_resource_decomp(ctrl_num_ctrl_wires, ctrl_num_ctrl_values, compact_ham, rotation_precision=None, select_swap_depth=None, **kwargs)[source]¶
Returns a list representing the resources for the controlled version of the operator.
Note
This decomposition assumes that an appropriately sized phase gradient state is available. Users should ensure that the cost of constructing this state has been accounted for. See also
ResourcePhaseGradient.- 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
compact_ham (CompactHamiltonian) – a tensor hypercontracted Hamiltonian on which the select operator is being applied
rotation_precision (int, optional) – The number of bits used to represent the precision for loading the rotation angles for basis rotation. If
Noneis provided, the default value from theresource_configis used.select_swap_depth (int, optional) – A parameter of
ResourceQROMused to trade-off extra qubits for reduced circuit depth. Defaults toNone, which internally determines the optimal depth.
- Resources:
The resources are calculated based on Figure 5 in arXiv:2011.03494
- 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(compact_ham, rotation_precision=None, select_swap_depth=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.
Note
This decomposition assumes that an appropriately sized phase gradient state is available. Users should ensure that the cost of constructing this state has been accounted for. See also
ResourcePhaseGradient.- Parameters:
compact_ham (CompactHamiltonian) – a tensor hypercontracted Hamiltonian on which the select operator is being applied
rotation_precision (int, optional) – The number of bits used to represent the precision for loading the rotation angles for basis rotation. If
Noneis provided, the default value from theresource_configis used.select_swap_depth (int, optional) – A parameter of
ResourceQROMused to trade-off extra qubits for reduced circuit depth. Defaults toNone, which internally determines the optimal depth.
- Resources:
The resources are calculated based on Figure 5 in arXiv:2011.03494. The resources are modified to remove the control from the Select 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 resource_rep(compact_ham, rotation_precision=None, select_swap_depth=None)[source]¶
Returns a compressed representation containing only the parameters of the Operator that are needed to compute a resource estimation.
- Parameters:
compact_ham (CompactHamiltonian) – a tensor hypercontracted Hamiltonian on which the select operator is being applied
rotation_precision (int, optional) – The number of bits used to represent the precision for loading the rotation angles for basis rotation. If
Noneis provided, the default value from theresource_configis used.select_swap_depth (int, optional) – A parameter of
ResourceQROMused to trade-off extra qubits for reduced circuit depth. Defaults toNone, which internally determines the optimal depth.
- Returns:
the operator in a compressed representation
- Return type:
- 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.