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.

Vectorのスライシング

タグ: tutorial

チュートリアル02ではパラメータ付き量子カーネルの構築方法と、単一量子ビットゲートのブロードキャスト機能を紹介しました。本章では、より複雑な量子カーネルを記述するのに役立つQamomileの機能、スライシングを紹介します。

スライスの基本構文

Vector[Qubit]をPythonのslice(start:stop:step)でインデックスすると、VectorViewが返されます。これは親Vectorの部分範囲を指すハンドルですが、ほとんどのケースでは通常のVector[Qubit]と同じように扱えます。

<Figure size 600x496 with 1 Axes>

demoで注目すべき点:

  • evens = q[0::2]はqの偶数番目の量子ビットを覆うVectorViewを作成します。同様にodds = q[1::2]はqの奇数番目の量子ビットを覆うVectorViewを作成します。

  • ループ内のevens[i] = qmc.h(evens[i])はチュートリアル02で見たアフィン型のパターンと同じで、各要素は消費され、新しい要素ハンドルがその位置に格納されます。

  • VectorViewはVector[Qubit]とほとんど同じように使用できます。

インライン短縮形

本体がブロードキャスト可能な単一の操作なら、VectorViewに名前を付ける必要はありません。借りる、変換する、返すを1ステートメントで完結できます。

<Figure size 600x496 with 1 Axes>

ネストしたスライス

VectorViewそのものをさらにスライスし、新たなVectorViewを取り出すこともできます。結果は親VectorViewの部分範囲を覆うVectorViewとなります。各階層は1つ上の階層から借り、各階層は祖父にあたる階層に触る前に直接の親に返さなければなりません。

例えば、outer = q[0::2]とinner = outer[1:3]があるとき、返却順序はinner → outer → rootです。まずinnerをouterに、次にouterをqに返します。

<Figure size 600x496 with 1 Axes>

VectorViewをヘルパーカーネルに渡す

VectorViewは外部の量子カーネルに渡されるときはVector[Qubit]と同様に扱われます。

<Figure size 850.5x828 with 1 Axes>

これはqamomile.circuit.stdlibの組み込み関数にも適用されます。qmc.qft、qmc.iqft、qmc.qpeはいずれもVector[Qubit]を取り、VectorViewに対しても同様に動きます。

<Figure size 631.5x496 with 1 Axes>

スライシングによる量子ビット配列の分割

Qamomileでは、量子ビット配列Vector[Qubit]そのものを分割したり統合したりすることはできません。一方で、スライシング機能を駆使すると、一つの大きな量子ビット配列から複数のVectorViewに分けて取り出すことができ、あたかも複数のレジスタがあるかのようにアルゴリズムを書けます。ここでは、量子ビット全体に量子フーリエ変換をかけたあと、その一部にだけ再度量子フーリエ変換をかけてみます。Qamomileの量子フーリエ変換qftはVector[Qubit]を引数に取るため、もしスライシング機能がなければ、量子フーリエ変換自体を量子カーネルの中にゼロから書く必要があります。スライシングを使って量子ビット配列の一部を取り出せば、この手間を回避できます。

<Figure size 774.5x496 with 1 Axes>

VectorViewのエラーパターン

VectorViewは、親となる量子ビット配列Vector[Qubit]からスライスで指定された量子ビットを借りることで作成されます。親となるVector[Qubit]から見ると、指定された量子ビットは貸し出された状態になるため、対象の量子ビットが返却されるまで、親となるVector[Qubit]から直接アクセスすることはできません。同様の理由で、親となるVector[Qubit]全体を消費するような操作も許されません。貸し出した量子ビットを返却するには、スライス代入を行う必要があります。

ここでは、貸し出した量子ビットを返さずにアクセスする例を通じてエラーパターンを見ていきます。

Error type: QubitBorrowConflictError
Error message: Parent slot 'q[1]' is currently held by a VectorView slice.
Access it through the view, or let the view finish before touching the parent directly.
Error type: UnreturnedBorrowError
Error message: Array 'q' has unreturned slice-view borrows from q[slice].
Borrowed slots: q[0] (held by slice view), q[2] (held by slice view), q[4] (held by slice view)

Fix: Return every active view via slice assignment before consuming the parent:
  view = q[a:b:c]
  # ... use view ...
  q[a:b:c] = view  # explicit return
Error type: QubitBorrowConflictError
Error message: Parent slot 'q[2]' is already owned by another slice view 'q[slice]' and cannot be re-sliced while that view is live.  Consume / release the existing view before slicing the same range again.
Error type: AffineTypeError
Error message: Slice assignment RHS view 'q[slice]' no longer owns 'q[2]'; the parent's borrow record points at an unrelated view / element.  This view was likely drained by a later overlapping slice; reconstruct the view before assigning it back.

次へ: 制御ゲート — qmc.controlによるビルトインゲートやサブカーネルの制御、concrete/symbolicの制御数の指定、合成できないパターンのカタログを扱います。