DataBin

class qiskit.primitives.DataBin(*, shape=(), **data)

ベース： ShapedMixin

単一のパブからの主なデータ返却は、 PubResult.

このオブジェクト内のデータには、属性アクセス（data_bin.my_field）または dict-like文字列キー（data_bin["my_field"]）によってアクセスします。このクラスは Python の不変マッピングとして動作するため、例えば利用可能な keys()キーをでクエリしたり、キーと値の両方を items()で反復処理したりできます。

このクラスには、使用されるプリミティブや送信されるパブに応じて、異なる属性やキーが設定されます。 これらの「特別な」属性には、キーと同じ名前が付けられます。 たとえば、ジョブ SamplerV2 を送信した場合、通常、属性やキーは、このパブを定義する回路内に存在していたオブジェクト ClassicalRegister の名前になります。

すべての属性とキーには、対応するパブの n 次元形状が関連付けられています。 属性とキーは、使用するプリミティブと入力パブに応じて、通常は または numpy.ndarray の BitArray インスタンスとなります。

ユーザーは通常、このクラスを自ら構築することはありません。 代わりに、完全な実行結果の中から単一のパブの結果として PubResult.data フィールドを受け取ります。

例：

import numpy as np
from qiskit.primitives import DataBin, BitArray

data = DataBin(
    alpha=BitArray.from_samples(["0010"]),
    beta=np.array([1.2])
)

print("alpha data:", data.alpha)
print("beta data:", data.beta)

alpha data: BitArray(<shape=(), num_shots=1, num_bits=2>)
beta data: [1.2]

パラメーター

• data - データビンに入れる名前/値データ。
• shape (ShapeInput) – データビン内のすべてのエントリに共通する先頭の形状。 デフォルトは、すべてのオブジェクトと互換性のある () 。

レイズ

• ValueError - 名前がこのクラスのメソッド名と重複している場合。
• ValueError - ある値が提供された形状と矛盾する場合。

属性

ndim

shape

size

方法

items

keys

values