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

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

再利用パターン:QKernelの合成とコンポジットゲート

タグ: tutorial

回路が大きくなると、ゲート列のコピー&ペーストを避けたくなります。Qamomileは2つの再利用メカニズムを提供しています:

  1. ヘルパーQKernel — ある@qkernelを別の@qkernelから呼び出す、通常の関数合成と同じ方法です。

  2. @composite_gate — 量子カーネルをカスタム可能な名前付きゲートに昇格させ、図中で単一のボックスとして表示します。

さらにトップダウン設計のための第3のパターンもあります:

  1. 不透明オラクル — 実装本体を持たない呼び出しで、トップダウン設計とリソース推定に使います。完全なオラクル実装がなくても、呼び出し構造を推定できます。

パターン1:ヘルパーQKernel

どの@qkernel関数も別の@qkernelから呼び出せます。トランスパイル時にインライン展開されるため、トランスパイル結果はフラットな回路になります。

<Figure size 1500.5x336 with 1 Axes>
GHZ result: [((1, 1, 1, 1), 70), ((0, 0, 0, 0), 58)]

ヘルパーentangle_onceにより、呼び出し側のコードが読みやすくなります。トランスパイル後の回路ではインライン展開されるため、サブブロックではなく個々のCXゲートが見えます。

     ┌───┐          ┌─┐              
q_0: ┤ H ├──■───────┤M├──────────────
     └───┘┌─┴─┐     └╥┘     ┌─┐      
q_1: ─────┤ X ├──■───╫──────┤M├──────
          └───┘┌─┴─┐ ║      └╥┘┌─┐   
q_2: ──────────┤ X ├─╫───■───╫─┤M├───
               └───┘ ║ ┌─┴─┐ ║ └╥┘┌─┐
q_3: ────────────────╫─┤ X ├─╫──╫─┤M├
                     ║ └───┘ ║  ║ └╥┘
c: 4/════════════════╩═══════╩══╩══╩═
                     0       1  2  3 

ヘルパーへのスカラーリテラルの受け渡し

ヘルパーqkernelがスカラー型(UInt,Float,Bit)のパラメータを宣言している場合、呼び出し側ではPythonの生のリテラルをそのまま渡せます。QamomileがintをUInt、floatをFloat、boolをBitに自動昇格します。helper(q, 0, 0.5)はhelper(q, qmc.uint(0), qmc.float_(0.5))と等価です。明示的なqmc.uint/qmc.float_/qmc.bitコンストラクタは、値に名前を付けたい場合や複数の呼び出し箇所で共有したい場合にのみ使えば十分です。

<Figure size 786.5x424 with 1 Axes>

大きなワークスペースをqmc.structで整理する

小さなヘルパーでは、使用する量子ビットやレジスタを個別の引数として渡しても十分に読みやすく保てます。一方、多くの量子ビットや補助レジスタを同時に扱う実装では、関数の引数と戻り値が長くなりがちです。

@qmc.structを使うと、関連するQamomileハンドルを名前付きフィールドにまとめられます。次の例では、Bell状態の準備に使う2つの量子ビットをBellWorkspaceとして扱います。

prepare_bellはworkspaceを受け取り、ゲートが返した新しいハンドルを持つBellWorkspaceを返します。qmc.structはimmutableなrecordとして扱い、呼び出し側ではworkspace = prepare_bell(workspace)と受け直します。これにより、現在のハンドルを保持するrecordがコード上で明確になります。

フィールドに入っているQubitやVector[Qubit]には、通常と同じアフィン規則が適用されます。structを別の変数へ代入した場合、二つのrecordは同じ量子ハンドルを参照します。各量子操作が返したハンドルを新しいrecordへ渡し、以降の処理ではそのrecordを使います。Vector[Qubit]の要素に対するborrowと返却はVector自身が管理します。

BellWorkspaceは回路のトレース中に、関連するハンドルを名前付きフィールドへ整理します。生成されるIRにはフィールド内の量子操作が記録されます。リソース推定を使うと、2量子ビットのBell回路として構築されたことを確認できます。

<Figure size 882.5x200 with 1 Axes>
Bell result: [((1, 1), 66), ((0, 0), 62)]

このようにワークスペースを一つの値として受け渡すと、多数のハンドルを長いタプルの代わりに名前付きフィールドで扱えます。

パターン2:@composite_gate

再利用可能なブロックを回路図で名前付きボックスとして表示したい場合@composite_gateでを使うこともできます。また、より高度な内容としてコンポジットゲートにすることで複数の実装方式を与えるといったカスタム設定を与えることも可能です。

@qkernelの上に@composite_gate(name="...")を重ねて書きます:

<Figure size 1243.5x336 with 1 Axes>

どちらを使うべきか?

パターンdraw()での表示使用場面
ヘルパー@qkernelインライン展開(フラット)コードの整理
@composite_gate名前付きボックスドメインレベルの抽象化/高度なカスタム

パターン3:トップダウン設計のための不透明オラクル

オラクル内部が未知のまま回路を組みたい場合は、名前・量子ビット数だけを持つqmc.Oracleを使えます。

オラクルあるいはサブルーチンが開発中でも、アルゴリズム全体のコストを推定できます。

推定時にUnknownResourcePolicy.OPAQUE_CALLを指定すると、未実装の呼び出しをopaque call/queryとして記録します。

<Figure size 600x256 with 1 Axes>

不透明オラクルを含むqkernelのリソース推定

estimate_resources()は、オラクル内部が未実装でもqkernel全体を解析できます。既知の回路部分は通常どおり集計され、未知部分はest.calls.oracle_calls / est.calls.oracle_queriesとして追跡されます。

qubits: 3
total gates: 3

次に、通常ゲートと複数の不透明オラクルを混在させたqkernelで確認します。

<Figure size 3661.5x256 with 1 Axes>
total gates: 3*rounds + 3
two-qubit gates: 2*rounds + 1
oracle_calls: {'oracle': rounds + 1, 'mixing': rounds}
oracle_queries: {'oracle': rounds + 1, 'mixing': rounds}

roundsに具体的な値を代入して、数値的なカウントを確認します:

oracle_calls (rounds=4): {'oracle': 5, 'mixing': 4}
oracle_queries (rounds=4): {'oracle': 5, 'mixing': 4}

この例のように、オラクル内部が不明でもリソース解析を進められます。既知部分は通常どおりカウントされ、未知のオラクル呼び出しはcalls.oracle_callsとcalls.oracle_queriesに名前別で記録されます。

このように完全な分解を実装する前にアルゴリズムレベルのコスト(量子ビット数、オラクルクエリ数等)を確認できます。

まとめ

  • ヘルパー@qkernel:ある量子カーネルから別の量子カーネルを呼び出してコードを再利用できます。トランスパイラがインライン展開し、結果はフラットな回路になります。

  • qmc.struct:関連する量子ハンドルをトレース時のrecordにまとめ、更新後のstructを明示的に返すことで長いタプルを避けられます。

  • @composite_gate:量子カーネルに名前付きの識別子を与え、図で一つのゲートとして可視化します。@qkernelの上に@composite_gateデコレータを重ねて書きます。

  • 不透明オラクル:qmc.Oracleにより、実装なしでトップダウン設計ができます。

  • est.calls.oracle_calls:UnknownResourcePolicy.OPAQUE_CALLを使うと、名前別の呼び出し回数を確認できます。

制御ゲート(qmc.control)についてはチュートリアル04 — 制御ゲートを参照してください。