qml.labs.resource_estimation.ResourceQubitizeTHC

class ResourceQubitizeTHC(compact_ham, prep_op=None, select_op=None, wires=None)[source]

Bases: ResourceOperator

Resource class for qubitization of tensor hypercontracted 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 for which the walk operator is being created

  • prep_op (Union[ResourceOperator, None]) – An optional resource operator, corresponding to the prepare routine. If None, the default ResourcePrepTHC will be used.

  • select_op (Union[ResourceOperator, None]) – An optional resource operator, corresponding to the select routine. If None, the default ResourceSelectTHC will be used.

  • wires (list[int] or optional) – the wires on which the operator acts

Resources:

The resources are calculated based on arXiv:2011.03494

Example

The resources for this operation are computed using:

>>> compact_ham = plre.CompactHamiltonian.thc(num_orbitals=20, tensor_rank=40)
>>> prep = plre.ResourcePrepTHC(compact_ham, coeff_precision=20, select_swap_depth=2)
>>> res = plre.estimate(plre.ResourceQubitizeTHC(compact_ham, prep_op=prep))
>>> print(res)
--- Resources: ---
 Total qubits: 381
 Total gates : 5.628E+4
 Qubit breakdown:
  clean qubits: 313, dirty qubits: 0, algorithmic qubits: 68
 Gate breakdown:
  {'Toffoli': 3.504E+3, 'CNOT': 4.138E+4, 'X': 2.071E+3, 'Hadamard': 9.213E+3, 'S': 80, 'Z': 41}

num_wires

resource_keys

resource_params

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

num_wires = 1
resource_keys = {'compact_ham', 'prep_op', 'select_op'}
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 for which the walk operator is being created

  • prep_op (Union[CompressedResourceOp, None]): An optional compressed resource operator, corresponding to the prepare routine. If None, the default ResourcePrepTHC will be used.

  • select_op (Union[CompressedResourceOp, None]): An optional compressed resource operator, corresponding to the select routine. If None, the default ResourceSelectTHC will be used.

Return type:

dict

adjoint_resource_decomp(*args, **kwargs)

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

controlled_resource_decomp(...[, prep_op, ...])

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[, prep_op, ...])

Returns a list representing the resources of the operator.

resource_rep(compact_ham[, prep_op, select_op])

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, compact_ham, prep_op=None, select_op=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 for which the walk operator is being created

  • prep_op (Union[CompressedResourceOp, None]) – An optional compressed resource operator, corresponding to the prepare routine. If None, the default ResourcePrepTHC will be used.

  • select_op (Union[CompressedResourceOp, None]) – An optional compressed resource operator, corresponding to the select routine. If None, the default ResourceSelectTHC will be used.

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, prep_op=None, select_op=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 for which the walk operator is being created

  • prep_op (Union[CompressedResourceOp, None]) – An optional compressed resource operator, corresponding to the prepare routine. If None, the default ResourcePrepTHC will be used.

  • select_op (Union[CompressedResourceOp, None]) – An optional compressed resource operator, corresponding to the select routine. If None, the default ResourceSelectTHC will be used.

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, prep_op=None, select_op=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 for which the walk operator is being created

  • prep_op (Union[CompressedResourceOp, None]) – An optional compressed resource operator, corresponding to the prepare routine. If None, the default ResourcePrepTHC will be used.

  • select_op (Union[CompressedResourceOp, None]) – An optional compressed resource operator, corresponding to the select routine. If None, the default ResourceSelectTHC will be used.

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.