{
"cells": [
{
"cell_type": "markdown",
"id": "0d58aa59",
"metadata": {},
"source": [
"---\n",
"title: \"QESEM - QedmaによるQiskit関数\"\n",
"description: \"ノイズの多い量子プロセッシングユニット（QPU）上で量子回路を実行し、基礎的な限界値に近い高効率なQPU時間オーバーヘッドで、高精度かつエラーのない結果を得る。\"\n",
"---\n",
"\n",
"{/* cspell:ignore DESY Multibase, Quasicrystal, Downfolding, Aharonov, Goldack, wavefunctions, Sakuma */}\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "dde95705",
"metadata": {},
"source": [
"\n",
"\n",
"# QESEM: QedmaによるQiskit関数\n",
"\n",
"*[APIリファレンス](/docs/api/functions/qedma-qesem)を参照してください*\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "6256578e",
"metadata": {
"tags": [
"version-info"
]
},
"source": [
"{/*\n",
" DO NOT EDIT THIS CELL!!!\n",
" This cell's content is generated automatically by a script. Anything you add\n",
" here will be removed next time the notebook is run. To add new content, create\n",
" a new cell before or after this one.\n",
" */}\n",
"\n",
"\n",
" \n",
" このページのコードは、以下の要件に基づいて開発されました。\n",
" これらのバージョン、またはそれ以降のバージョンの使用をお勧めします。\n",
"\n",
" ```\n",
" qiskit[all]~=2.5.0\n",
" qiskit-ibm-runtime~=0.47.0\n",
" ```\n",
" \n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "13528739",
"metadata": {},
"source": [
"\n",
" Qiskit 関数は、 IBM Quantum® Premium Plan、Flex Plan、およびオンプレム ( IBM Quantum Platform API 経由) Plan ユーザーだけが利用できる実験的な機能です。 これらはプレビューリリースの状態であり、変更される可能性がある。\n",
"\n",
"\n",
"\n",
"\n",
"## 概要\n",
"\n",
"量子処理装置は近年著しく進歩したものの、ノイズや既存ハードウェアの不完全性に起因するエラーは、量子アルゴリズム開発者にとって依然として核心的な課題である。 量子計算が実用規模に近づき、古典的に検証できない段階に差し掛かるにつれ、保証された精度でノイズを打ち消す解決策がますます重要になってきている。 この課題を克服するため、Qedmaは量子エラー軽減（QESEM）を開発し、 IBM Quantum Platform に [Qiskit関数](/docs/guides/functions)としてシームレスに統合しました。\n",
"\n",
"QESEM を使用することで、ユーザーはノイズの多い QPU 上で量子回路を実行し、QPU 時間のオーバーヘッドを最小限に抑えつつ、基本限界に近い高精度でエラーのない結果を得ることができます。 これを実現するため、QESEMは、特性評価とエラー低減のためにQedmaが開発した一連の独自手法を活用しています。 エラー低減手法には、ゲート最適化、ノイズを考慮したトランスパイレーション、エラー抑制（ES）、およびバイアスのないエラー軽減（EM）などがある。 これらの特性評価に基づく手法を組み合わせることで、ユーザーは汎用的な大規模量子回路について、信頼性が高く誤りのない結果を得ることができ、他の方法では実現できない応用分野を切り拓くことができます。\n",
"\n",
"基盤となる構成要素の詳細な説明および実用規模の実証については、論文 [『実用規模量子回路のための信頼性の高い高精度誤差軽減』](https://arxiv.org/abs/2508.10997) を参照のこと。\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "5f761442",
"metadata": {},
"source": [
"\n",
"\n",
"## 説明\n",
"\n",
"Qedma社のQESEM機能を使用することで、誤差を抑制・軽減しながら簡単に回路を見積もり、実行することができ、より大きな回路ボリュームとより高い精度を達成することができます。 QESEMを使用するには、量子回路、測定する観測値のセット、各観測値の目標とする統計精度、そして選択したQPUを用意する。 目標精度まで回路を実行する前に、回路の実行を必要としない解析的な計算に基づいて、必要なQPU時間を見積もることができます。 QPUの時間見積もりに満足したら、QESEMで回路を実行します。\n",
"\n",
"回路を実行すると、QESEMは回路に合わせて調整されたデバイス特性評価プロトコルを実行し、回路内で発生する誤差に対する信頼性の高いノイズモデルを生成します。 特性評価に基づき、QESEMはまずノイズを考慮したトランスパイレーションを実装し、入力回路を物理量子ビットとゲート群にマッピングする。これにより、対象観測量に影響するノイズを最小化する。 これには、ネイティブで利用可能なゲート（ IBM® デバイス上のCX/CZ）に加え、QESEMによって最適化された追加ゲートが含まれ、QESEMの拡張ゲートセットを形成する。 QESEMはその後、QPU上で特性評価に基づくES回路とEM回路のセットを実行し、それらの測定結果を収集する。 これらはその後、要求された精度に対応する各観測量について、不偏期待値と誤差棒を提供するために従来通りの後処理が施される。\n",
"\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "74823696",
"metadata": {},
"source": [
"QESEMは、さまざまな量子アプリケーションで、現在実現可能な最大容量の回路で、高精度の結果を提供できることが実証されている。 QESEMには以下のようなユーザー向け機能があり、以下のベンチマークセクションで実証されています：\n",
"\n",
"* **保証された精度：** QESEMは観測量の期待値に対する偏りのない推定値を出力する。 そのEM手法は理論的保証を備えており、Qedmaの最先端特性評価と相まって、ユーザー指定の精度までノイズのない回路出力への収束を保証する。 多くのヒューリスティックなEM法が系統的な誤差やバイアスを生じやすいのとは対照的に、QESEMの保証された精度は、汎用量子回路および観測量において信頼性の高い結果を得るために不可欠である。\n",
"* **大規模QPUへの拡張性：** QESEMのQPU処理時間は回路体積に依存するが、それ以外では量子ビット数に依存しない。 Qedmaは、 IBM Quantum の127量子ビットEagleデバイスおよび133量子ビットHeronデバイスを含む、現在利用可能な最大規模の量子デバイス上でQESEMを実証した。\n",
"* **アプリケーションにとらわれない：** QESEMは、ハミルトニアンシミュレーション、VQE、QAOA、振幅推定など、さまざまなアプリケーションで実証されている。 ユーザーは測定したい量子回路や観測値を入力し、誤差のない正確な結果を得ることができる。 唯一の制限は、ハードウェアの仕様と割り当てられたQPU時間によって決まり、アクセス可能な回路ボリュームと出力精度を決定する。 対照的に、多くのエラー削減ソリューションは、アプリケーションに特化したものであったり、制御不能なヒューリスティックを含んでいたりするため、一般的な量子回路やアプリケーションには適用できない。\n",
"* **拡張ゲートセット：** QESEMは分数角度ゲートをサポートし、 IBM Quantum Heron およびEagleデバイス上でQedma最適化済み分数角度 $Rzz(\\theta)$ ゲートを提供します。 この拡張ゲートセットにより、コンパイル効率が向上し、デフォルトのCX/CZコンパイルと比較して最大2倍の回路容量を実現します。\n",
"* **マルチベース観測量** QESEMは、一般的なハミルトニアンのような多数の非共約パウリ文字列から構成される入力観測値をサポートしています。 測定ベースの選択とQPUのリソース割り当て（ショットと回路）の最適化は、QESEMによって自動的に実行され、要求された精度に対してQPUの所要時間を最小化します。 ハードウェアの忠実度と実行速度を考慮したこの最適化により、より深い回路を実行し、より高い精度を得ることができる。\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "57b41ab0",
"metadata": {},
"source": [
"\n",
"\n",
"## ベンチマーク\n",
"\n",
"QESEMは様々なユースケースやアプリケーションでテストされている。 以下の例は、QESEMで実行できるワークロードのタイプを評価するのに役立ちます。\n",
"\n",
"与えられた回路と観測値に対して、エラー緩和と古典的シミュレーションの両方の困難さを定量化するための重要な数値は、 **アクティブボリューム** ：回路内の観測値に影響を与えるCNOTゲートの数である。 アクティブボリュームは、回路の奥行きと幅、観測可能な重さ、そして観測可能なライトコーンを決定する回路構造に依存する。 詳細は、 [2024年 IBM 量子サミットの](https://www.youtube.com/watch?v=Hd-IGvuARfE\\&t=1730s)講演をご覧ください。 QESEMは大容量領域で特に大きな価値を提供し、一般的な回路や観測値に対して信頼性の高い結果を与えます。\n",
"\n",
"\n",
"\n",
"| アプリケーション | 量子ビット数 | デバイス | 回路の説明 | 正確性 | 合計時間 | ランタイム使用量 |\n",
"| ---------------------- | ------ | ----------- | ------------------------------------ | --- | ------ | -------- |\n",
"| VQE回路 | 8 | イーグル ( r3 ) | 全21層、9測定ベース、 1D チェーン | 98％ | 35 分 | 14 最小 |\n",
"| キック・イジング | 28 | イーグル ( r3 ) | 独自レイヤー3層×3ステップ、 2D ヘビーヘキストポロジー | 97% | 22分 | 4分 |\n",
"| キック・イジング | 28 | イーグル ( r3 ) | 独自レイヤー3層×8ステップ、 2D ヘビーヘキストポロジー | 97% | 116分 | 23分 |\n",
"| トロッター化ハミルトニアン・シミュレーション | 40 | イーグル ( r3 ) | 2 ユニークレイヤー x 10 トロッターステップ、 1D チェーン | 97% | 3 時間 | 25 分 |\n",
"| トロッター化ハミルトニアン・シミュレーション | 119 | イーグル ( r3 ) | 3ユニークレイヤー×9トロッターステップ、 2D ヘビーヘキストポロジー | 95% | 6.5 時間 | 45 分 |\n",
"| キック・イジング | 136 | ヘロン ( r2 ) | 独自レイヤー3層×15ステップ、 2D ヘビーヘキストポロジー | 99％ | 52分 | 9 分 |\n",
"\n",
"精度は観測値の理想値に対して相対的に測定されます： $\\frac{\\langle O \\rangle_{ideal} - \\epsilon}{\\langle O \\rangle_{ideal}}$ ここで、' $\\epsilon$ ' は（ユーザー入力によって設定された）緩和の絶対精度であり、 $\\langle O \\rangle_{ideal}$ はノイズのない回路での観測値である。\n",
"ランタイム使用量」はバッチモードでのベンチマークの使用量（個々のジョブの使用量の合計）を測定し、「合計時間」はセッションモードでの使用量（実験ウォール時間）を測定します。 QESEMは両方のモードで実行できるため、ユーザーは利用可能なリソースを最大限に活用できます。\n",
"\n",
"28量子ビットのキックド・イジング回路は、新庄ら（参照）により研究された離散時間準結晶をシミュレートしている。 [arXiv 2403.16718](https://arxiv.org/abs/2403.16718) および [Q2B24 東京](https://www.youtube.com/watch?v=tQW6FdLc6zo) ）。 $| \\psi_0 \\rangle = | 0 \\rangle ^{\\otimes n}$ ここで用いた回路パラメータは、強磁性初期状態 $(\\theta_x, \\theta_z) = (0.9 \\pi, 0)$ である。測定された観測値は磁化の絶対値 $M = |\\frac{1}{28} \\sum_{i=0}^{27} \\langle Z_i \\rangle|$ である。実用規模のKicked Ising実験がibm\\_fezの136個の最良量子ビットで実行された。この特別なベンチマークはクリフォード角 $(\\theta_x, \\theta_z) = (\\pi, 0)$ で実行され、回路の深さとともにアクティブ体積がゆっくり成長する。\n",
"\n",
"トロッター化ハミルトニアンシミュレーション回路は、分数角での横磁場イジングモデルのためのものである： $(\\theta_{zz}, \\theta_x) = (\\pi / 4, \\pi /8)$ と $(\\theta_{zz}, \\theta_x) = (\\pi / 6, \\pi / 8)$ に対応する（ [Q2B24 東京](https://www.youtube.com/watch?v=tQW6FdLc6zo)参照）。 ユーティリティ・スケールの回路はibm\\_brisbaneのベスト119量子ビットで実行され、40量子ビットの実験は利用可能なベスト・チェーンで実行された。 精度は磁化について報告されているが、より高重量の観測値についても高精度の結果が得られている。\n",
"\n",
"VQE回路は、ドイツ電子シンクロトロン（DESY）の量子技術・応用センターの研究者とともに開発された。 ここで対象とした観測量は、多数の非共約パウリ弦からなるハミルトニアンであり、QESEMが多基底観測量に対して最適化された性能を持つことを強調している。 ミティゲーションは、古典的に最適化されたansatzに適用された。これらの結果はまだ未発表であるが、同様の構造特性を持つ異なる回路に対しても同質の結果が得られるであろう。\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "d6fb65de",
"metadata": {},
"source": [
"\n",
"\n",
"## 使用を開始する\n",
"\n",
"[IBM Quantum Platform](http://quantum.cloud.ibm.com/) のAPIキーを使用して認証を行い、次のように「QESEM Qiskit Function」を選択してください。 （このスニペットは[、アカウントが](/docs/guides/functions-get-started#install-qiskit-functions-catalog-client)すでにローカル環境に保存されていることを前提としています。）\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "95a715d2",
"metadata": {},
"outputs": [],
"source": [
"import qiskit\n",
"from qiskit_ibm_catalog import QiskitFunctionsCatalog\n",
"\n",
"catalog = QiskitFunctionsCatalog(channel=\"ibm_quantum_platform\")\n",
"\n",
"# verify that you have access to the function\n",
"catalog.list()"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "2d78b033",
"metadata": {},
"outputs": [],
"source": [
"# load the function\n",
"qesem_function = catalog.load(\"qedma/qesem\")"
]
},
{
"cell_type": "markdown",
"id": "5f0120d8",
"metadata": {},
"source": [
"\n",
"\n",
"## 例\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "7d102971",
"metadata": {},
"source": [
"\n",
"\n",
"### 工数見積もりの事例\n",
"\n",
"`backend_name`時間推定ジョブは、与えられた `pub` および に対して必要な QPU 時間を推定するのに役立ちます。 `fake_fez``backend_name` また、任意のシミュレータ・バックエンドに設定することも可能です。例えば、.\n",
"\n",
"QESEMは、準確率論的かつ特性評価に基づくEM法を採用している。 この手法には、おおむね次のように比例するQPUの時間オーバーヘッドがあります：\n",
"\n",
"$T_{QPU} = a \\frac{e^{\\alpha IF\\cdot V_a}}{\\epsilon^2} + b$\n",
"\n",
"ここで、 $V_a$ は回路の有効体積、 $\\epsilon$ は目標精度、 $IF$ はネイティブゲートの不完全度である。\n",
"\n",
"なお、 `\"estimate_time_only\": \"empirical\"` ジョブに必要な時間を推定するために数分間のQPU時間が使用されます（バックエンドが実デバイスである場合。シミュレータの場合は、QPU時間は使用されません）。 通常、これには5分ほどかかりますが、10分を超えることはありません。 実測時間推定ジョブと緩和ジョブの間で不確実性が劇的に変化した場合、QPUの所要時間も劇的に変化します。\n",
"\n",
"手始めに、与えられた `pub` に対してQESEMを実行するために必要なQPU時間を見積もる基本的な例を試してみてください：\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "d56e1440",
"metadata": {},
"outputs": [],
"source": [
"backend_name = \"fake_fez\"\n",
"\n",
"circ = qiskit.QuantumCircuit(5)\n",
"circ.cx(0, 1)\n",
"circ.cx(2, 3)\n",
"circ.cx(1, 2)\n",
"circ.cx(3, 4)\n",
"\n",
"avg_magnetization = qiskit.quantum_info.SparsePauliOp.from_sparse_list(\n",
" [(\"Z\", [q], 1 / 5) for q in range(5)], num_qubits=5\n",
")\n",
"other_observable = qiskit.quantum_info.SparsePauliOp.from_sparse_list(\n",
" [(\"ZZ\", [0, 1], 1.0), (\"XZ\", [1, 4], 0.5)], num_qubits=5\n",
")\n",
"\n",
"time_estimation_job = qesem_function.run(\n",
" pubs=[(circ, [avg_magnetization, other_observable])],\n",
" options={\n",
" \"estimate_time_only\": \"empirical\",\n",
" },\n",
" backend_name=backend_name, # example: \"fake_fez\", \"ibm_fez\"\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 4,
"id": "a6eb4bda04796ac5",
"metadata": {
"ExecuteTime": {
"end_time": "2026-05-03T12:04:42.901739Z",
"start_time": "2026-05-03T12:02:20.288020Z"
}
},
"outputs": [],
"source": [
"time_estimate_result = (\n",
" time_estimation_job.result()\n",
") # a list of results per pub (circuit)"
]
},
{
"cell_type": "markdown",
"id": "5ec8053b",
"metadata": {},
"source": [
"以下のコードスニペットは、時間推定ジョブからさまざまな実行メトリクスを取得する方法を示しています（`estimate_time_only` が設定されている場合）：\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 106,
"id": "77a9dca8efb1a37b",
"metadata": {
"ExecuteTime": {
"end_time": "2026-05-12T11:22:06.848571Z",
"start_time": "2026-05-12T11:22:06.838844Z"
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"The estimated QPU time for mitigation for this PUB is: 300\n",
"The QPU time that this time estimation job took is (here it is 0 because we used fake_fez): 0\n",
"Gates fidelity measured during the experiment: {'CZ': 0.9951354916722668, 'ID1Q': 0.9991246627329172}\n",
"Total shots: 220000\n",
"Resource usage breakdown: {'RUNNING: MAPPING': {'CPU_TIME': 33.6066133165732, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}, 'RUNNING: OPTIMIZING_FOR_HARDWARE': {'CPU_TIME': 184.53575124032795, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}, 'RUNNING: WAITING_FOR_QPU': {'CPU_TIME': 0.0, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}, 'RUNNING: EXECUTING_QPU': {'CPU_TIME': 0.0, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}, 'RUNNING: POST_PROCESSING': {'CPU_TIME': 0.0, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}}\n"
]
}
],
"source": [
"pub_result = time_estimate_result[0]\n",
"\n",
"print(\n",
" f\"The estimated QPU time for mitigation for this PUB is: {pub_result.metadata['time_estimation_sec']}\"\n",
")\n",
"print(\n",
" f\"The QPU time that this time estimation job took is (here it is 0 because we used fake_fez): {pub_result.metadata['total_qpu_time']}\"\n",
")\n",
"print(\n",
" f\"Gates fidelity measured during the experiment: {pub_result.metadata['gate_fidelities']}\"\n",
")\n",
"print(f\"Total shots: {pub_result.metadata['total_shots']}\")\n",
"print(f\"Resource usage breakdown: {pub_result.metadata['resource_usage']}\")"
]
},
{
"cell_type": "markdown",
"id": "5f68f983189f00a1",
"metadata": {},
"source": [
"経験的な時間推定が有効になっている場合、QESEMは少数の回路を実行し、より正確なQPU時間の推定値を算出します。 これらの回路による緩和の結果は、ジョブの【 `empirical_estimation_mitigation_results` フィールド】で確認できます。\n",
"\n",
"これらの結果は限られた数の回路のサンプルから導き出されたものであるため、QESEMによる緩和作業全体から得られた最終結果に比べ、精度はかなり低い。 ただし、回路が小規模である場合や、目標とする精度が低い場合には、経験的な時間推定の過程で行われる緩和措置だけで所望の精度に達することがあり、完全な緩和処理は必要ない場合もある。\n",
"\n",
"この `empirical_estimation_mitigation_results` フィールドは、入力パラメータごとにオブジェクトの `PrimitiveResult` リストで構成されています。 回路がパラメータ化されていない場合、リストの長さは1になります。\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 6,
"id": "7acca648911dacd5",
"metadata": {
"ExecuteTime": {
"end_time": "2026-05-05T13:41:38.131003Z",
"start_time": "2026-05-05T13:41:38.127666Z"
}
},
"outputs": [],
"source": [
"empirical_estimation_mitigation_results = time_estimate_result[0].metadata[\n",
" \"empirical_estimation_mitigation_results\"\n",
"][0] # a list per parameter"
]
},
{
"cell_type": "code",
"execution_count": 12,
"id": "60b482803339ce27",
"metadata": {
"ExecuteTime": {
"end_time": "2026-05-05T15:23:58.817671Z",
"start_time": "2026-05-05T15:23:58.811680Z"
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Partial results for the observables:\n",
" Mitigated expectation values: [1.00347302 1.00693905]\n",
" Mitigated error bars: [0.00304061 0.00714276]\n",
" Number of shots used for mitigation: 180000\n",
" Qubit mapping: [[[0, 136], [1, 143], [2, 142], [3, 141], [4, 140]]]\n",
" Number of measurement bases: 2\n",
"\n",
"Results for each observable:\n",
"Observable 1: ObservablesArray({'IIIIZ': 0.2, 'IIIZI': 0.2, 'IIZII': 0.2, 'IZIII': 0.2, 'ZIIII': 0.2}, shape=())\n",
" QESEM mitigated value: 1.003473015776871 ± 0.0030406128032204015\n",
"Observable 2: ObservablesArray({'IIIZZ': 1.0, 'ZIIXI': 0.5}, shape=())\n",
" QESEM mitigated value: 1.0069390542613554 ± 0.0071427606736885925\n"
]
}
],
"source": [
"print(\"Partial results for the observables:\")\n",
"\n",
"print(\n",
" f\" Mitigated expectation values: {empirical_estimation_mitigation_results.data.evs}\"\n",
")\n",
"print(\n",
" f\" Mitigated error bars: {empirical_estimation_mitigation_results.data.stds}\"\n",
")\n",
"print(\n",
" f\" Number of shots used for mitigation: {empirical_estimation_mitigation_results.metadata['mitigation_shots']}\"\n",
")\n",
"transpiled_circ = empirical_estimation_mitigation_results.metadata[\n",
" \"transpiled_circ\"\n",
"]\n",
"print(f\" Qubit mapping: {transpiled_circ['qubit_maps']}\")\n",
"print(\n",
" f\" Number of measurement bases: {transpiled_circ['num_measurement_bases']}\\n\"\n",
")\n",
"\n",
"# results per obs\n",
"emp_obs_results = empirical_estimation_mitigation_results.metadata[\"results\"][\n",
" 0\n",
"]\n",
"# print(f\"Results for each observable: {results}\")\n",
"print(\"Results for each observable:\")\n",
"\n",
"for i, (obs_array, result_dict) in enumerate(emp_obs_results):\n",
" # obs_array, result_dict = results\n",
" print(f\"Observable {i+1}: {obs_array}\")\n",
" print(\n",
" f\" QESEM mitigated value: {result_dict['qesem']['value']} \\u00b1 {result_dict['qesem']['error_bar']}\"\n",
" )"
]
},
{
"cell_type": "markdown",
"id": "ae10a4c8",
"metadata": {},
"source": [
"\n",
"\n",
"### QESEMの緩和策ジョブの例\n",
"\n",
"次の例では、QESEMジョブを実行します：\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "e7351d6b",
"metadata": {
"ExecuteTime": {
"end_time": "2026-05-05T13:42:11.391952Z",
"start_time": "2026-05-05T13:42:01.266109Z"
}
},
"outputs": [],
"source": [
"sample_job = qesem_function.run(\n",
" pubs=[(circ, [avg_magnetization, other_observable])],\n",
" backend_name=backend_name, # example: \"ibm_fez\"\n",
" # options = {\n",
" # \"estimate_time_only\": \"empirical\",\n",
" # \"default_precision\": 0.2, # Default precision is applied to all pubs that don't have a precision specified, see API reference for more details\n",
" # \"max_execution_time\": 3600, # You can specify a maximum QPU time in seconds, see API reference for more details\n",
" # \"transpilation_level\": \"standard\", # \"minimal_with_layout_opt\" for minimal transpilation, see API reference for more details\n",
" # \"parallel_execution\": True, # True for parallel execution, see API reference for more details\n",
" # },\n",
")"
]
},
{
"cell_type": "markdown",
"id": "f7f7fe68",
"metadata": {},
"source": [
"各入力フィールドおよびオプションの詳細については、 [QESEM API リファレンス](/docs/api/functions/qedma-qesem)を参照してください。\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "dfe99043",
"metadata": {},
"source": [
"使い慣れたQiskit Serverless APIを使って、Qiskit Functionのワークロードの状態をチェックしたり、結果を返したりできます：\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 25,
"id": "856fe992",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"3ac6b2df-15b0-4dc0-8f48-cf14bd20a1c8\n",
"DONE\n"
]
}
],
"source": [
"# Print the ID so you can use it later, if necessary\n",
"print(sample_job.job_id)\n",
"print(sample_job.status())\n",
"sample_result = sample_job.result()"
]
},
{
"cell_type": "markdown",
"id": "a9e51542",
"metadata": {},
"source": [
"以下のコードスニペットは、緩和策の結果と実行メトリクスを取得する方法を示しています。 これらには、さまざまなパラメータがQESEMの実行にどのような影響を与えるかをより深く理解するために不可欠なデータが含まれています。 また、自身の研究に基づいて論文を書く際にも参考になるかもしれません。\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 50,
"id": "117c2e4aa624ed51",
"metadata": {
"ExecuteTime": {
"end_time": "2026-05-12T11:23:45.739919Z",
"start_time": "2026-05-12T11:23:45.737884Z"
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"\n",
"PUB 0:\n",
" The QPU time that this job took is (here it is 0 because we used fake_fez): 0.0\n",
" Gates fidelity measured during the experiment: {'CZ': 0.9953704216147041, 'ID1Q': 0.9991834123567518}\n",
" Total shots: 446000\n",
" Number of shots used for mitigation: 194000\n",
" Resource usage breakdown: {'RUNNING: MAPPING': {'CPU_TIME': 32.52745003718883, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}, 'RUNNING: OPTIMIZING_FOR_HARDWARE': {'CPU_TIME': 257.850521848537, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}, 'RUNNING: WAITING_FOR_QPU': {'CPU_TIME': 0.0, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}, 'RUNNING: EXECUTING_QPU': {'CPU_TIME': 0.0, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}, 'RUNNING: POST_PROCESSING': {'CPU_TIME': 0.0, 'GPU_TIME': 0.0, 'QPU_TIME': 0.0}}\n"
]
}
],
"source": [
"for pub_idx, pub_result in enumerate(\n",
" sample_result\n",
"): # each element in the list is a result for a different pub, here we sent only one pub\n",
" print(f\"\\nPUB {pub_idx}:\")\n",
" print(\n",
" f\" The QPU time that this job took is (here it is 0 because we used fake_fez): {pub_result.metadata['total_qpu_time']}\"\n",
" )\n",
" print(\n",
" f\" Gates fidelity measured during the experiment: {pub_result.metadata['gate_fidelities']}\"\n",
" )\n",
" print(f\" Total shots: {pub_result.metadata['total_shots']}\")\n",
" print(\n",
" f\" Number of shots used for mitigation: {pub_result.metadata['mitigation_shots']}\"\n",
" )\n",
" print(\n",
" f\" Resource usage breakdown: {pub_result.metadata['resource_usage']}\"\n",
" )"
]
},
{
"cell_type": "markdown",
"id": "3f71cc3a",
"metadata": {},
"source": [
"`metadata[\"results\"]`では、結果はまず回路インスタンスごとに、次に観測変数ごとにグループ化されます。\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 99,
"id": "a5899795",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Full QESEM mitigation results:\n",
"\n",
"PUB 0:\n",
" Mitigated expectation values: [1.00648343 1.00636289]\n",
" Mitigated error bars: [0.00253812 0.00693586]\n",
" Unmitigated expectation values: [0.98031429 0.96357143]\n",
" Unmitigated error bars: [0.00124128 0.00578812]\n",
" Transpiled circuits:\n",
" Circuit 0:\n",
" Qubit mapping: [[[0, 140], [1, 141], [2, 142], [3, 143], [4, 136]]]\n",
" Measurement bases: 2\n",
" Results for each observable:\n",
" Circuit 0:\n",
" Observable 0: ObservablesArray({'IIIIZ': 0.2, 'IIIZI': 0.2, 'IIZII': 0.2, 'IZIII': 0.2, 'ZIIII': 0.2}, shape=())\n",
" QESEM mitigated value: 1.0064834305181962 ± 0.002538119914534849\n",
" Unmitigated value: 0.9803142857142859 ± 0.0012412835813609938\n",
" Observable 1: ObservablesArray({'IIIZZ': 1.0, 'ZIIXI': 0.5}, shape=())\n",
" QESEM mitigated value: 1.0063628870614818 ± 0.006935859820870656\n",
" Unmitigated value: 0.9635714285714285 ± 0.005788121870526659\n"
]
}
],
"source": [
"print(\"Full QESEM mitigation results:\")\n",
"\n",
"for pub_idx, pub_result in enumerate(sample_result):\n",
" print(f\"\\nPUB {pub_idx}:\")\n",
"\n",
" print(f\" Mitigated expectation values: {pub_result.data.evs}\")\n",
" print(f\" Mitigated error bars: {pub_result.data.stds}\")\n",
" noisy_results = pub_result.metadata.get(\"noisy_results\")\n",
" print(f\" Unmitigated expectation values: {noisy_results.evs}\")\n",
" print(f\" Unmitigated error bars: {noisy_results.stds}\")\n",
"\n",
" print(\" Transpiled circuits:\")\n",
" for circ_idx, transpiled_circ in enumerate(\n",
" pub_result.metadata[\"transpiled_circs\"]\n",
" ):\n",
" print(f\" Circuit {circ_idx}:\")\n",
" # print(f\" Circuit: \\n {transpiled_circ['circuit']}\") # not printing it because it's long but you can see the transpiled circuit itself\n",
" print(f\" Qubit mapping: {transpiled_circ['qubit_maps']}\")\n",
" print(\n",
" f\" Measurement bases: {transpiled_circ['num_measurement_bases']}\"\n",
" )\n",
"\n",
" print(\" Results for each observable:\")\n",
" for circ_idx, circ_results in enumerate(pub_result.metadata[\"results\"]):\n",
" print(f\" Circuit {circ_idx}:\")\n",
" for obs_idx, (obs_array, result_dict) in enumerate(circ_results):\n",
" print(f\" Observable {obs_idx}: {obs_array}\")\n",
" print(\n",
" f\" QESEM mitigated value: {result_dict['qesem']['value']} ± {result_dict['qesem']['error_bar']}\"\n",
" )\n",
" print(\n",
" f\" Unmitigated value: {result_dict['unmitigated']['value']} ± {result_dict['unmitigated']['error_bar']}\"\n",
" )"
]
},
{
"cell_type": "markdown",
"id": "345524a3",
"metadata": {},
"source": [
"**主な結果の内訳：**\n",
"\n",
"* `mitigated`: 完全に緩和されたQESEMの期待値。\n",
"* `unmitigated`: 誤差低減処理を行っていない、物理ノイズの生の結果。\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "65a2e503",
"metadata": {},
"source": [
"\n",
"\n",
"#### QESEMによるヒューリスティック外挿の結果\n",
"\n",
"単一 `precision` のフロートを用いた標準的なQESEM実行では、結果にはQESEMのヒューリスティックに使用される、自動的に利用可能なノイズスケーリングポイントも含まれます。 これらのポイントは、追加のQPUリソースを使用せずに計算されます。\n",
"\n",
"スケール `1.0` は、読み出しノイズ低減（REM）を適用した物理デバイスのノイズレベルを表し、スケール `2.0` は、同じくREMを適用した、ノイズ増幅された相補的な点を表します。 これらの点が、結果 `qesem_heuristic` を生み出すために用いられます。\n",
"\n",
"* `qesem_heuristic`: 入手可能なノイズ補正済みデータから算出されたZNE方式の推定値。 現在、ここでは指数関数的な外挿法が用いられています。\n",
"* `noise_scaling.results_with_REM`: さまざまなノイズスケールにおける期待値。いずれも読み出しノイズ低減（REM）が適用されている。\n",
"\n",
"些細ではあるが重要な点として、スケ `1.0` ールの結果は、の `unmitigated` 結果とは同じではない。 どちらも物理的なデバイスのノイズレベルに対応していますが、スケール `1.0` ポイントには読み出し時のノイズ低減効果が含まれているのに対し `unmitigated` 、には含まれていません。\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 101,
"id": "21afd3d2",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"QESEM heuristic results:\n",
"\n",
"PUB 0:\n",
" Circuit 0:\n",
" Observable 0: ObservablesArray({'IIIIZ': 0.2, 'IIIZI': 0.2, 'IIZII': 0.2, 'IZIII': 0.2, 'ZIIII': 0.2}, shape=())\n",
" QESEM heuristic:\n",
" Value: 1.0008161638888535 ± 0.0038859458884403964\n",
" Extrapolation: exponential\n",
" Scale factors: [1.0, 2.0]\n",
" Noise scaling results:\n",
" Scaling method: QESEM\n",
" Results with Readout mitigation (REM):\n",
" Scale factor 1.0: 0.9918395459270772 ± 0.0012565417579355634\n",
" Scale factor 2.0: 0.982943441922748 ± 0.0028919278067695018\n",
" Observable 1: ObservablesArray({'IIIZZ': 1.0, 'ZIIXI': 0.5}, shape=())\n",
" QESEM heuristic:\n",
" Value: 0.9960853148925298 ± 0.013811635038961175\n",
" Extrapolation: exponential\n",
" Scale factors: [1.0, 2.0]\n",
" Noise scaling results:\n",
" Scaling method: QESEM\n",
" Results with Readout mitigation (REM):\n",
" Scale factor 1.0: 0.9902860583785115 ± 0.005921236914723409\n",
" Scale factor 2.0: 0.984520565414274 ± 0.006909522262347639\n"
]
}
],
"source": [
"print(\"QESEM heuristic results:\")\n",
"\n",
"for pub_idx, pub_result in enumerate(sample_result):\n",
" print(f\"\\nPUB {pub_idx}:\")\n",
" for circ_idx, circ_results in enumerate(pub_result.metadata[\"results\"]):\n",
" print(f\" Circuit {circ_idx}:\")\n",
" for obs_idx, (obs_array, result_dict) in enumerate(circ_results):\n",
" print(f\" Observable {obs_idx}: {obs_array}\")\n",
" qesem_heuristic = result_dict[\"qesem_heuristic\"][0]\n",
" print(\" QESEM heuristic:\")\n",
" print(\n",
" f\" Value: {qesem_heuristic['value']} ± {qesem_heuristic['error_bar']}\"\n",
" )\n",
" print(\n",
" f\" Extrapolation: {qesem_heuristic['extrapolation']}\"\n",
" )\n",
" print(\n",
" f\" Scale factors: {qesem_heuristic['scale_factors']}\"\n",
" )\n",
" noise_scaling = result_dict[\"noise_scaling\"]\n",
" print(\" Noise scaling results:\")\n",
" print(\n",
" f\" Scaling method: {noise_scaling['scaling_method']}\"\n",
" )\n",
" print(\" Results with Readout mitigation (REM):\")\n",
" for rem_result in sorted(\n",
" (\n",
" item\n",
" for item in noise_scaling[\"results_with_REM\"]\n",
" if item[\"scale\"] != 0.0\n",
" ),\n",
" key=lambda item: item[\"scale\"],\n",
" ):\n",
" print(\n",
" f\" Scale factor {rem_result['scale']}: {rem_result['value']} ± {rem_result['error_bar']}\"\n",
" )"
]
},
{
"cell_type": "markdown",
"id": "899d229a",
"metadata": {},
"source": [
"\n",
" 以下の例では、特定の機能に関する入力と結果に焦点を当てているため、毎回実行メトリクスをすべて表示するわけではありません。 先ほど示した total\\_qpu\\_time、 gate\\_fidelities、 総ショット数、 緩和措置\\_ショット、 resource\\_usage といった最上位のメタデータは、これらのジョブでも利用可能です。\n",
"\n",
" 簡潔さを期すため、バックエンド、オブザーバブル、基本回路パラメータなど、前の例で使用した変数のいくつかを以下で再利用しています。\n",
"\n",
"\n",
"\n",
" 以下の例はすべて、経験的な時間推定を用いて実行することも可能です。 これを有効にするには、関数のオプションに `\"estimate_time_only\": \"経験的\"` を指定してください。\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "079cb5be",
"metadata": {},
"source": [
"\n",
"\n",
"### パラメータ化された回路の例\n",
"\n",
"多くのアルゴリズムでは、同じ回路を複数のパラメータ値で評価します。 パラメータ化された回路を1つのQESEMジョブとして送信することで、QESEMは回路インスタンス間で特性評価とキャリブレーションを共有できるようになり、個別のジョブを実行する場合に比べてQPU時間のオーバーヘッドを削減できます。\n",
"\n",
"パラメータ化された回路を提出するには、トランスパイレーションレベル `\"minimal_with_layout_opt\"` を使用する必要があります。\n",
"このレベルで提出される回路は、バックエンドに応じて、すでにそのバックエンドの基底ゲートを用いて表現されている必要があります。 このレベルでは、QESEMは提出された構造を入力回路に可能な限り近づけたまま維持し、レイヤ化（操作を並列な2量子ビットゲートのレイヤーにグループ化すること）の際の障壁を考慮しつつ、高忠実度の量子ビットへのハードウェアマッピングやデバイスの接続設定も自動的に処理します。\n",
"\n",
"実際には、これは、提出する前に回路をターゲットバックエンドの基本ゲートに変換しておく必要があることを意味します。 以下に、単純なベースゲート変換の例を示します。\n",
"\n",
"QESEMでは現在、パラメータセットごとに1つの観測値のみをサポートしています。 `other_observable``avg_magnetization`以下の 2 つのパラメータ行は、2 つのオブザーバブルと結合されています。1 行目は で測定され、2 行目は で測定されています。\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "704f8aa5",
"metadata": {},
"outputs": [],
"source": [
"# Transpile to the backend basis gates only. With minimal_with_layout_opt, QESEM handles hardware mapping/connectivity and observable layout internally.\n",
"from qiskit_ibm_runtime.fake_provider import FakeFez\n",
"\n",
"backend = FakeFez()\n",
"basis = backend.operation_names\n",
"print(basis)\n",
"\n",
"param0 = qiskit.circuit.Parameter(\"param0\")\n",
"param1 = qiskit.circuit.Parameter(\"param1\")\n",
"parametrized_circ = qiskit.QuantumCircuit(5)\n",
"parametrized_circ.rx(param0, 0)\n",
"parametrized_circ.rx(param1, 1)\n",
"parametrized_circ.cx(0, 1)\n",
"parametrized_circ.cx(2, 3)\n",
"parametrized_circ.cx(1, 2)\n",
"parametrized_circ.cx(3, 4)\n",
"\n",
"parametrized_circ = qiskit.transpile(\n",
" parametrized_circ, basis_gates=basis, optimization_level=1\n",
")\n",
"parametrized_parameter_values = [[0.5, 0.1], [0.0, 0.6]]\n",
"parametrized_observables = [avg_magnetization, other_observable]\n",
"\n",
"parametrized_job = qesem_function.run(\n",
" pubs=[\n",
" (\n",
" parametrized_circ,\n",
" parametrized_observables,\n",
" parametrized_parameter_values,\n",
" 0.1,\n",
" )\n",
" ],\n",
" backend_name=backend_name,\n",
" options={\n",
" \"max_execution_time\": 300,\n",
" \"transpilation_level\": \"minimal_with_layout_opt\",\n",
" },\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 72,
"id": "85a452fc",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"d1b0e29b-196c-4896-aec6-44a268ebd874\n",
"DONE\n"
]
}
],
"source": [
"print(parametrized_job.job_id)\n",
"print(parametrized_job.status())"
]
},
{
"cell_type": "code",
"execution_count": 73,
"id": "244cd3b2",
"metadata": {},
"outputs": [],
"source": [
"parametrized_result = parametrized_job.result()"
]
},
{
"cell_type": "code",
"execution_count": 77,
"id": "03399db5",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Parameterized circuit QESEM results:\n",
"\n",
"PUB 0:\n",
" Mitigated expectation values: [0.92392021 0.82517653]\n",
" Mitigated error bars: [0.00565281 0.00616016]\n",
" Unmitigated expectation values: [0.9028 0.78771429]\n",
" Unmitigated error bars: [0.00335142 0.00925413]\n",
" Results for each parameter value:\n",
" Parameter set 0: [0.5, 0.1]\n",
" Observable 0: ObservablesArray({'IIIIZ': 0.2, 'IIIZI': 0.2, 'IIZII': 0.2, 'IZIII': 0.2, 'ZIIII': 0.2}, shape=())\n",
" QESEM mitigated value: 0.923920210615709 ± 0.005652811570890183\n",
" Unmitigated value: 0.9028 ± 0.0033514176105045447\n",
" Parameter set 1: [0.0, 0.6]\n",
" Observable 0: ObservablesArray({'IIIZZ': 1.0, 'ZIIXI': 0.5}, shape=())\n",
" QESEM mitigated value: 0.8251765289285893 ± 0.006160161743353999\n",
" Unmitigated value: 0.7877142857142858 ± 0.009254130564027902\n"
]
}
],
"source": [
"print(\"Parameterized circuit QESEM results:\")\n",
"\n",
"for pub_idx, pub_result in enumerate(parametrized_result):\n",
" print(f\"\\nPUB {pub_idx}:\")\n",
" print(f\" Mitigated expectation values: {pub_result.data.evs}\")\n",
" print(f\" Mitigated error bars: {pub_result.data.stds}\")\n",
" noisy_results = pub_result.metadata[\"noisy_results\"]\n",
" print(f\" Unmitigated expectation values: {noisy_results.evs}\")\n",
" print(f\" Unmitigated error bars: {noisy_results.stds}\")\n",
" print(\" Results for each parameter value:\")\n",
" for param_idx, param_results in enumerate(pub_result.metadata[\"results\"]):\n",
" print(\n",
" f\" Parameter set {param_idx}: {parametrized_parameter_values[param_idx]}\"\n",
" )\n",
" for obs_idx, (obs_array, result_dict) in enumerate(param_results):\n",
" print(f\" Observable {obs_idx}: {obs_array}\")\n",
" print(\n",
" f\" QESEM mitigated value: {result_dict['qesem']['value']} ± {result_dict['qesem']['error_bar']}\"\n",
" )\n",
" print(\n",
" f\" Unmitigated value: {result_dict['unmitigated']['value']} ± {result_dict['unmitigated']['error_bar']}\"\n",
" )"
]
},
{
"cell_type": "markdown",
"id": "d6d1b6c2",
"metadata": {},
"source": [
"\n",
"\n",
"### 複数のパブを含む例\n",
"\n",
"マルチパブ実行は、1つのQESEMジョブ内で複数の関連する回路を実行したい場合に役立ちます。 パラメータ化された実行と同様に、QESEMでは個別のジョブで繰り返し実行するのではなく、回路インスタンス間で特性評価やキャリブレーションを共有できるため、オーバーヘッドを削減できます。\n",
"\n",
"これは、 **トロッター型**ワークロードなど、異なるサーキットが同一の固有レイヤーを再利用する、共有レイヤー構造を持つサーキットにおいて特に有用です。 その場合、これらをまとめて実行することで、個別のQESEM作業と比較して特性評価のコストを削減できます。\n",
"\n",
"`\"transpilation_level\": \"minimal_with_layout_opt\"`複数のパブでの仕事には、以下が必要です。 パラメータ化された例と同様に、回路は提出前に、ターゲットバックエンドの基本ゲートに変換しておく必要があります。 その後、QESEMはデバイスとの接続、レイアウト、および高忠実度量子ビットへのマッピングを内部で処理します。\n",
"\n",
"以下の各 PUB には、1つの回路と、このノートブックの前半で使用されたのと同じ2つの観測可能変数が含まれているため、返される `PrimitiveResult` 値には入力回路ごとに1つの `PubResult` が含まれます。\n",
"\n",
"以下の例では、同じ層パターンを持つ2つの単純なトロッター回路を使用しています。 `circ_a` 1つはトロッター層が1つあり、もう1つは `circ_b` 同じ層パターンを2回繰り返しています。 これにより、共有構造が明示されます。\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "8cc663fc",
"metadata": {},
"outputs": [],
"source": [
"def make_trotter_circuit(num_qubits, num_layers, zz_angle=0.2, x_angle=0.1):\n",
" trotter_circ = qiskit.QuantumCircuit(num_qubits)\n",
" for _ in range(num_layers):\n",
" for q in range(num_qubits):\n",
" trotter_circ.rx(x_angle, q)\n",
" trotter_circ.barrier()\n",
" for q in range(0, num_qubits - 1, 2):\n",
" trotter_circ.rzz(zz_angle, q, q + 1)\n",
" trotter_circ.barrier()\n",
" for q in range(1, num_qubits - 1, 2):\n",
" trotter_circ.rzz(zz_angle, q, q + 1)\n",
" trotter_circ.barrier()\n",
" return trotter_circ\n",
"\n",
"\n",
"circ_a = make_trotter_circuit(num_qubits=5, num_layers=1)\n",
"circ_b = make_trotter_circuit(num_qubits=5, num_layers=2)"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "371c4893",
"metadata": {},
"outputs": [],
"source": [
"multi_pubs = [\n",
" (\n",
" qiskit.transpile(qci, basis_gates=basis, optimization_level=1),\n",
" [avg_magnetization, other_observable],\n",
" )\n",
" for qci in [circ_a, circ_b]\n",
"]\n",
"\n",
"multi_circ_job = qesem_function.run(\n",
" pubs=multi_pubs,\n",
" backend_name=backend_name,\n",
" options={\n",
" \"max_execution_time\": 300,\n",
" \"transpilation_level\": \"minimal_with_layout_opt\",\n",
" \"default_precision\": 0.1,\n",
" },\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 91,
"id": "92e45737",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"e34565b8-7262-4133-a120-de42ce624a99\n",
"DONE\n"
]
}
],
"source": [
"print(multi_circ_job.job_id)\n",
"print(multi_circ_job.status())"
]
},
{
"cell_type": "code",
"execution_count": 92,
"id": "23c61008",
"metadata": {},
"outputs": [],
"source": [
"multi_circ_result = multi_circ_job.result()"
]
},
{
"cell_type": "code",
"execution_count": 105,
"id": "1ae6f8c3",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Multi-pub QESEM results:\n",
"\n",
"PUB 0:\n",
" Mitigated expectation values: [0.99502406 1.02209332]\n",
" Mitigated error bars: [0.00483819 0.00707488]\n",
" Unmitigated expectation values: [0.96934286 0.97271429]\n",
" Unmitigated error bars: [0.00124855 0.00617294]\n",
" Results for each observable:\n",
" Circuit 0:\n",
" Observable 0: ObservablesArray({'IIIIZ': 0.2, 'IIIZI': 0.2, 'IIZII': 0.2, 'IZIII': 0.2, 'ZIIII': 0.2}, shape=())\n",
" QESEM mitigated value: 0.9950240647925642 ± 0.004838188086259301\n",
" Unmitigated value: 0.9693428571428573 ± 0.0012485470362492692\n",
" Observable 1: ObservablesArray({'IIIZZ': 1.0, 'ZIIXI': 0.5}, shape=())\n",
" QESEM mitigated value: 1.0220933230604674 ± 0.007074884384355636\n",
" Unmitigated value: 0.9727142857142859 ± 0.006172939375512439\n",
"\n",
"PUB 1:\n",
" Mitigated expectation values: [0.98850017 1.02555188]\n",
" Mitigated error bars: [0.0077912 0.01672652]\n",
" Unmitigated expectation values: [0.93682857 0.95371429]\n",
" Unmitigated error bars: [0.00156245 0.00665735]\n",
" Results for each observable:\n",
" Circuit 0:\n",
" Observable 0: ObservablesArray({'IIIIZ': 0.2, 'IIIZI': 0.2, 'IIZII': 0.2, 'IZIII': 0.2, 'ZIIII': 0.2}, shape=())\n",
" QESEM mitigated value: 0.988500171577252 ± 0.007791203181151346\n",
" Unmitigated value: 0.9368285714285716 ± 0.001562451883089579\n",
" Observable 1: ObservablesArray({'IIIZZ': 1.0, 'ZIIXI': 0.5}, shape=())\n",
" QESEM mitigated value: 1.02555188098689 ± 0.016726524388086233\n",
" Unmitigated value: 0.9537142857142858 ± 0.006657345655544263\n"
]
}
],
"source": [
"print(\"Multi-pub QESEM results:\")\n",
"\n",
"for pub_idx, pub_result in enumerate(multi_circ_result):\n",
" print(f\"\\nPUB {pub_idx}:\")\n",
" print(f\" Mitigated expectation values: {pub_result.data.evs}\")\n",
" print(f\" Mitigated error bars: {pub_result.data.stds}\")\n",
" noisy_results = pub_result.metadata[\"noisy_results\"]\n",
" print(f\" Unmitigated expectation values: {noisy_results.evs}\")\n",
" print(f\" Unmitigated error bars: {noisy_results.stds}\")\n",
" print(\" Results for each observable:\")\n",
" for circ_idx, circ_results in enumerate(pub_result.metadata[\"results\"]):\n",
" print(f\" Circuit {circ_idx}:\")\n",
" for obs_idx, (obs_array, result_dict) in enumerate(circ_results):\n",
" print(f\" Observable {obs_idx}: {obs_array}\")\n",
" print(\n",
" f\" QESEM mitigated value: {result_dict['qesem']['value']} ± {result_dict['qesem']['error_bar']}\"\n",
" )\n",
" print(\n",
" f\" Unmitigated value: {result_dict['unmitigated']['value']} ± {result_dict['unmitigated']['error_bar']}\"\n",
" )"
]
},
{
"cell_type": "markdown",
"id": "8f28d826",
"metadata": {},
"source": [
"\n",
"\n",
"### 準確率論的誤差調整（QET）の例\n",
"\n",
"準確率論的誤差調整（QET）では、選択されたノイズスケール係数における期待値が求められます。 これは、カスタムノイズスケーリングの研究や、ゼロノイズ外挿のワークフローに役立ちます。 「スケール `1.0` 」は物理的なノイズレベルを表します。～ `1.0` の `0.0` 間の値ではノイズが部分的に低減され、～を超える `1.0` 値ではノイズが増幅されます。\n",
"\n",
"Qiskit FunctionでQETを使用するには、 PUB の精度として辞書を渡してください。 この辞書は、要求された各ノイズスケールを、その目標精度に対応付けます。 返されたスケール係数の結果は に `noise_scaling.results_with_REM` 保存され、読み出しの誤差補正が含まれています。 したがって、スケール `1.0` 値は未補正値とは同一ではありません。なぜなら `1.0` 、前者には読み出し補正が含まれているのに対し `unmitigated` 、後者には含まれていないからです。\n",
"\n",
"スケールの要求があった場合、QESEMは追加のQPU使用量なしで、その周囲 `1.0` の補完スケールも返します。 `0.7``1.5`たとえば、`` をリクエストすると `0.5` `` が返されることもあり、``をリクエスト `1.3` すると`` が返されることもあります。 補完スケールの精度は保証されません。\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 88,
"id": "723cdf95",
"metadata": {},
"outputs": [],
"source": [
"noise_scale_precision = {0.5: 0.15, 1.3: 0.2}\n",
"\n",
"qet_job = qesem_function.run(\n",
" pubs=[\n",
" (\n",
" circ,\n",
" [avg_magnetization, other_observable],\n",
" None,\n",
" noise_scale_precision,\n",
" )\n",
" ],\n",
" backend_name=backend_name,\n",
" options={\"max_execution_time\": 300},\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 95,
"id": "d68a015c",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"8195fa58-f037-4651-8715-36ce1cdc5521\n",
"DONE\n"
]
}
],
"source": [
"print(qet_job.job_id)\n",
"print(qet_job.status())"
]
},
{
"cell_type": "code",
"execution_count": 96,
"id": "927d8543",
"metadata": {},
"outputs": [],
"source": [
"qet_result = qet_job.result()"
]
},
{
"cell_type": "code",
"execution_count": 104,
"id": "1c9ba079",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"QET noise-scaling results:\n",
"\n",
"PUB 0:\n",
" Unmitigated expectation values: [0.97822857 0.96171429]\n",
" Unmitigated error bars: [0.00123812 0.00672958]\n",
" Results for each observable:\n",
" Circuit 0:\n",
" Observable 0: ObservablesArray({'IIIIZ': 0.2, 'IIIZI': 0.2, 'IIZII': 0.2, 'IZIII': 0.2, 'ZIIII': 0.2}, shape=())\n",
" Scaling method: QESEM\n",
" Results with Readout mitigation (REM):\n",
" Scale factor 0.5: 0.9938730340199383 ± 0.0032116907357568275\n",
" Scale factor 0.7: 0.9963976191853445 ± 0.00036300258869586616\n",
" Scale factor 1.0: 0.9898115079506586 ± 0.0012525947426560995\n",
" Scale factor 1.3: 0.9864667065580341 ± 0.002633221613518526\n",
" Scale factor 1.5: 0.9838755527197551 ± 0.002948417797996015\n",
" Observable 1: ObservablesArray({'IIIZZ': 1.0, 'ZIIXI': 0.5}, shape=())\n",
" Scaling method: QESEM\n",
" Results with Readout mitigation (REM):\n",
" Scale factor 0.5: 1.0006538544450332 ± 0.002121742014777343\n",
" Scale factor 0.7: 1.0004159801523036 ± 0.0021671375357823794\n",
" Scale factor 1.0: 0.9898058846339917 ± 0.00690183710903159\n",
" Scale factor 1.3: 0.9948946719997267 ± 0.002146532859610311\n",
" Scale factor 1.5: 0.9927220368192772 ± 0.0020875057190323882\n"
]
}
],
"source": [
"print(\"QET noise-scaling results:\")\n",
"\n",
"for pub_idx, pub_result in enumerate(qet_result):\n",
" print(f\"\\nPUB {pub_idx}:\")\n",
" noisy_results = pub_result.metadata[\"noisy_results\"]\n",
" print(f\" Unmitigated expectation values: {noisy_results.evs}\")\n",
" print(f\" Unmitigated error bars: {noisy_results.stds}\")\n",
" print(\" Results for each observable:\")\n",
" for circ_idx, circ_results in enumerate(pub_result.metadata[\"results\"]):\n",
" print(f\" Circuit {circ_idx}:\")\n",
" for obs_idx, (obs_array, result_dict) in enumerate(circ_results):\n",
" print(f\" Observable {obs_idx}: {obs_array}\")\n",
" noise_scaling = result_dict[\"noise_scaling\"]\n",
" print(\n",
" f\" Scaling method: {noise_scaling['scaling_method']}\"\n",
" )\n",
" print(\" Results with Readout mitigation (REM):\")\n",
" for rem_result in sorted(\n",
" (\n",
" item\n",
" for item in noise_scaling[\"results_with_REM\"]\n",
" if item[\"scale\"] != 0.0\n",
" ),\n",
" key=lambda item: item[\"scale\"],\n",
" ):\n",
" print(\n",
" f\" Scale factor {rem_result['scale']}: {rem_result['value']} ± {rem_result['error_bar']}\"\n",
" )"
]
},
{
"cell_type": "markdown",
"id": "35aed54a",
"metadata": {},
"source": [
"\n",
"\n",
"## エラーメッセージを取得する\n",
"\n",
"ワークロードのステータスが「ERROR」の場合は、次のようにしてエラーメッセージを取得してください `job.result()` ：\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 9,
"id": "d95a3f30",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"PrimitiveResult([PubResult(data=DataBin(evs=np.ndarray(), stds=np.ndarray(), shape=(2,)), metadata={'gate_fidelities': {'CZ': 0.9979444718552628, 'ID1Q': 0.9991994239814883}, 'total_shots': 498600, 'mitigation_shots': 223400, 'transpiled_circs': [{'circuit': 'OPENQASM 3.0;\\ninclude \"stdgates.inc\";\\nbit[76] c0;\\nqubit[76] q0;\\nrx(0) q0[54];\\nrx(0) q0[59];\\nrx(0) q0[75];\\nrz(pi/2) q0[54];\\nrz(pi/2) q0[59];\\nrz(pi/2) q0[75];\\nrx(pi/2) q0[54];\\nr... (truncated 3771 characters)\n"
]
}
],
"source": [
"# Get the result and truncate for readability\n",
"result = sample_job.result()\n",
"result_str = str(result)\n",
"max_length = 500 # Adjust this value as necessary\n",
"\n",
"if len(result_str) > max_length:\n",
" truncated = (\n",
" result_str[:max_length]\n",
" + f\"... (truncated {len(result_str) - max_length} characters)\"\n",
" )\n",
"else:\n",
" truncated = result_str\n",
"\n",
"print(truncated)"
]
},
{
"cell_type": "markdown",
"id": "e9ec2e67",
"metadata": {},
"source": [
"\n",
"\n",
"## サポートの利用\n",
"\n",
"Qedmaのサポートチームがお手伝いします！ QESEM Qiskit Functionの使用に関して何か問題が発生したり、質問がある場合は、遠慮なくご連絡ください。 当社の知識豊富でフレンドリーなサポートスタッフが、技術的な問題やお問い合わせに対応いたします。\n",
"\n",
"Eメールでのお問い合わせは [support@qedma.com](mailto:support@qedma.com) までご連絡ください。 迅速かつ正確な対応をさせていただくため、お困りの問題についてできるだけ詳しくご記入ください。 また、Qedma POCの専任担当者に電子メールまたは電話でご連絡いただくこともできます。\n",
"\n",
"より効率的にサポートさせていただくため、お問い合わせの際は以下の情報をお知らせください：\n",
"\n",
"* 問題の詳細\n",
"* ジョブ ID\n",
"* 関連するエラーメッセージやコード\n",
"\n",
"Qiskitの機能を最大限にご活用いただけるよう、迅速かつ効果的なサポートをお約束いたします。\n",
"\n",
"私たちは常に製品の改善に努めており、皆様からのご提案をお待ちしております！ サービス改善のご提案やご希望の機能などございましたら、 [support@qedma.com](mailto:support@qedma.com) までお寄せください。\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "5a6a25c8",
"metadata": {},
"source": [
"\n",
"\n",
"## 次のステップ\n",
"\n",
"\n",
" * [Qedma QESEMへのアクセスをリクエストします](/functions?id=qedma-qesem)。\n",
" * このQiskit関数の [APIリファレンス](/docs/api/functions/qedma-qesem)をご覧ください。\n",
" * [「 2D 」の傾斜磁場アイジング](/docs/tutorials/qedma-2d-ising-with-qesem)モデルをQESEM関数を使ってシミュレートするチュートリアルをお試しください。\n",
" * レビュー [アハロノフ, D., et al. (2025). 実用規模量子回路向け信頼性の高い高精度誤差軽減技術 arXiv プレプリント arXiv:2508.10997](https://arxiv.org/pdf/2508.10997).\n",
" * 書評： [アハロノフ, D., et al. (2025). 症候群を考慮した論理エラーの軽減。 arXiv プレプリント arXiv:2508.10997](https://arxiv.org/pdf/2508.10997)。\n",
" * 書評： [アハロノフ, D., et al. (2025). 量子計算におけるエラー軽減の重要性について。 arXiv プレプリント arXiv:2512.23810](https://arxiv.org/abs/2512.23810)。\n",
" * レビュー [ボーマン, N. P., et al. (2025). 量子ハードウェア上における化学系シミュレーションのための結合クラスターダウンフォールディング理論 arXiv プレプリント arXiv:2507.01199](https://arxiv.org/pdf/2507.01199).\n",
" * 書評 [ゴールドアック, M., et al. (2026)。 現在の量子ハードウェアを用いた速度場の統計的性質の計算。 arXiv プレプリント arXiv:2601.10166](https://arxiv.org/pdf/2601.10166)。\n",
" * 書評 [佐久間 良、 et al. (2026)。 量子コンピュータを用いた多電子波動関数の点群対称性解析 arXiv プレプリント arXiv:2605.24824](https://arxiv.org/abs/2605.24824).\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"id": "a1b8767d",
"source": "© IBM Corp., 2017-2026"
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3"
}
},
"nbformat": 4,
"nbformat_minor": 5
}