{
  "cells": [
    {
      "cell_type": "markdown",
      "id": "727f8133-a32e-4bd9-a6c3-1a1c580e06bd",
      "metadata": {},
      "source": [
        "---\n",
        "title: \"伝播型ノイズ吸収（PNA）による期待値の改善\"\n",
        "description: \"SamplomaticおよびExecutorプリミティブを用いた伝播型ノイズ吸収（PNA）を活用し、期待値推定における2量子ビットゲートのノイズを低減する\"\n",
        "---\n",
        "\n",
        "{/* cspell:ignore pstr expvals postsel broadcastable fontsize borderaxespad reweighting */}\n",
        "\n",
        "<span id=\"improve-expectation-values-with-propagated-noise-absorption-pna\" />\n",
        "\n",
        "# 伝播型ノイズ吸収（PNA）による期待値の改善\n",
        "\n",
        "*所要時間の目安：Heronプロセッサで10分（注：これはあくまで目安です。 （実行時間は状況によって異なる場合があります。）*\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "a1b2c3d4-0001-4000-8000-000000000001",
      "metadata": {},
      "source": [
        "<span id=\"learning-outcomes\" />\n",
        "\n",
        "## 学習成果\n",
        "\n",
        "このチュートリアルを学習した後、ユーザーは以下の点を理解できるようになります：\n",
        "\n",
        "* 伝播型ノイズ吸収（PNA）とは何か、そして、学習された逆ノイズチャネルを測定対象の観測量に吸収させることで、2量子ビットゲートのノイズをどのように低減するのか\n",
        "* 「twirling」、基底の変更、およびノイズ注入を行うための回路レイヤーのボックス化と注釈付けの方法 [`samplomatic`](/docs/guides/directed-execution-model#samplomatic)\n",
        "* `[NoiseLearnerV3`( /docs/guides/directed-execution-model#noiselearnerv3 ) を用いてレイヤーノイズを学習し、それをノイズ低減観測量に伝播させる方法 [`qiskit-addon-pna`](https://github.com/Qiskit/qiskit-addon-pna)\n",
        "* の および `QuantumProgram` クラス [`Executor`](/docs/guides/get-started-with-executor) を使用してランダム化回路をサンプリングする方法 `qiskit-ibm-runtime`、ならびにPNAとTREXおよびポストセレクションを組み合わせる方法\n",
        "\n",
        "<span id=\"prerequisites\" />\n",
        "\n",
        "## 前提条件\n",
        "\n",
        "このチュートリアルを進める前に、以下のトピックについてあらかじめ理解しておいていただくことをお勧めします：\n",
        "\n",
        "* [Qiskit](/docs/guides/intro-to-patterns) のパターンワークフロー\n",
        "* [Estimatorプリミティブ](/docs/guides/get-started-with-estimator)を用いた観測変数の期待値の計算\n",
        "* [「推定器プリミティブとエラー軽減オプションの組み合わせ」](/docs/tutorials/combine-error-mitigation-techniques) で取り上げられている、パウリ・トゥワーリングやTREXなどのエラー軽減手法\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "a1b2c3d4-0002-4000-8000-000000000002",
      "metadata": {},
      "source": [
        "<span id=\"background\" />\n",
        "\n",
        "## 背景\n",
        "\n",
        "このチュートリアルでは、Qiskitの高度なエラー軽減ツールを活用して、ノイズの多い量子実験における期待値の推定精度を向上させる方法について解説します。\n",
        "\n",
        "<span id=\"what-is-propagated-noise-absorption-pna\" />\n",
        "\n",
        "### 「伝播ノイズ吸収（PNA）」とは何ですか？\n",
        "\n",
        "*伝播型ノイズ吸収とは、2量子ビットゲートに影響を及ぼす逆ノイズチャネルを通じて観測量を伝播させることで、ゲートエラーを軽減する手法であり、その結果、ノイズを軽減する観測量が生み出される。*\n",
        "\n",
        "量子エラー緩和を利用すれば、完全な耐故障性を必要とすることなく、ノイズの多い量子ハードウェアから有用な期待値を抽出することができる。 PNAは、回路の動作を変更するのではなく、ノイズの影響を観測量そのものに吸収することに特に重点を置いています。\n",
        "\n",
        "量子回路内の各ノイズの混入したゲートは、理想的なゲートの後にノイズチャネルが続くものとしてモデル化できる。 PNAは、これらのノイズチャネルを学習または特徴付けし、その逆関数を定義する。 PNAは、逆演算をハードウェアの実行プロセスに組み込む（これは通常、実現不可能である）代わりに、逆ノイズチャネルを回路を通じて前方へ伝播させ、観測量に適用する。 このプロセスにより、観測量 $O$ が新しい演算子 $\\tilde{O}$ に変換され、ノイズの混入した回路上で $\\tilde{O}$ を測定した際の期待値は、ノイズのない理想的な回路上で $O$ を測定した際の期待値と同じになる。\n",
        "\n",
        "これは次のように要約できます：\n",
        "\n",
        "1. 各ノイズ混入ゲート $u_i$ を、理想的な演算の後にノイズチャネル $\\Lambda_i$ が続くものとしてモデル化する。\n",
        "2. ノイズ特性評価ツールを使用して、各 $\\Lambda_i$ の値を測定または推定します。\n",
        "3. 逆ノイズマップ $\\Lambda_i^{-1}$ を定義し、パウリ転送法を用いて回路を順方向に伝播させる。\n",
        "4. これらの逆演算子を観測量に吸収することで、ノイズが低減された演算子 $\\tilde{O}$ が得られる。\n",
        "\n",
        "このノイズがパウリチャネル（あるいはより一般的には疎なパウリ・リンドブラッドチャネル）として記述される場合、この伝播はパウリ伝播を用いて効率的に行うことができる。 パウリ伝播は、計算複雑度を制御しつつ、逆ノイズチャネルがクリフォード演算および非クリフォード演算の層を通過する際にどのように変換されるかを近似するための枠組みを提供する。\n",
        "\n",
        "緩和策を「観測可能な」領域に移すことで、PNAは、回路に物理的な補正操作を挿入した場合に生じうる大きなサンプリングオーバーヘッドを回避している。 その代わりに、元のノイズを含む回路が実行され、観測可能量は、その期待値によってノイズの影響が打ち消される新しい演算子 $\\tilde{O}$ に変換される。\n",
        "\n",
        "<span id=\"the-pna-workflow\" />\n",
        "\n",
        "### PNAのワークフロー\n",
        "\n",
        "このプロセスは、以下の概念的な段階を通じて理解することができます。 最初の回路図は、標準的なノイズの多い実験を示しています。\n",
        "\n",
        "![騒がしい実験](https://quantum.cloud.ibm.com/docs/images/tutorials/propagated-noise-absorption/noisy_expt.avif)\n",
        "\n",
        "ノイズモデルを学習できれば、その逆モデルを適用してノイズを除去することができます。\n",
        "\n",
        "![騒音低減実験](https://quantum.cloud.ibm.com/docs/images/tutorials/propagated-noise-absorption/noise_mitigated_expt.avif)\n",
        "\n",
        "確率的誤差キャンセル（PEC）のようにQPU上でサンプリングして逆ノイズチャネルを実装するのではなく、パウリ伝播を用いて、測定された観測量に対して古典的にこれを適用する。 その結果得られる観測量により、測定時に学習されたゲートノイズが効果的に低減される。\n",
        "\n",
        "![PNAの概要](https://quantum.cloud.ibm.com/docs/images/tutorials/propagated-noise-absorption/pna_overview.avif)\n",
        "\n",
        "<span id=\"modular-error-mitigation-with-samplomatic-and-executor\" />\n",
        "\n",
        "### Samplomatic と Executor を用いたモジュール型エラー緩和\n",
        "\n",
        "PNAのアプローチは、Qiskitのモジュール型エラー軽減アーキテクチャに基づいています。 このアーキテクチャでは、ライブラ [`samplomatic`](https://github.com/Qiskit/samplomatic) リと、および `Executor` クラス（ v0.47.0 で `qiskit-ibm-runtime`Qiskit Runtime に追加されたもの）を `QuantumProgram` 組み合わせて使用し、伝播型ノイズ吸収やパウリ・トゥワーリングといった手法を、異なる実験間で組み合わせ可能かつ再利用可能にしています。\n",
        "\n",
        "`Executor`緩和ロジックを回路定義そのものに組み込むのではなく、緩和処理はアノテーションを通じて `samplomatic` 宣言的に表現され、ランダム化された回路の生成、実行、および後処理の方法を制御する を通じてプログラム的に管理されます。\n",
        "\n",
        "このチュートリアルでは、 [Qiskitの](/docs/guides/intro-to-patterns)パターンを実装し、PNAが逆パウリノイズチャネルを伝播させ、それに応じて観測量を修正することで、ノイズの多いQPUにおける期待値の推定精度を向上させる仕組みを解説します。\n",
        "\n",
        "<span id=\"workflow-overview\" />\n",
        "\n",
        "### ワークフローの概要\n",
        "\n",
        "* **ステップ1：量子問題への対応付け**\n",
        "  * ミラー化されたトロッター化キック・アイジングモデルと、ターゲット観測量を作成する。\n",
        "* **ステップ2：ノイズの特性解析と増幅**\n",
        "  * を使用して `samplomatic` 、回路内の固有の2量子ビット層および測定を特定し、注釈を付けます。\n",
        "  * `NoiseLearnerV3`を使用して、各レイヤーに固有の影響を与えるノイズについて学びましょう。\n",
        "  * 各アノテーションを `InjectNoise` 、それに対応する学習済みノイズモデルにマッピングする。\n",
        "  * を使用して `qiskit-addon-pna` 、逆ノイズチャネルを回路を通じて前方へ伝播させ、それらをターゲット観測量に吸収させる。\n",
        "* **ステップ3：量子実験の実施**\n",
        "  * `Executor`を `QuantumProgram` 定義して、による `samplex` ランダムサンプリングを指定し、を使用してバックエンド上で実験を実行します。\n",
        "* **ステップ4：結果を再構築し、分析する**\n",
        "  * 緩和策（PNA、PNA+TREX、PNA+PS、PNA+PS+TREX）を比較し、緩和策を適用していない場合の結果との改善度合いを可視化する。\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "3b64ad83-0000-4000-8000-000000000003",
      "metadata": {},
      "source": [
        "<span id=\"requirements\" />\n",
        "\n",
        "## 要件\n",
        "\n",
        "このチュートリアルを始める前に、以下のものがインストールされていることを確認してください：\n",
        "\n",
        "* Qiskit SDK v2.2 またはそれ以降で、 [可視化](/docs/api/qiskit/visualization)機能をサポートしているもの\n",
        "* Qiskit Runtime v0.47 またはそれ以降 (`pip install qiskit-ibm-runtime`)\n",
        "* Samplomatic v0.13 以降 (`pip install samplomatic`)\n",
        "* PNA Qiskit アドオン (`pip install qiskit-addon-pna`)\n",
        "* Qiskit アドオン utils (`pip install qiskit-addon-utils`)\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "28ad8a65-0000-4000-8000-000000000004",
      "metadata": {},
      "source": [
        "<span id=\"setup\" />\n",
        "\n",
        "## セットアップ\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 1,
      "id": "3a851a58-0000-4000-8000-000000000005",
      "metadata": {},
      "outputs": [],
      "source": [
        "from qiskit import QuantumCircuit\n",
        "from qiskit.quantum_info import Pauli, SparsePauliOp\n",
        "from qiskit.transpiler import generate_preset_pass_manager, PassManager\n",
        "from qiskit_ibm_runtime import (\n",
        "    QiskitRuntimeService,\n",
        "    QuantumProgram,\n",
        "    Executor,\n",
        "    NoiseLearnerV3,\n",
        ")\n",
        "from qiskit_addon_utils.exp_vals.measurement_bases import (\n",
        "    get_measurement_bases,\n",
        ")\n",
        "from qiskit_addon_utils.exp_vals.expectation_values import (\n",
        "    executor_expectation_values,\n",
        ")\n",
        "from qiskit_addon_utils.noise_management import trex_factors\n",
        "from qiskit_addon_utils.noise_management.post_selection import PostSelector\n",
        "from qiskit_addon_utils.noise_management.post_selection.transpiler.passes import (\n",
        "    AddPostSelectionMeasures,\n",
        "    AddSpectatorMeasures,\n",
        ")\n",
        "from qiskit_addon_pna import generate_noise_mitigating_observable\n",
        "import samplomatic\n",
        "from samplomatic.transpiler import generate_boxing_pass_manager\n",
        "from samplomatic.annotations import InjectNoise\n",
        "from samplomatic.utils import get_annotation, find_unique_box_instructions\n",
        "import numpy as np\n",
        "import matplotlib.pyplot as plt\n",
        "\n",
        "\n",
        "# Selects a connected chain of low-error qubits on the target backend.\n",
        "# The mirrored kicked-Ising circuit is a 1D chain, so we only need a line\n",
        "# of connected physical qubits; the helper walks the backend's coupling map\n",
        "# and grows a chain along the lowest-error two-qubit edges, so it works for\n",
        "# any backend rather than relying on a hardcoded layout.\n",
        "def find_qubit_chain(backend, length):\n",
        "    \"\"\"Find a connected chain of ``length`` physical qubits on ``backend``.\n",
        "\n",
        "    The chain is grown greedily along the lowest-error two-qubit edges, so it\n",
        "    favors better-performing qubits. Because the mirrored kicked-Ising circuit\n",
        "    is a 1D chain, a connected line is all we need.\n",
        "    \"\"\"\n",
        "    target = backend.target\n",
        "\n",
        "    # Identify the native two-qubit gate and build a per-edge error lookup.\n",
        "    two_qubit_gate = next(\n",
        "        name\n",
        "        for name in target.operation_names\n",
        "        if target[name]\n",
        "        and all(q is not None and len(q) == 2 for q in target[name])\n",
        "    )\n",
        "    edge_error = {\n",
        "        frozenset(qargs): (\n",
        "            1.0 if props is None or props.error is None else props.error\n",
        "        )\n",
        "        for qargs, props in target[two_qubit_gate].items()\n",
        "    }\n",
        "\n",
        "    graph = backend.coupling_map.graph.to_undirected(multigraph=False)\n",
        "    neighbors = {n: list(graph.neighbors(n)) for n in graph.node_indices()}\n",
        "\n",
        "    def first_chain_from(start):\n",
        "        path, visited = [start], {start}\n",
        "\n",
        "        def grow():\n",
        "            if len(path) == length:\n",
        "                return True\n",
        "            node = path[-1]\n",
        "            order = sorted(\n",
        "                neighbors[node],\n",
        "                key=lambda m: edge_error.get(frozenset((node, m)), 1.0),\n",
        "            )\n",
        "            for nxt in order:\n",
        "                if nxt not in visited:\n",
        "                    visited.add(nxt)\n",
        "                    path.append(nxt)\n",
        "                    if grow():\n",
        "                        return True\n",
        "                    path.pop()\n",
        "                    visited.remove(nxt)\n",
        "            return False\n",
        "\n",
        "        return path if grow() else None\n",
        "\n",
        "    def chain_cost(path):\n",
        "        return sum(\n",
        "            edge_error.get(frozenset((path[i], path[i + 1])), 1.0)\n",
        "            for i in range(len(path) - 1)\n",
        "        )\n",
        "\n",
        "    # Try low-degree qubits first (the natural ends of long chains) and keep\n",
        "    # the lowest-error chain found.\n",
        "    best_path, best_cost = None, float(\"inf\")\n",
        "    for start in sorted(neighbors, key=lambda n: len(neighbors[n])):\n",
        "        chain = first_chain_from(start)\n",
        "        if chain is not None and (cost := chain_cost(chain)) < best_cost:\n",
        "            best_path, best_cost = chain, cost\n",
        "\n",
        "    if best_path is None:\n",
        "        raise ValueError(\n",
        "            f\"Could not find a connected chain of {length} qubits \"\n",
        "            f\"on '{backend.name}'.\"\n",
        "        )\n",
        "    return best_path"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "a1b2c3d4-0006-4000-8000-000000000006",
      "metadata": {},
      "source": [
        "<span id=\"small-scale-simulator-example\" />\n",
        "\n",
        "## 小規模シミュレータの例\n",
        "\n",
        "PNAは、特定の量子プロセッサにおける*物理的な* 2量子ビットゲートのノイズを低減する。 このワークフローは、理想的なシミュレータには実質的に対応するものが存在しない2つのハードウェアサービスに依存しています：\n",
        "\n",
        "* `NoiseLearnerV3` トランスパイル回路の各固有の2量子ビット層に付随する、スパースなパウリ・リンドブラッドノイズチャネルを実験的に特徴づける。 ノイズのないシミュレータでは、学習すべきノイズが存在せず、伝播される逆チャネルは恒等チャネルとなる。\n",
        "* この `Executor` プリミティブは、バックエンド上で生成された `samplomatic` 、ねじれやランダム化が施された回路をサンプリングします。\n",
        "\n",
        "原則として、合成ノイズモデルで代用することも可能です。 `generate_noise_mitigating_observable`たとえば、 [Qiskit Aer](https://github.com/Qiskit/qiskit-aer) を使って指示を添付 `PauliLindbladError` し、その結果として生成されたノイズの混じった回路を直接 に渡すことができます。 しかし、これは単に、自ら投入したノイズに対して従来の帳簿記録が正しいことを検証するに過ぎず、この手法の真の意義を曖昧にしてしまう。 そのため、シミュレータの例は省略し、ハードウェア上で直接PNAのワークフロー全体を実演します。Qiskitの各手順については、以下に詳しく説明します。\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "306f6858-0000-4000-8000-000000000007",
      "metadata": {},
      "source": [
        "<span id=\"large-scale-hardware-example\" />\n",
        "\n",
        "## 大規模なハードウェアの例\n",
        "\n",
        "ここでは、 IBM Quantum® ハードウェア上で実行される30サイトのキック付きイジングモデルに対し、Qiskitパターンの4つのステップに従って、PNAワークフロー全体を実行します。\n",
        "\n",
        "<span id=\"step-1-map-to-a-quantum-problem\" />\n",
        "\n",
        "### ステップ1：量子問題への対応付け\n",
        "\n",
        "**ミラーリングされたトロッター回路と観測量を生成する**\n",
        "\n",
        "この実験では、 1D のスピン鎖上の30サイトからなるキック付きアイジングモデルの時間的ダイナミクスについて検討する。 検討対象となるハミルトニアンは次のとおりである：\n",
        "\n",
        "$H = -J\\sum\\limits_{\\langle i,j \\rangle} Z_iZ_j + h\\sum\\limits_iX_i$,\n",
        "\n",
        "ここで、 $J>0$ は最近接スピン間の結合を表し、 $i<j$ であり、グローバル横磁場 $h$ は $\\frac{\\pi}{8}$ に設定される。 $h$ がクリフォード角（すなわち、 $\\theta=n\\frac{\\pi}{2}, n \\in \\mathbb{Z}$ ）から遠ざかるほど、回路内でのアンチノイズ発生器の伝播は困難になる。\n",
        "\n",
        "観測量の選択については、単一サイトの平均磁化 $\\frac{1}{N} \\sum_{i=1}^{N} \\langle z_i \\rangle$ を考慮する。ここで、 $N$ はサイトの数である。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 2,
      "id": "8fcb5af8-64f0-498a-821f-11bcd7aea203",
      "metadata": {},
      "outputs": [
        {
          "data": {
            "text/plain": [
              "<Image src=\"/docs/images/tutorials/propagated-noise-absorption/extracted-outputs/8fcb5af8-64f0-498a-821f-11bcd7aea203-0.avif\" alt=\"Output of the previous code cell\" />"
            ]
          },
          "execution_count": 2,
          "metadata": {},
          "output_type": "execute_result"
        }
      ],
      "source": [
        "num_qubits = 30\n",
        "num_trotter_steps = 10\n",
        "rx_angle = np.pi / 8\n",
        "\n",
        "# Avg single-site magnetization\n",
        "id_pauli = Pauli(\"I\" * num_qubits)\n",
        "observable = (\n",
        "    SparsePauliOp([id_pauli.dot(Pauli(\"Z\"), [i]) for i in range(num_qubits)])\n",
        "    / num_qubits\n",
        ")\n",
        "\n",
        "# Implement Trotterized kicked-Ising model\n",
        "circuit = QuantumCircuit(num_qubits)\n",
        "for _step in range(num_trotter_steps):\n",
        "    circuit.rx(rx_angle, range(num_qubits))\n",
        "    for first_qubit in (1, 2):\n",
        "        for idx in range(first_qubit, num_qubits, 2):\n",
        "            # equivalent to Rzz(-pi/2):\n",
        "            circuit.sdg([idx - 1, idx])\n",
        "            circuit.cz(idx - 1, idx)\n",
        "# Append the inverse circuit to complete the mirroring\n",
        "circuit.compose(circuit.inverse(), inplace=True)\n",
        "circuit.measure_active()\n",
        "circuit.draw(\"mpl\", fold=-1)"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "c4216992-0000-4000-8000-000000000008",
      "metadata": {},
      "source": [
        "<span id=\"step-2-optimize-the-problem-for-hardware-execution\" />\n",
        "\n",
        "### ステップ 2：ハードウェア実行向けに問題を最適化する\n",
        "\n",
        "次のステップは、実際の IBM Quantum ハードウェア上で実行できるよう、ミラーリングされたTrotter回路を準備することです。 QPU上で実行するには、単に抽象回路を構築するだけでは不十分であり、以下の条件を満たすように回路を最適化する必要があります：\n",
        "\n",
        "1. **バックエンドのネイティブなゲート設定と接続性を尊重します。**\n",
        "   トランスパイレーションとは、論理回路を、ターゲットバックエンドがサポートするISA回路に変換するプロセスである。 これにより、すべてのゲートおよび量子ビット間の相互作用が物理的に実現可能であることが保証される。\n",
        "\n",
        "2. **回路層のレベルでノイズを特徴づけることができます。**\n",
        "   PNAは、逆ノイズチャネルの学習と伝播に依存している。 これを効率的に行うために、トランスパイルされた回路を、それぞれ独立した2量子ビットの「ボックス化された」層に分割します。 これらのボックスにより、回路の各層を、それぞれ学習済みのノイズモデルに関連付けることができます。\n",
        "\n",
        "3. **PNAには、現実的なノイズモデルを組み込むことができます。**\n",
        "   回路のボックス化が完了したら、この `NoiseLearnerV3` サービスを利用して、各固有の2量子ビット層に影響を与えるパウリノイズチャネルを実験的に解明します。 これらの学習済みモデルは、Samplomaticの注釈を通じて回路に再び結び付けられます。\n",
        "\n",
        "総じて、このステップは、理想化されたミラー回路と、学習済みのノイズモデルを備えたハードウェア実装可能な回路との間のギャップを埋めるものである。 この構成により、PNAは回路を通じて逆ノイズチャネルを伝播させ、それに応じて観測量調整を行うことができる。\n",
        "\n",
        "<span id=\"connect-to-the-backend-and-transpile-to-an-isa-circuit\" />\n",
        "\n",
        "#### バックエンドに接続し、ISA回路にトランスパイルする\n",
        "\n",
        "まず、 IBM Quantum Compute Service を初期化し、バックエンドを選択します。 指示に従って[認証情報を保存し](/docs/guides/cloud-setup)、ご自身のアカウントで認証を行ってください。その後、自動的にその認証情報が読み込まれます `QiskitRuntimeService()` 。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": null,
      "id": "5c6ee966-0000-4000-8000-000000000009",
      "metadata": {},
      "outputs": [
        {
          "name": "stdout",
          "output_type": "stream",
          "text": [
            "Selected backend: ibm_fez\n"
          ]
        }
      ],
      "source": [
        "# Initialize IBM Quantum Compute Service using your saved credentials\n",
        "service = QiskitRuntimeService()\n",
        "\n",
        "backend = service.least_busy(\n",
        "    operational=True, simulator=False, min_num_qubits=num_qubits\n",
        ")\n",
        "# Re-fetch with fractional gates enabled (least_busy does not forward this)\n",
        "# Fractional gates are enabled so the non-Clifford Rx rotations are supported natively.\n",
        "backend = service.backend(backend.name, use_fractional_gates=True)\n",
        "print(f\"Selected backend: {backend.name}\")"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "bd2cea49-0000-4000-8000-000000000010",
      "metadata": {},
      "source": [
        "次に、バックエンド上で連結された量子ビットの連鎖を選択し、その連鎖上に回路をトランスパイルします。\n",
        "\n",
        "「セットアップ」セクションで定義されたヘルパー `find_qubit_chain` を使用して、接続された物理量子ビットの `num_qubits` 1行を選択します。 `initial_layout`次に、で `optimization_level=0` トランスパイルを行い、このチェーンをとして固定します。これにより、ミラー化された回路の2量子ビットゲート層構造が正確に維持されます。 この構造は、ボクシングおよびノイズ学習のステップの基盤となっているため、ここでは（ミラーゲートを無効にしてしまう）より高い最適化レベルは避ける必要があります。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 4,
      "id": "8c9afe5e-6fa3-427d-a672-becdb14490b8",
      "metadata": {},
      "outputs": [
        {
          "data": {
            "text/plain": [
              "<Image src=\"/docs/images/tutorials/propagated-noise-absorption/extracted-outputs/8c9afe5e-6fa3-427d-a672-becdb14490b8-0.avif\" alt=\"Output of the previous code cell\" />"
            ]
          },
          "execution_count": 4,
          "metadata": {},
          "output_type": "execute_result"
        }
      ],
      "source": [
        "# Find a connected, low-error chain of qubits on the chosen backend\n",
        "layout = find_qubit_chain(backend, num_qubits)\n",
        "\n",
        "# Transpile the circuit for the target backend, pinning the chain as the layout.\n",
        "# optimization_level=0 preserves the mirrored two-qubit-gate layers that the\n",
        "# boxing and noise-learning steps rely on.\n",
        "pm = generate_preset_pass_manager(\n",
        "    backend=backend, optimization_level=0, initial_layout=layout\n",
        ")\n",
        "isa_circuit = pm.run(circuit)\n",
        "isa_observable = observable.apply_layout(isa_circuit.layout)\n",
        "isa_circuit.draw(\"mpl\", fold=-1)"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "5d7f16f6-0000-4000-8000-000000000011",
      "metadata": {},
      "source": [
        "<span id=\"twirl-the-two-qubit-gate-layers-and-measurements-and-find-unique-layers\" />\n",
        "\n",
        "### 2量子ビットゲート層と測定を回転させ、一意な層を見つけ出す\n",
        "\n",
        "回路を囲み、固有の2量子ビット層を特定するために、を使用 `samplomatic` します。 ボックスとは、命令をまとめてグループ化する構造であり、これにより、特定の意図や注釈を、後で同じボックス内のすべてのゲートに一律に適用できるようになります。\n",
        "\n",
        "`generate_boxing_pass_manager`ここでは、単に2量子ビット層を特定するだけにとどまらない、というメソッドを呼び出します。 このシステムは、いくつかの重要な役割を果たしています：\n",
        "\n",
        "* 回路内のすべての2量子ビット層をグループ化し、\n",
        "* それらのレイヤーに および `ChangeBasis` の注釈を `Twirl` 適用し、\n",
        "* 測定操作をそれぞれ独立した枠付きセクションにまとめ、そして\n",
        "* 各2量子ビット層にアノテーションを `InjectNoise` 適用します。\n",
        "\n",
        "これらの注釈は、回路全体を通じてノイズ、基底の変換、およびツイリングがどのように扱われるかを定義しています。 また、これらは、後の学習やノイズの低減に用いられる構造の基礎も築くものである。\n",
        "\n",
        "主な設定オプションは以下の通りです：\n",
        "\n",
        "* `enable_gates`/`enable_measures: True`: すべての2量子ビットゲート層と終端測定をボックスで囲む。 ボックス内では、単一量子ビットゲートは左向きに配置されています。\n",
        "* `measure_annotations: all`: 測定ボックスに および `ChangeBasis` の注釈を記載 `Twirl` してください。\n",
        "* `twirling_strategy: active`: エンタングルメントゲートを含む各ボックス内のすべてのアクティブな量子ビットを回転させる。\n",
        "* `Twirl``inject_noise_targets: gates`: エンタングルメントゲートを含む、注釈が付けられているすべてのボックスに注釈を追加 `InjectNoise` する。\n",
        "* `inject_noise_strategy: uniform_modification`: 回路全体で、すべてのノイズ層を均等にスケーリングする。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 5,
      "id": "d4364c0b-2ddc-473d-8171-fd39b30a1e2d",
      "metadata": {},
      "outputs": [],
      "source": [
        "# Box up circuit with Twirl and InjectNoise annotations\n",
        "pm = generate_boxing_pass_manager(\n",
        "    enable_gates=True,\n",
        "    enable_measures=True,\n",
        "    measure_annotations=\"all\",\n",
        "    twirling_strategy=\"active\",\n",
        "    inject_noise_targets=\"gates\",\n",
        "    inject_noise_strategy=\"uniform_modification\",\n",
        ")\n",
        "boxed_circuit = pm.run(isa_circuit)"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 6,
      "id": "9c911a29-553c-4ffe-94de-1442f25e3116",
      "metadata": {},
      "outputs": [
        {
          "data": {
            "text/plain": [
              "<Image src=\"/docs/images/tutorials/propagated-noise-absorption/extracted-outputs/9c911a29-553c-4ffe-94de-1442f25e3116-0.avif\" alt=\"Output of the previous code cell\" />"
            ]
          },
          "execution_count": 6,
          "metadata": {},
          "output_type": "execute_result"
        }
      ],
      "source": [
        "draw_circ = QuantumCircuit(boxed_circuit.num_qubits)\n",
        "draw_circ.append(boxed_circuit.data[0], qargs=boxed_circuit.data[0].qubits)\n",
        "draw_circ.append(boxed_circuit.data[1], qargs=boxed_circuit.data[1].qubits)\n",
        "draw_circ.draw(\"mpl\", fold=-1, scale=0.3, idle_wires=False)"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "cc283451-0000-4000-8000-000000000014",
      "metadata": {},
      "source": [
        "回路のサンプリング方法を定義するテンプレート回路と `samplex`を生成します。\n",
        "\n",
        "`Executor`ここでは、. から出力されたサンプルに対してポストセレクションを行うために必要な、スペクテーター測定およびポストセレクション測定も追加します。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 7,
      "id": "a0ca9fbb-c572-4d49-bdef-e056c1bc82e3",
      "metadata": {},
      "outputs": [],
      "source": [
        "# Build template circuit and samplex for later use with the \"Executor\"\n",
        "template_circuit, samplex = samplomatic.build(boxed_circuit)\n",
        "\n",
        "# Add post-selection instructions to the template circuit\n",
        "post_selection_pm = PassManager(\n",
        "    [\n",
        "        AddSpectatorMeasures(backend.coupling_map),\n",
        "        AddPostSelectionMeasures(x_pulse_type=\"rx\"),\n",
        "    ]\n",
        ")\n",
        "template_circuit = post_selection_pm.run(template_circuit)"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 8,
      "id": "8d46f7b1-f0e9-4bc3-ba0f-5cc96090a945",
      "metadata": {
        "jupyter": {
          "source_hidden": true
        }
      },
      "outputs": [
        {
          "data": {
            "text/plain": [
              "<Image src=\"/docs/images/tutorials/propagated-noise-absorption/extracted-outputs/8d46f7b1-f0e9-4bc3-ba0f-5cc96090a945-0.avif\" alt=\"Output of the previous code cell\" />"
            ]
          },
          "execution_count": 8,
          "metadata": {},
          "output_type": "execute_result"
        }
      ],
      "source": [
        "draw_circ = template_circuit.copy_empty_like()\n",
        "draw_circ.data = template_circuit.data[:324]\n",
        "draw_circ.draw(\"mpl\", fold=-1, scale=0.3, idle_wires=False)"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "a45820c6-0000-4000-8000-000000000015",
      "metadata": {},
      "source": [
        "<span id=\"learn-the-noise-using-noiselearnerv3\" />\n",
        "\n",
        "### 次の方法を使ってノイズを学習します `NoiseLearnerV3`\n",
        "\n",
        "エラー低減のためにPNAを適用する前に、まず回路内の各ユニークな2量子ビット層および測定層に作用するノイズの特性を明らかにする必要があります。 このため、本研究では、前述の各層について、ノイズモデルを実験的に学習するために、この `NoiseLearnerV3` プログラムを使用する。 学習者は、各層に影響を与えるノイズチャネルを推定するベンチマーク形式の実験を実行し、学習されたモデルを含む結果オブジェクトを返します。\n",
        "\n",
        "`samplomatic`まず、からを用いて `find_unique_box_instructions` 、回路内の固有の層を特定することから始めます。 これにより、異なるレイヤータイプごとにノイズの学習を1回のみ行うことが保証され、実験回数と総ショットコストを最小限に抑えることができます。 その結果として得られたレイヤーのリストが、ノイズ学習器に渡されます。\n",
        "\n",
        "ノイズの学習方法を制御する重要なパラメータがいくつかあります：\n",
        "\n",
        "* `num_randomizations`: 学習構成ごとに使用されるランダム回路の数。\n",
        "* `shots_per_randomization`: ランダム学習回路1回あたりの撮影枚数。\n",
        "* `layer_pair_depths`: 学習実験で使用する回路の深さ（ペア数で測定）。\n",
        "* `post_selection`: ゲート `rx` を使用してエッジベースのポストセレクションを有効にし、測定後のパルスを適用します。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 9,
      "id": "24670819-0000-4000-8000-000000000016",
      "metadata": {},
      "outputs": [],
      "source": [
        "# Noise learning parameters\n",
        "num_randomizations_nl = 64\n",
        "shots_per_randomization_nl = 128\n",
        "\n",
        "# Match the deepest noise-learning depth to the depth of the circuit being\n",
        "# mitigated. ``layer_pair_depths`` are measured in layer pairs (a layer + its\n",
        "# inverse), so the deepest value is half the circuits's two-qubit-layer depth.\n",
        "# Learning to this depth improves the quality of the mitigation.\n",
        "\n",
        "depth_2q = isa_circuit.depth(lambda instr: instr.operation.num_qubits == 2)\n",
        "max_layer_pair_depth = depth_2q // 2\n",
        "\n",
        "# Use a fixed schedule of learning depths, but drop any that exceed the circuit's\n",
        "# depth and always cap the deepest value at ``max_layer_pair_depth`` so we never\n",
        "# learn deeper than the circuit being mitigated\n",
        "candidate_depths = [1, 2, 4, 8, 12, 16, 24, 32, 40, 48]\n",
        "layer_pair_depths = sorted(\n",
        "    {d for d in candidate_depths if d < max_layer_pair_depth}\n",
        "    | {max_layer_pair_depth}\n",
        ")\n",
        "\n",
        "# Find the unique instructions (layers) from the boxed-up circuit\n",
        "unique_2q_layers_and_meas = find_unique_box_instructions(\n",
        "    boxed_circuit, normalize_annotations=None, undress_boxes=True\n",
        ")\n",
        "\n",
        "# Configure and run the noise learner on the unique layers.\n",
        "# Options can be passed directly as a dictionary.\n",
        "noise_learner_options = {\n",
        "    \"num_randomizations\": num_randomizations_nl,\n",
        "    \"shots_per_randomization\": shots_per_randomization_nl,\n",
        "    \"layer_pair_depths\": layer_pair_depths,\n",
        "    \"post_selection\": {\n",
        "        \"enable\": True,\n",
        "        \"strategy\": \"edge\",\n",
        "        \"x_pulse_type\": \"rx\",\n",
        "    },\n",
        "    \"environment\": {\"job_tags\": [\"TUT_PNA\"]},\n",
        "}\n",
        "\n",
        "noise_learner = NoiseLearnerV3(backend, noise_learner_options)\n",
        "noise_learner_job = noise_learner.run(unique_2q_layers_and_meas)\n",
        "noise_learner_result = noise_learner_job.result()"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "aa248719-0000-4000-8000-000000000017",
      "metadata": {},
      "source": [
        "<span id=\"visualize-the-learned-noise-rates\" />\n",
        "\n",
        "### 学習されたノイズ率を可視化する\n",
        "\n",
        "ノイズモデルを学習した後、1量子ビット演算と2量子ビット演算の両方について、推定された誤り率の分布を調べることができます。 以下のコードは、学習されたノイズの結果からパウリ・リンドブラッド表現を抽出し、対応するノイズ率を収集します。\n",
        "\n",
        "学習済みの各層について：\n",
        "\n",
        "* ノイズモデルを、タプルの `(pstr, qubits, rate)` 疎なリストに変換する。ここで、 `pstr` は与えられた量子ビットに作用するパウリ文字列であり、 `rate` はそれに対応するエラー率である。\n",
        "* 率を、1クビット（`len(pstr) == 1`）項と2クビット（`len(pstr) == 2`）項に分けます。\n",
        "* その後、料金一覧を並べ替え、その中央値を算出する。\n",
        "\n",
        "1量子ビット（赤）および2量子ビット（青）のノイズ率分布を対数スケールでプロットし、その中央値を垂直線で示すことで、学習されたパウリ・リンドブラッド生成子の相対的な大きさを比較できるようにした。 1クビットおよび2クビットの発生率の順位は、デバイスや特性評価の対象となる特定の層によって異なります。今回の実験では、単一クビット（ weight-1 ）の発生源の方が、より高い中央値を示しています。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 10,
      "id": "b1a8ad48-2875-41e0-92c4-c28b34083e6b",
      "metadata": {
        "jupyter": {
          "source_hidden": true
        }
      },
      "outputs": [
        {
          "data": {
            "text/plain": [
              "<matplotlib.legend.Legend at 0x125336120>"
            ]
          },
          "execution_count": 10,
          "metadata": {},
          "output_type": "execute_result"
        },
        {
          "data": {
            "text/plain": [
              "<Image src=\"/docs/images/tutorials/propagated-noise-absorption/extracted-outputs/b1a8ad48-2875-41e0-92c4-c28b34083e6b-1.avif\" alt=\"Output of the previous code cell\" />"
            ]
          },
          "metadata": {},
          "output_type": "display_data"
        }
      ],
      "source": [
        "hw_rates_1q = []\n",
        "hw_rates_2q = []\n",
        "for nlr in noise_learner_result[:2]:\n",
        "    plm_list = nlr.to_pauli_lindblad_map().to_sparse_list()\n",
        "    hw_rates_1q += [\n",
        "        rate for (pstr, qubits, rate) in plm_list if len(pstr) == 1\n",
        "    ]\n",
        "    hw_rates_2q += [\n",
        "        rate for (pstr, qubits, rate) in plm_list if len(pstr) == 2\n",
        "    ]\n",
        "hw_rates_1q = sorted(hw_rates_1q)\n",
        "hw_rates_2q = sorted(hw_rates_2q)\n",
        "median_1q = hw_rates_1q[len(hw_rates_1q) // 2]\n",
        "median_2q = hw_rates_2q[len(hw_rates_2q) // 2]\n",
        "fig, ax = plt.subplots(1, 1, figsize=(14, 5))\n",
        "ax.scatter(\n",
        "    (hw_rates_1q),\n",
        "    [(i) / (len(hw_rates_1q) - 1) for i in range(len(hw_rates_1q))],\n",
        "    color=\"red\",\n",
        "    label=\"1q rates\",\n",
        ")\n",
        "ax.set_xscale(\"log\")\n",
        "ax.set_ylim(0, 1.1)\n",
        "ax.vlines(median_1q, 0, 1, color=\"red\")\n",
        "ax.text(median_1q * 1.1, 0.1, f\"{median_1q:.2e}\")\n",
        "ax.scatter(\n",
        "    (hw_rates_2q),\n",
        "    [(i) / (len(hw_rates_2q) - 1) for i in range(len(hw_rates_2q))],\n",
        "    color=\"blue\",\n",
        "    label=\"2q rates\",\n",
        ")\n",
        "ax.set_xscale(\"log\")\n",
        "ax.set_ylim(0, 1.1)\n",
        "ax.vlines(median_2q, 0, 1, color=\"blue\")\n",
        "ax.text(median_2q * 1.1, 0.2, f\"{median_2q:.2e}\")\n",
        "ax.set_title(\"Learned noise rates\")\n",
        "ax.set_xlabel(\"Noise rate\")\n",
        "ax.set_yticks([])\n",
        "plt.legend()"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "f8a91705-0000-4000-8000-000000000018",
      "metadata": {},
      "source": [
        "<span id=\"associate-circuit-boxes-with-learned-noise\" />\n",
        "\n",
        "### 学習されたノイズと配電盤を関連付ける\n",
        "\n",
        "各ユニークな2量子ビット層のノイズモデルを取得したら、それらをボックスで囲まれた回路内の対応 `InjectNoise` する注釈と関連付ける必要があります。\n",
        "\n",
        "この `InjectNoise` ディレクティブは、シングルクビット・ドレッサーを用いて、制御可能かつ設定可能な方法で回路にノイズを注入するアノテーション `samplomatic` です。 これにより、異なるレイヤーにわたるモジュール式のノイズモデリングが可能になります。\n",
        "\n",
        "各アノテーションには `InjectNoise` 、以下の内容が含まれます：\n",
        "\n",
        "* `InjectNoise.ref` - アノテーションを一意に識別するための識別子。 これは、オブジェクトが `samplex` 対応するノイズモデルを正しく割り当てるために使用されます。\n",
        "* `InjectNoise.modifier_ref` *(オプション)* - 割り当てられたノイズモデルを乗数でスケーリングするための二次参照。\n",
        "\n",
        "このステップでは、各 `InjectNoise.ref` とそれに対応する学習済みノイズモデル (`PauliLindbladMap`) との間の対応関係を構築します。この対応関係により、回路内の各エンタングルメントゲート層が適切なノイズモデルと結びつけられ、サンプリングおよびその後のノイズ低減ステップにおいて、ノイズの影響が正確に適用されるようになります。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 11,
      "id": "e172d227-7a04-48ba-8566-d5f3007ef7bc",
      "metadata": {},
      "outputs": [],
      "source": [
        "# map inject noise refs to pauli lindblad maps\n",
        "refs_to_noise_models = {}\n",
        "for instruction, result in zip(\n",
        "    unique_2q_layers_and_meas, noise_learner_result, strict=False\n",
        "):\n",
        "    if inject_noise_annot := get_annotation(\n",
        "        instruction.operation, InjectNoise\n",
        "    ):\n",
        "        refs_to_noise_models[inject_noise_annot.ref] = (\n",
        "            result.to_pauli_lindblad_map()\n",
        "        )"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "7ab22f68-0000-4000-8000-000000000019",
      "metadata": {},
      "source": [
        "<span id=\"propagate-the-observable-through-the-learned-anti-noise\" />\n",
        "\n",
        "### 学習されたアンチノイズを通じてオブザーバブルを伝播させる\n",
        "\n",
        "前述の通り、これは2つのステップで行われます。 まず、アンチノイズ発生器を回路の末端まで伝播させます。 その後、その進化させた生成子を通じて観測可能量を伝播させます。 この処理は、回路内の各アンチノイズ発生器について繰り返される。 この実装では、特定の層にある各ジェネレータの出力が、回路の末端まで並列に伝播される。 さらに、 Python のマルチプロセッシング機能を用いて、アンチノイズの前方伝播と観測量の後方伝播の両方を並列に実行しています。 これにより、メモリ内での進化済みジェネレータの蓄積を防ぎ、計算リソースを最大限に活用することができます。\n",
        "\n",
        "PNAを実行する際は、必ずノイズの混入した回路と観測対象を指定する必要があります。 ノイズの多い回路が、注釈付きの `InjectNoise` ボックス付き回路である場合は、前の手順で作成したマッピングを指定する必要があります。 `qiskit-aer`また、から命令を含む `PauliLindbladError` 、ボックス化されていない回路を渡すこともできます。 その場合は、 `refs_to_noise_models` 指定する必要はありません。 主な入力情報に加え、以下の点についても考慮してください：\n",
        "\n",
        "* `max_err_terms`: 各アンチノイズ生成器において、前方伝播が行われる際に保持する項の数。 この値を大きくすると、一般的に精度は向上しますが、この挙動が単調増加することは保証されません。\n",
        "* `max_obs_terms`: ノイズ低減観測量 $\\tilde{O}$ において、進化したアンチノイズを通じてバックプロパゲーションが行われる際に保持される項の数。 値が大きくなるほど、一般に精度は向上しますが、その向上が単調に続くとは限りません。\n",
        "* `num_processes`: このプロセスに割り当てるコア数。 ジェネレータは前方伝播され、観測可能変数に並列に適用されることを忘れないでください。\n",
        "* `search_step`: バックプロパゲーションのステップでは、貪欲法を用いて、パウリ基底における2つの演算子を近似的に共役させる。 `search_step`この処理は、...を増やすことで高速化できます。 詳細については、こちら [`pauli-prop` ドキュメント](https://qiskit.github.io/pauli-prop/) をご覧ください。\n",
        "* `generate_noise_mitigating_observable``num_to_measure`: この変数は の入力変数ではありませんが、 $\\tilde{O}$ から実際に測定したい項の数を制御するために使用します。 ここでは、オブザーバブルに含まれる元の用語である上位30用語のみを測定します。 これらの項は、測定を行うことで学習されたゲートノイズを低減する効果が生じるよう、スケーリングが再調整されました。 $\\tilde{O}$ から30項しか測定していないものの、これを大きく設定しておくと、上位項のスケーリング係数の精度が向上するため、多くの場合、依然として有用です。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 12,
      "id": "19407dc3-eec0-4323-9a8a-47e949fb6ae2",
      "metadata": {},
      "outputs": [
        {
          "name": "stdout",
          "output_type": "stream",
          "text": [
            "Finished! 13740 / 13740 generators propagated.                       "
          ]
        }
      ],
      "source": [
        "# PNA parameters\n",
        "num_processes = 8\n",
        "max_err_terms = 10_000\n",
        "max_obs_terms = 10_000\n",
        "num_to_measure = num_qubits\n",
        "\n",
        "obs_tilde_isa = generate_noise_mitigating_observable(\n",
        "    boxed_circuit,\n",
        "    isa_observable,\n",
        "    refs_to_noise_models,\n",
        "    max_err_terms=max_err_terms,\n",
        "    max_obs_terms=max_obs_terms,\n",
        "    num_processes=num_processes,\n",
        "    print_progress=True,\n",
        "    search_step=8,\n",
        ")\n",
        "p_2_v = {p: v for v, p in enumerate(layout)}\n",
        "obs_tilde_virtual = SparsePauliOp.from_sparse_list(\n",
        "    [\n",
        "        (pstr, [p_2_v[p] for p in p_qubits], coeff)\n",
        "        for (pstr, p_qubits, coeff) in obs_tilde_isa.to_sparse_list()\n",
        "    ],\n",
        "    num_qubits=num_qubits,\n",
        ")\n",
        "obs_tilde_virtual = obs_tilde_virtual[\n",
        "    np.argsort(np.abs(obs_tilde_virtual.coeffs))[::-1]\n",
        "][:num_to_measure]"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 13,
      "id": "77246aef-1892-4a27-bbf0-128b12206581",
      "metadata": {
        "jupyter": {
          "source_hidden": true
        }
      },
      "outputs": [
        {
          "data": {
            "text/plain": [
              "[<matplotlib.lines.Line2D at 0x124b0a120>]"
            ]
          },
          "execution_count": 13,
          "metadata": {},
          "output_type": "execute_result"
        },
        {
          "data": {
            "text/plain": [
              "<Image src=\"/docs/images/tutorials/propagated-noise-absorption/extracted-outputs/77246aef-1892-4a27-bbf0-128b12206581-1.avif\" alt=\"Output of the previous code cell\" />"
            ]
          },
          "metadata": {},
          "output_type": "display_data"
        }
      ],
      "source": [
        "obs_tilde_isa = obs_tilde_isa[np.argsort(np.abs(obs_tilde_isa.coeffs))][::-1]\n",
        "plt.xscale(\"log\")\n",
        "plt.yscale(\"log\")\n",
        "plt.title(r\"$\\tilde{O}$ coeff magnitudes\")\n",
        "plt.ylabel(\"Magnitude\")\n",
        "plt.xlabel(\"Pauli term index\")\n",
        "plt.plot(np.abs(obs_tilde_isa.coeffs), \".\")"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "e02700bb-0000-4000-8000-000000000020",
      "metadata": {},
      "source": [
        "<span id=\"transform-the-measurement-bases-to-canonical-form\" />\n",
        "\n",
        "### 測定基底を標準形に変換する\n",
        "\n",
        "次に、測定対象の観測量に含まれるすべてのパウリ項を完全に網羅できるような、測定用の最小限の基底の集合を求めます（ *クビットごとに可換であれば、複数の観測量を同時に測定することも可能です* ）。 `Z` 元の観測可能量（すべての単一`Z` パウリ演算子の和）に含まれる項のみを測定しているため、必要な基底は1つだけであり、それは「全基底」である。\n",
        "\n",
        "`Executor`パウリの測定基底のセットを見つけることに加え、これらのパウリ項を、が想定する標準形に写像する必要があります。 標準的な量子ビットの順序付けに関する詳細については、 [Samplomaticのドキュメント](https://qiskit.github.io/samplomatic/guides/samplex_io.html#qubit-ordering-convention)をご覧ください。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 14,
      "id": "a0ff4edd-434a-4aa5-8175-075e1472c81e",
      "metadata": {},
      "outputs": [],
      "source": [
        "meas_box = boxed_circuit.data[-1]\n",
        "canonical_qubits = [\n",
        "    idx\n",
        "    for idx, qubit in enumerate(boxed_circuit.qubits)\n",
        "    if qubit in meas_box.qubits\n",
        "]\n",
        "c_2_p = {\n",
        "    c: p for c, p in enumerate(canonical_qubits)\n",
        "}  # canonical -> physical\n",
        "p_2_v = {p: v for v, p in enumerate(layout)}  # physical -> virtual\n",
        "c_2_v = {c: p_2_v[p] for c, p in c_2_p.items()}  # canonical -> virtual\n",
        "meas_bases, bases_reverser = get_measurement_bases(obs_tilde_virtual)\n",
        "meas_bases_canonical = [\n",
        "    np.array([base[c_2_v[c]] for c in range(num_qubits)], dtype=np.uint8)\n",
        "    for base in meas_bases\n",
        "]"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "24c95aca-0000-4000-8000-000000000021",
      "metadata": {},
      "source": [
        "<span id=\"step-3-execute-quantum-experiments\" />\n",
        "\n",
        "### ステップ3：量子実験の実施\n",
        "\n",
        "<span id=\"specify-how-to-sample-in-the-quantumprogram\" />\n",
        "\n",
        "#### サンプリング方法を `QuantumProgram`\n",
        "\n",
        "`Executor``QuantumProgram`ここで、によって実行されるすべての回路およびサンプリング設定の中核となるコンテナとして機能する を設定します。 このオブジェクトは、PNAで使用される測定結果を生成するために、ランダム化された回路インスタンスがどのように生成、バッチ処理、および実行されるかを定義します。\n",
        "\n",
        "A には複数の項目 `QuantumProgram` を含めることができ、各項目はテンプレート回路と、ランダム化の適用方法を定義する対応 `samplex` するオブジェクトで構成されます。 この抽象化により、ランダムな回路生成からショットの収集・集約に至るまで、ワークフロー全体を単一のモジュール式プログラムとして処理することが可能 `Executor` になります。\n",
        "\n",
        "この手順では、先ほど作成したテンプレート回路と `samplex` を使用して、PNA実験を実行する を作成します `QuantumProgram` 。 この構成には、以下の要素が含まれます：\n",
        "\n",
        "* `template_circuit`: 希望するすべてのランダム化（ツイリングによるランダム化、パラメータなど）を実現するために必要なすべてのゲートを含む回路。\n",
        "* `samplex`: サンプリングの対象となる、回路のすべての可能なランダム化について確率分布を定義するオブジェクト。\n",
        "* `samplex_arguments`: を完全に定義するために必要なバインディングは、 `samplex`\n",
        "  * `basis_changes`: ここでは、測定対象の観測量に含まれるすべてのパウリ項を網羅するように、測定に用いる基底の集合を指定します。\n",
        "  * `noise_scales.ref`: サンプルに余分なノイズが混入するのを防ぐため、各ノイズレイヤーのスケールを に `0.0` 設定しました。\n",
        "  * `pauli_lindblad_maps`: が渡された場合に `noise_scales` 必須です。 これは、ノイズレイヤーを関連するノイズモデルにマッピングするだけです。\n",
        "* `samplex_arguments``shape`: で定義された暗黙の形状を拡張するための形状タプル。 この拡張によって導入される非自明な軸は、ランダム化を列挙する。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 15,
      "id": "7958cdd5-37b9-48ab-a1b1-5bf2a6bcf13e",
      "metadata": {},
      "outputs": [],
      "source": [
        "# Control the # of shots during execution\n",
        "shots_per_randomization_exec = 64\n",
        "num_randomizations_exec = 6144\n",
        "\n",
        "# Zero out the noise to prevent noise from being injected during execution.\n",
        "# We only added InjectNoise annotations so PNA could associate the noise\n",
        "# to layers in the circuit\n",
        "samplex_inputs = {f\"noise_scales.{ref}\": 0.0 for ref in refs_to_noise_models}\n",
        "samplex_inputs |= {\"pauli_lindblad_maps\": refs_to_noise_models}\n",
        "\n",
        "# Specify the bases to measure. The samplex exposes one basis-change input per\n",
        "# ChangeBasis-annotated box; here a single all-Z basis covers every term. We\n",
        "# look up the basis-change interface name rather than hardcoding an index, since\n",
        "# the name depends on the circuit's box structure.\n",
        "bases_broadcastable = np.expand_dims(np.array(meas_bases_canonical), axis=1)\n",
        "samplex_inputs |= {\n",
        "    spec.name: bases_broadcastable\n",
        "    for spec in samplex.inputs().get_specs(r\"^basis_changes\\.\")\n",
        "}\n",
        "\n",
        "# Convert samplex_inputs into a dict to pass to QuantumProgram\n",
        "samplex_arguments = (\n",
        "    samplex.inputs().make_broadcastable().bind(**samplex_inputs)\n",
        ")\n",
        "\n",
        "# Instantiate the QuantumProgram with the specified parameters\n",
        "program = QuantumProgram(shots=shots_per_randomization_exec)\n",
        "program.append_samplex_item(\n",
        "    circuit=template_circuit,\n",
        "    samplex=samplex,\n",
        "    samplex_arguments=samplex_arguments,\n",
        "    shape=(num_randomizations_exec,),\n",
        ")"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "b7caba08-0000-4000-8000-000000000022",
      "metadata": {},
      "source": [
        "<span id=\"sample-the-circuit-using-the-executor\" />\n",
        "\n",
        "#### 以下の方法を使用して回路の動作を確認してください。 `Executor`\n",
        "\n",
        "`QuantumProgram`これで定義が完了したので、実験の実行は簡単です。 オブジェクトを `Executor` インスタンス化し、バックエンドを指定して、プログラムを実行するだけです。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 16,
      "id": "44202d02-0000-4000-8000-000000000023",
      "metadata": {},
      "outputs": [],
      "source": [
        "# Execute (sample) the circuit\n",
        "executor = Executor(backend)\n",
        "job_exec = executor.run(program)\n",
        "exec_results = job_exec.result()"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "bb61dcec-0000-4000-8000-000000000024",
      "metadata": {},
      "source": [
        "<span id=\"step-4-reconstruct-and-analyze-results\" />\n",
        "\n",
        "### ステップ4：結果を再構築し、分析する\n",
        "\n",
        "誤差を軽減した期待値を計算するには、次のように行います：\n",
        "\n",
        "* 測定値に影響を与える、学習済みのノイズに基づいて、TREXのスケーリング係数を算出する\n",
        "* 選択後のサンプルのみを保持するためのマスクを生成し、\n",
        "* の `qiskit-addon-utils` 関数 `executor_expectation_values` を使用して、すべてのデータを統合し、誤差を低減した期待値を算出する。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 17,
      "id": "1ba3b057-a809-402d-8fd6-4314956dc98e",
      "metadata": {},
      "outputs": [],
      "source": [
        "# Computing the TREX factors\n",
        "measurement_noise_map = noise_learner_result[2].to_pauli_lindblad_map()\n",
        "trex_rescale_factors = trex_factors(measurement_noise_map, bases_reverser)\n",
        "\n",
        "# Post-select the results\n",
        "post_selector = PostSelector.from_circuit(\n",
        "    circuit=template_circuit, coupling_map=backend.coupling_map\n",
        ")\n",
        "\n",
        "# Compute the ps mask for filtering results\n",
        "mask = post_selector.compute_mask(exec_results[0], strategy=\"edge\")\n",
        "\n",
        "# Compute expvals using post selected results\n",
        "results = executor_expectation_values(\n",
        "    exec_results[0][\"meas\"],\n",
        "    bases_reverser,\n",
        "    meas_basis_axis=0,\n",
        "    avg_axis=1,\n",
        "    measurement_flips=exec_results[0][\"measurement_flips.meas\"],\n",
        "    pauli_signs=exec_results[0].get(\"pauli_signs\", None),\n",
        "    postselect_mask=mask,\n",
        "    rescale_factors=trex_rescale_factors,\n",
        ")"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "aed4c6f9-0000-4000-8000-000000000025",
      "metadata": {},
      "source": [
        "<span id=\"compare-mitigation-strategies-pna-pna+trex-pna+ps-pna+ps+trex\" />\n",
        "\n",
        "#### 緩和策の比較：PNA、PNA+TREX、PNA+PS、PNA+PS+TREX\n",
        "\n",
        "この `Executor` 結果を用いて、いくつかの緩和策のバリエーションについて期待値を計算し、可視化します。\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 18,
      "id": "8df9366c-d456-416b-80ab-3b941a07a935",
      "metadata": {},
      "outputs": [
        {
          "data": {
            "text/plain": [
              "<Image src=\"/docs/images/tutorials/propagated-noise-absorption/extracted-outputs/8df9366c-d456-416b-80ab-3b941a07a935-0.avif\" alt=\"Output of the previous code cell\" />"
            ]
          },
          "metadata": {},
          "output_type": "display_data"
        }
      ],
      "source": [
        "bases_reverser_unmit = {Pauli(\"Z\" * num_qubits): [observable]}\n",
        "args = [\n",
        "    (bases_reverser_unmit, None, None),\n",
        "    (bases_reverser, None, None),\n",
        "    (bases_reverser, None, trex_rescale_factors),\n",
        "    (bases_reverser, mask, None),\n",
        "    (bases_reverser, mask, trex_rescale_factors),\n",
        "]\n",
        "\n",
        "evs = []\n",
        "for reverser, postsel_mask, factors in args:\n",
        "    # Compute expvals using post selected results\n",
        "    res_ps = executor_expectation_values(\n",
        "        exec_results[0][\"meas\"],\n",
        "        reverser,\n",
        "        meas_basis_axis=0,\n",
        "        avg_axis=1,\n",
        "        measurement_flips=exec_results[0][\"measurement_flips.meas\"],\n",
        "        pauli_signs=exec_results[0].get(\"pauli_signs\", None),\n",
        "        postselect_mask=postsel_mask,\n",
        "        rescale_factors=factors,\n",
        "    )\n",
        "    res_ps = np.array(res_ps)\n",
        "    evs.append(res_ps[:, 0][0])\n",
        "\n",
        "experiments = [\"PNA\", \"PNA+TREX\", \"PNA+PS\", \"PNA+PS+TREX\"]\n",
        "colors = [\"#d9d9d9\", \"#b0b0b0\", \"#7f7f7f\", \"#4c4c4c\"]\n",
        "plt.bar(experiments, evs[1:], color=colors)\n",
        "plt.axhline(y=1, color=\"green\", linestyle=\"--\", linewidth=2, label=\"Ideal\")\n",
        "plt.axhline(\n",
        "    y=evs[0], color=\"red\", linestyle=\"--\", linewidth=2, label=\"Unmitigated\"\n",
        ")\n",
        "plt.ylabel(\"Expectation value\", fontsize=14)\n",
        "\n",
        "plt.title(\n",
        "    r\"30q Mirrored Ising, 10 Trotter steps, $\\theta_{rx}=\\frac{\\pi}{8}$\",\n",
        "    fontsize=14,\n",
        ")\n",
        "plt.legend(loc=\"upper left\", bbox_to_anchor=(1.05, 1), borderaxespad=0.0)\n",
        "plt.xticks(rotation=45)\n",
        "plt.tight_layout()\n",
        "plt.show()"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "9589eae8-0000-4000-8000-000000000026",
      "metadata": {},
      "source": [
        "この結果は、さまざまなエラー軽減手法を組み合わせることによる相乗効果を示している。 単純なPNAアプローチだけでも、期待値は理想的なベンチマーク値に近づいており、これは、逆ノイズチャネルを観測量に伝播させることで、2量子ビットゲートの誤差を効果的に補償できることを示している。\n",
        "\n",
        "* TREXによる再重み付け（PNA+TREX）を追加することで、無作為化された回路におけるサンプリングの不均衡を補正し、推定精度がわずかに向上する。\n",
        "* ポストセレクション（PNA+PS）は、残留誤差に起因すると考えられる一貫性のない測定結果をフィルタリングすることで、より顕著な性能向上をもたらします。\n",
        "* 最後に、これら3つ（PNA＋PS＋TREX）を組み合わせることで、理想値にほぼ匹敵する最も正確な結果が得られ、これらの緩和策が互いに補完し合っていることが示された。\n",
        "\n",
        "全体として、この比較から、PNAがノイズを考慮した期待値推定の堅牢な基盤として機能する一方で、TREXとポストセレクションは、さらなる精度向上のために相互に補完的な改良をもたらすことが明らかになった。\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "a1b2c3d4-9999-4000-8000-000000000099",
      "metadata": {},
      "source": [
        "<span id=\"next-steps\" />\n",
        "\n",
        "## 次のステップ\n",
        "\n",
        "この作品に興味を持たれた方は、以下の資料もご参照ください：\n",
        "\n",
        "<Admonition type=\"tip\" title=\"推奨事項\">\n",
        "  * [エラー軽減オプションをEstimatorプリミティブと組み合わせる](/docs/tutorials/combine-error-mitigation-techniques)\n",
        "  * [確率的誤差増幅を用いたユーティリティー規模のエラー緩和](/docs/tutorials/probabilistic-error-amplification)\n",
        "  * [期待値の推定のためのオペレータバックプロパゲーション（OBP）](/docs/tutorials/operator-back-propagation)\n",
        "  * および [`pauli-prop`](https://github.com/Qiskit/pauli-prop) の [`samplomatic`](https://github.com/Qiskit/samplomatic) ドキュメント\n",
        "</Admonition>\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"
    },
    "hours": 3,
    "qpuSeconds": 600
  },
  "nbformat": 4,
  "nbformat_minor": 5
}