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