Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Amazon Braketサポート

タグ: integration

このページでは、Qamomileの量子カーネルをAmazon Braketネイティブ回路へ トランスパイルし、ローカルシミュレータでサンプリングと期待値計算を実行します。 リモート実行時も、同じexecutor境界へAWSデバイスを渡せます。

Qamomileで回路を作る

ランタイムパラメータはBraket回路内にシンボリックなまま残ります。executorは Braketネイティブのinputs APIで値を送り、provider側のコンパイルと パラメータ処理を維持します。

Braketへトランスパイルする

BraketTranspilerはネイティブなbraket.circuits.Circuitを生成します。 終端測定はQamomile側の結果マッピングとして保持され、executorがBraketの 測定量子ビット順を一貫した形へ正規化します。

T  : │      0      │  1  │
      ┌───────────┐       
q0 : ─┤ Ry(theta) ├───●───
      └───────────┘   │   
                    ┌─┴─┐ 
q1 : ───────────────┤ X ├─
                    └───┘ 
T  : │      0      │  1  │

Unassigned parameters: [theta].

ローカルで実行する

デバイスを省略すると、executorはBraketのLocalSimulatorを作成します。

[((1, 1), 128)]
<X> = 0.9999999999999998

AWSデバイスを使う

AwsDeviceをtranspiler.executor(device)へ渡すと、同じjob APIを リモートでも利用できます。submit後は結果取得を待たずにjobが返り、正規化された status、キャンセル、native task、task ARN参照を利用できます。

from braket.aws import AwsDevice

device = AwsDevice("your-device-arn")
options = BraketExecutionOptions(
    s3_destination_folder=("your-bucket", "qamomile-results"),
    poll_timeout_seconds=600,
    poll_interval_seconds=2,
    batch_max_retries=0,
)
aws_executor = transpiler.executor(device, options=options)
job = executable.sample(aws_executor, shots=1_000, bindings={"theta": 0.4})
print(job.status(), job.raw_status())
references = job.references()

# 別processでexecutorを再作成し、raw task resultを復元します。
restored = aws_executor.restore(references[0])
counts = restored.result()

# キャンセルはbest effortで、task参照は失われません。
job.cancel()

retryは追加の課金taskを作る可能性があるため、batch再送はデフォルトで無効です。 意図的に再送する場合だけbatch_max_retriesを設定してください。 poll_timeout_secondsはproviderのpolling制限と、ローカルで結果を待つデフォルト時間を設定します。result(timeout=...)を明示すると、このデフォルト値を上書きします。timeout時もremote taskはキャンセルされません。非同期待機にはawait job.result_async()を利用できます。

リモートタスクにはAWS認証情報とS3出力先が必要で、費用が発生する場合があります。 そのため、このページではローカルシミュレータだけを実行します。

制約

現在のBraketエンジンは静的なgate-model回路を対象としています。測定結果に依存するifやwhileのcontrol flow、mid-circuit reset、およびそれらの操作を必要とするアルゴリズムには対応していません。これには、modular算術やShorアルゴリズムのうちresetに依存する実行経路が含まれます。そのようなプログラムは静的回路へ書き換えるか、必要なdynamic-circuit primitiveを提供するエンジンを選択してください。

まとめ

  • BraketTranspilerはBraketネイティブ回路とフリーパラメータを生成します。

  • BraketExecutorは結果取得を待たず、サンプリングとHamiltonian期待値計算を native taskとしてsubmitします。

  • jobはstatus、キャンセル、native task、復元可能なAWS task参照を公開し、 batch retryは明示的かつ回数制限付きです。

  • AwsDeviceを注入すれば、Qamomileカーネルを再コンパイルせず実行先を切り替えられます。