Skip to main content
IBM Quantum Platform

map_edge_vertex_generators

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

a を別の演算子型 EdgeVertexOperator にマッピングする。

これは、 EdgeVertexOperator インスタンス用の新しいマッパーを実装するのを支援するための汎用関数です。 本質的には、演算子の項を単純に順に処理し、遭遇した各項をユーザーが指定した map_action 関数 EdgeAction に適用するだけです。 ユーザーが指定した identity ジェネレータと組み合わせることで、任意の出力型へのマッピングが可能になります。

注

出力型は、. を通じてスカラーとの乗算をサポートしていなければ T なりません __mul__。 もし、. を通じて2つのインスタンスの合成もサポートする必要があるならば compose=None``__and__ 。 SparseObservable そうではないため、以下の例では を明示 compose() 的に指定しています。 を持つ型( __and__ 例: SparsePauliOp)は、デフォルト値を利用できます。

注

以下に記述したマッピングは、この関数を意図的に最小限に簡略化した例であり、その代替となるものではありません edge_vertex_jordan_wigner()。これは最近傍相互作用のみを扱っており、並列化もされておらず、メモリ制限も考慮されていません。 この関数をそのままコピーするのではなく、ライブラリ関数を利用してください。

>>> from qiskit_fermions.mappers import map_edge_vertex_generators
>>> from qiskit_fermions.operators import EdgeAction, EdgeVertexOperator
>>> from qiskit.quantum_info import SparseObservable
>>>
>>> def jordan_wigner_nearest_neighbor(mode: EdgeAction) -> 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"
...         )
...     # The orientation must be compared rather than differenced: an edge operator is
...     # antisymmetric, so the sign depends on the index order while the string does not.
...     lo, hi = min(left, right), max(left, right)
...     coeff = -1.0 if left < right else 1.0
...     return SparseObservable.from_sparse_list(
...         [("YX", [lo, hi], coeff)], num_qubits=num_qubits
...     )
>>>
>>> num_qubits = 4
>>> def identity() -> SparseObservable:
...     return SparseObservable.identity(num_qubits)
>>>
>>> op = EdgeVertexOperator.from_dict({
...     ((0, 0),): 2.0,
...     ((0, 1),): 0.5,
...     ((1, 1), (1, 2)): 1.0,
... })
>>> qop = map_edge_vertex_generators(
...     op, jordan_wigner_nearest_neighbor, identity, compose=SparseObservable.compose
... )
>>> print(sorted(qop.simplify().to_sparse_list()))
[('XX', [1, 2], 1j), ('YX', [0, 1], (-0.5+0j)), ('Z', [0], (2+0j))]

パラメーター

  • operator (EdgeVertexOperator) – マッピング対象となる演算子。
  • map_action (Callable[[tuple[int, int]], T]) – 単一の値を目的の出力型 EdgeAction にマッピングする関数。
  • identity (Callable[[], T]) – 出力型の乗法単位元インスタンスを生成する関数。
  • compose (Callable[[T, T], T] | None) – 2つの出力型インスタンスの合成ロジックを実装するためのオプション関数。 これが指定されていない場合、デフォルトでは が使用されます operator.and_()。

戻り値

マップされた演算子。

戻りの型

T

このページは役に立ちましたか?
バグや誤字の報告、またはコンテンツの要求はGitHubで行ってください。