SamplerV2
class SamplerV2(mode=None, options=None)
ベース： BasePrimitiveV2[SamplerOptions], Sampler、 BaseSamplerV2
SamplerV2 IBM Quantum Compute （旧称： Qiskit Runtime ）のプリミティブ。
このクラスはサンプラー・インターフェースのバージョン2をサポートしており、バージョン1とは異なる入出力フォーマットを使用する。
IBM Quantum Compute Samplerプリミティブは、指定された出力型に従ってサンプリング結果を返します。 たとえば、測定レベル 2（ビット）が指定された場合、ショットごとにビット文字列が返されます。
この run() メソッドを使用すると、回路とパラメータをSamplerプリミティブに送信できる。
パラメーター
-
mode (BackendV2 | Session |Batch | None) –
プリミティブクエリの実行モード。 これは以下のいずれかです。
. に関する詳細については、『 IBM Quantum Compute 』のドキュメントを参照してください
Execution modes。 -
options (dict | options.SamplerOptions | None) – サンプラーのオプションについては、詳細な説明
qiskit_ibm_runtime.options.SamplerOptionsを参照してください。
属性
mode
このプリミティブが使用する実行モードを返します。
戻り値
このプリミティブが使用するモード。実行モードが使用されない場合は、 None 。
options
返品方法。
version
デフォルト値: 2
方法
backend
run
run(pubs, *, shots=None, dry_run=False)
サンプラー・プリミティブへのリクエストを送信する。
パラメーター
- pubs (Iterable[SamplerPubLike]) – パブのようなオブジェクトの反復可能オブジェクト。
(circuit, parameter_values)たとえば、回路やタプルのリストなど。 - shots (int | None) – 独自のショットを指定しないサンプラーパブごとにサンプリングする合計ショット数。
Noneの場合、プリミティブのデフォルトのショット値が使用される。 - dry_run (bool) – の場合
True、QPU上でジョブを実行せずにドライランを実行します。 このモードを使用すると、ジョブの検証、使用量の推定、および回路タイミングのメタデータの取得を行うことができます。 返される結果は、想定されるスキーマを維持していますが、実際の測定結果やシミュレーション結果ではなく、 ランダム化された模擬データが含まれています。 偽のバックエンドとは異なり、このドライランの処理はサーバー側で行われるため、ジョブがすぐに完了しない場合があり、この機能へのアクセスが制限される可能性があります。
戻り値
提出された仕事 ジョブの結果は qiskit.primitives.containers.PrimitiveResult のインスタンスである。
レイズ
ValueError - 無効な引数が与えられている。
戻りの型