Skip to main content
IBM Quantum Platform

map_transfer_vertex_generators

map_transfer_vertex_generators(operator, map_action, identity, compose=None)

Associer un opérateur TransferVertexOperator à un autre type d'opérateur.

Il s'agit d'une fonction générique destinée à faciliter la mise en œuvre de nouveaux mappeurs pour les instances TransferVertexOperator . En substance, il se contente de parcourir les termes de l'opérateur, en appliquant à TransferAction chacun d'entre eux la fonction map_action fournie par l'utilisateur. Associé au générateur identity fourni par l'utilisateur, cela permet d'effectuer une mise en correspondance avec des types de sortie arbitraires.

Remarque

Le type de sortie T doit prendre en charge la multiplication par un scalaire via __mul__. Si compose=None elle doit également prendre en charge la composition de deux instances via __and__. SparseObservable ce n'est pas le cas, c'est pourquoi l'exemple ci-dessous le nomme explicitement compose() ; un type comportant un ( __and__ tel que SparsePauliOp) peut s'appuyer sur la valeur par défaut.

Remarque

La cartographie présentée ci-dessous est une illustration délibérément simplifiée de cette fonction; elle ne remplace en aucun cas celle-ci transfer_vertex_jordan_wigner(): elle ne prend en compte que les interactions entre voisins les plus proches et n'est ni parallélisée ni limitée par la mémoire. Utilisez plutôt la fonction de la bibliothèque au lieu de copier celle-ci.

>>> from qiskit_fermions.mappers import map_transfer_vertex_generators
>>> from qiskit_fermions.operators import TransferAction, TransferVertexOperator
>>> from qiskit.quantum_info import SparseObservable
>>>
>>> def jordan_wigner_nearest_neighbor(mode: TransferAction) -> SparseObservable:
...     left, right = mode
...     if left == right:
...         return SparseObservable.from_sparse_list(
...             [("Z", [left], 1.0)], num_qubits=num_qubits
...         )
...     if abs(left - right) != 1:
...         raise NotImplementedError(
...             "This mapping only handles nearest neighbor interactions"
...         )
...     # `T_lr` and `T_rl` differ, so the orientation must be compared rather than
...     # differenced. The coefficient is -1/2 either way; the Pauli letters swap instead.
...     lo, hi = min(left, right), max(left, right)
...     pauli = "XX" if left < right else "YY"
...     return SparseObservable.from_sparse_list(
...         [(pauli, [lo, hi], -0.5)], num_qubits=num_qubits
...     )
>>>
>>> num_qubits = 4
>>> def identity() -> SparseObservable:
...     return SparseObservable.identity(num_qubits)
>>>
>>> op = TransferVertexOperator.from_dict({
...     ((0, 0),): 2.0,
...     ((0, 1),): 0.5,
...     ((1, 1), (1, 2)): 1.0,
... })
>>> qop = map_transfer_vertex_generators(
...     op, jordan_wigner_nearest_neighbor, identity, compose=SparseObservable.compose
... )
>>> print(sorted(qop.simplify().to_sparse_list()))
[('XX', [0, 1], (-0.25+0j)), ('YX', [1, 2], -0.5j), ('Z', [0], (2+0j))]

Paramètres

  • operator (TransferVertexOperator) – l'opérateur à mapper.
  • map_action (Callable[[tuple[int, int]], T]) – la fonction permettant de mapper un élément unique vers TransferAction le type de sortie souhaité.
  • identity (Callable[[], T]) – la fonction permettant de générer l'instance de l'identité multiplicative du type de sortie.
  • compose (Callable[[T, T], T] | None) – une fonction facultative permettant de mettre en œuvre la logique de composition de deux instances de type de sortie. Si cette valeur n'est pas fournie, le système utilisera par défaut operator.and_().

Retours

L'opérateur mappé.

Type de retour

T

Cette page a-t-elle été utile ?
Signaler un bogue, une coquille ou proposer du contenu sur GitHub.