BindingsArray

class qiskit.primitives.BindingsArray(data=None, shape=None)

ベース： ShapedMixin

. に対するパラメータ qiskit.QuantumCircuitバインディングの値セットを保存します。

1つのパラメータバインディングセットは、自由 qiskit.circuit.Parameter変数sを持つ回路にバインドする数値を提供します。このクラスのインスタンスは、そのような集合の配列型コレクションを格納します。最も単純な例は、単一のパラメータバインディングセットからなる0次元配列であり、一方、パラメータバインディングセットのn次元配列は、値に対するn次元のスイープを表します。

保存形式は、パラメータに紐付けられた {params_0: values_0,...}配列の辞書です。各配列の最後の次元が回路パラメータ（の一部）をインデックスとして参照する場合、この規約が用いられる。例えば、の最後の次元が values_0 25である場合、これは25個の異なるパラメータに対する結合値の候補 params_0の配列を表し、その先頭形状は結合配列の shape 配列となります。これにより、異なるパラメータの値を1つの大きな配列に格納するか、複数の小さな配列に分けて格納するかについて、柔軟に対応できます。

import numpy as np
from qiskit.primitives import BindingsArray

# 0-d array (i.e. only one binding)
BindingsArray({"a": 4, ("b", "c"): [5, 6]})

# single array, last index is parameters
parameters = tuple(f"a{idx}" for idx in range(100))
BindingsArray({parameters: np.ones((10, 10, 100))})

# multiple arrays, where each last index is parameters. notice that it's smart enough to
# figure out that a missing last dimension corresponds to a single parameter.
BindingsArray(
    {("c", "a"): np.zeros((10, 10, 2)), "b": np.ones((10, 10))}
)

. を初期化する BindingsArray。

引 shape 数は、渡された配列から一意に推測できる場合は、必ずしも明示的に指定する必要はありません。エントリのキーがパラメータ data を1つしか含まず、かつ対応する配列の次元数が1で終わる場合、曖昧さが生じます。この場合、それがパラメータに対するインデックスなのか、それともに組み込むべき shapeなのかは判断できません。

オブジェクトはfloat型の値のみ Parameter を表現できるため、このクラスは渡されたすべての値をfloat型にキャストします。複素数など、互換性のないデータ型が指定された場合、例外 TypeError が発生します。

パラメーター

data (BindingsArrayLike | None) – 1つ以上のパラメータから、それらをバインドする値の配列へのマッピング。ここで、最後の軸はパラメータを扱う。
shape (ShapeInput | None) – これらのバインディングにおける各配列の先頭要素。

昇給