実行者のオプションを指定する

このページのコードは、以下の要件に基づいて開発されました。これらのバージョン以降のご利用をお勧めします。
```
qiskit-ibm-runtime~=0.46.1
```

オプションを使用して、Executorプリミティブをカスタマイズすることができます。 SamplerやEstimatorとは異なり、Executorにはオプションがほとんどありません。これは、設計意図の大部分がsamplexに組み込まれているためです。

ノート

プリミティブの初期化中または初期化後に、利用可能なオプションを確認したり、オプションの値を更新したりすることができます。
この update() メソッドを使用して、属性 options に変更を適用します。
この options 属性は、 Python 型です dataclass 。組み込み asdict のメソッドを使って、それを辞書に変換することができます。
Executorは、samplexにエンコードされた情報のみを処理できます。制限事項については、 Samplomaticのガイドをご参照ください。

実行者のオプションを設定する

プリミティブの初期化中と初期化後の両方でオプションが指定された場合、プリミティブの初期化後に設定された値が使用されます。

プリミティブ型の初期化

Executor を初期化する際、オプションクラスのインスタンスまたは辞書を渡すことができ、これによりそれらのオプションのコピーが作成されます。したがって、元の辞書やオプションのインスタンスを変更しても、プリミティブが所有するオプションには影響しません。

オプションクラス

この Executor クラスのインスタンスを作成する際、オプションクラスのインスタンスを渡すことができます。 run() これらのオプションは、計算を実行する際に適用されます。オプションは次の形式で指定してください： options.option.sub-option.sub-sub-option = choice. 例: options.environment.log_level = INFO。

例:

from qiskit_ibm_runtime import QiskitRuntimeService, Executor
from qiskit_ibm_runtime.options import ExecutorOptions

service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)

options = ExecutorOptions(
    environment={"log_level": "INFO"},
    execution={"init_qubits": True},
)

# or use the following instead:

options = ExecutorOptions()
options.environment.log_level = "INFO"
options.execution.init_qubits = True

executor = Executor(mode=backend, options=options)

辞書

Executor を初期化する際、オプションを辞書として指定することができます。

from qiskit_ibm_runtime import QiskitRuntimeService, Executor

service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)

# Setting options during primitive initialization
executor = Executor(
    backend,
    options={
        "environment": {"log_level": "INFO"},
        "execution": {"init_qubits": True},
    },
)

使用可能なオプション

qiskit-ibm-runtime以下の表は、最新バージョンの.のオプションをまとめたものです。以前のオプションのバージョンを確認するには、[ここ qiskit-ibm-runtime APIリファレンス ](リンク) にアクセスし、以前のバージョンを選択してください。

environment APIドキュメント
- タグ一覧。
  選択肢 ：なし
  既定値 ：なし
- 選択肢 ：DEBUG、INFO、WARNING、ERROR、CRITICAL
  デフォルト : WARNING
- 選択肢 ： True, False
  既定値 ： False
- 選択肢 ： [1 から 10800 までの]範囲の秒数（整数）
  デフォルト : 10800 (3時間)
execution APIドキュメント
- ショットごとに量子ビットを基底状態にリセットするかどうか。
  選択肢 ： True, False
  既定値 ： True
- 測定とその後の量子回路の実行との間の時間差。
  選択肢 ：指定された範囲内の値 backend.rep_delay_range
  デフォルト ：指定された値 backend.default_rep_delay
- 選択肢 ： classified, kerneled, avg_kerneled
  既定値 ： classified
利用可能な場合は、実験的なオプション。

次のステップ

推奨事項

ExecutionOptionsV2 のAPIドキュメントを確認してください。
EnvironmentOptions のAPIドキュメントを確認してください。

このページは役に立ちましたか？

バグや誤字の報告、またはコンテンツの要求はGitHubで行ってください。