SamplerV2
class SamplerV2(mode=None, options=None)
ベース: BasePrimitiveV2[SamplerOptions], Sampler、 BaseSamplerV2
Qiskit Runtime Sampler プリミティブ・サービスと対話するためのクラス。
このクラスはサンプラー・インターフェースのバージョン2をサポートしており、バージョン1とは異なる入出力フォーマットを使用する。
Qiskit Runtime サンプラープリミティブは、指定された出力タイプに従ってサンプリングされた結果を返します。 例えば、測定レベル2(ビット)が要求された場合、各ショットのビット列を返す。
この run() メソッドを使用すると、回路とパラメータをSamplerプリミティブに送信できる。
パラメーター
-
mode (BackendV2 | Session |Batch | None) –
プリミティブクエリの実行モード。 これは以下のいずれかです。
詳細については
Execution modes、 Qiskit Runtime のドキュメントを参照してください。 -
options (dict | SamplerOptions | None) – サンプラーのオプションについては、詳細な説明を参照
qiskit_ibm_runtime.options.SamplerOptionsしてください。
属性
mode
このプリミティブが使用する実行モードを返します。
戻り値
このプリミティブが使用するモード。実行モードが使用されない場合は、 None 。
options
タイプ: SamplerOptions
返品方法。
version
デフォルト値: 2
方法
backend
run
run(pubs, *, shots=None)
サンプラー・プリミティブへのリクエストを送信する。
パラメーター
- pubs (Iterable[SamplerPubLike]) – パブのようなオブジェクトの反復可能オブジェクト。
(circuit, parameter_values)たとえば、回路やタプルのリストなど。 - shots (int | None) – 独自のショットを指定しないサンプラーパブごとにサンプリングする合計ショット数。
Noneの場合、プリミティブのデフォルトのショット値が使用される。
戻り値
提出された仕事 ジョブの結果は qiskit.primitives.containers.PrimitiveResult のインスタンスである。
レイズ
ValueError - 無効な引数が与えられている。
戻りの型