rasidi3112/quantum-computing-simulation
rasidi3112/quantum-computing-simulation has 86 GitHub stars and 7 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 17:44 UTC. Last push 2026-11-11.
できること
- Lab - 1–6 qubits; gates I, X, Y, Z, H, S, T on any qubit; CNOT between any two qubits; live circuit diagram, state table and gate history
- State visualisation - Probability distribution, real/imaginary amplitudes and the phase of every amplitude, with basis-state labels
- Bloch sphere - Interactive 3D sphere per qubit, drawn from the qubit's reduced state, with vector length and purity so pure and mixed states are told apart
- Measurement - Shot sampling (100–10 000 shots) with a seed, and projective measurement of one or all qubits with state collapse
計測したスター増加
- 24時間
- 0
- 7日間
- 更新が遅れています
- 15日間
- 更新が遅れています
- 1か月
- 更新が遅れています
期間ごとの純増数です。期間は重複しており、日別の値ではありません。未計測の値は空欄です。スター数は注目度の指標であり、品質の保証ではありません。
概要
Interactive, tested quantum-computing simulator for learning. Build circuits, watch state vectors and Bloch spheres, measure with collapse, add noise, and run teleportation, Grover and Deutsch-Jozsa. Python, NumPy, Streamlit, Plotly. 15 UI languages.
学習README_ja.md
オリジナルMini Quantum Lab 2.0
学習のための、テスト済みのインタラクティブな量子コンピューティングシミュレーター
Python · NumPy · Streamlit · Plotly · 15 のインターフェース言語
English · العربية · Deutsch · Español · Français · हिन्दी · Bahasa Indonesia · Italiano · 日本語 · 한국어 · Bahasa Melayu · Polski · Português · Русский · Türkçe · Tiếng Việt · 中文
概要
Mini Quantum Lab は、量子コンピューティングの基礎を学ぶための教育用ウェブアプリです。ゲートを一つずつ置いて小さな回路を組み、状態ベクトルを観察し、各量子ビットをブロッホ球で確認し、測定し、ノイズを加え、教科書的なプロトコルやアルゴリズムをいくつか実行できます。
バージョン 2.0 は元のプロジェクトの見た目と操作の流れを保ちつつ、内部を置き換えました。単体テスト付きの独立したシミュレーションパッケージ、文書化された一貫した量子ビット順序の規約、物理的に整合した測定、新しい可視化です。変更のきっかけとなった監査は docs/AUDIT.md にあります。
本プロジェクトは IBM Quantum Composer や Qiskit などのツールの視覚的なスタイルに着想を得ています。独立した教育プロジェクトであり、IBM その他の量子コンピューティング関連組織とは提携しておらず、その承認も受けていません。古典コンピューター上で理想的な量子ビットとノイズのある量子ビットをシミュレートするもので、量子ハードウェアには接続しません。
機能
| 領域 | できること |
|---|---|
| ラボ | 1〜6 量子ビット。任意の量子ビットに I、X、Y、Z、H、S、T ゲート。任意の 2 量子ビット間の CNOT。リアルタイムの回路図、状態表、ゲート履歴 |
| 状態の可視化 | 確率分布、振幅の実部と虚部、各振幅の位相を、基底状態のラベル付きで表示 |
| ブロッホ球 | 量子ビットごとのインタラクティブな 3D 球。その量子ビットの縮約状態から描画し、ベクトルの長さと純粋度を示すので、純粋状態と混合状態を区別できます |
| 測定 | シード付きのショットサンプリング(100〜10 000 ショット)と、1 つまたはすべての量子ビットの射影測定(状態の収縮を伴う) |
| 量子もつれ | 4 つのベル状態のジェネレーター(エントロピーと収縮のデモ付き)。任意の 1 量子ビット状態の 3 量子ビット量子テレポーテーション |
| ノイズ | 各ゲートの後に適用するビット反転、位相反転、脱分極チャネル。密度行列で厳密にシミュレート |
| アルゴリズム | グローバー探索(2〜5 量子ビット)とドイッチュ–ジョサ(入力 1〜4 量子ビット)。解説と回路付き |
| 言語 | English, Indonesian, Spanish, Mandarin Chinese, Arabic, French, Japanese, Korean, German, Portuguese, Russian, Hindi, Turkish, Italian, Vietnamese |
スクリーンショット
| ラボ:回路、確率、振幅 | ブロッホ球(Q0 と Q1 はもつれ、Q2 は純粋状態) |
|---|---|
![]() |
![]() |
| ショットサンプリングと射影測定 | 量子テレポーテーション |
|---|---|
![]() |
![]() |
| ノイズ:理想的なベル状態と脱分極後のベル状態 | グローバーとドイッチュ–ジョサ |
|---|---|
![]() |
![]() |
インストール
Python 3.11 以降が必要です(3.11 と 3.13 でテスト済み)。
git clone https://github.com/rasidi3112/quantum-computing-simulation.git
cd quantum-computing-simulation
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
streamlit run main.py
その後、次を開きます: http://localhost:8501.
実行時の依存パッケージは numpy、streamlit、plotly です。シミュレーションパッケージ本体(visualization を除く quantum_lab)は NumPy だけで動作します。
使い方
- サイドバーで量子ビット数を選びます(変更すると新しい空の回路が始まります)。
- ゲートとターゲット量子ビットを選んで Apply Gate を押します。2 量子ビット以上の場合は、制御とターゲットを選んで Apply CNOT を押します。
- 結果は各タブで確認します:
- Lab: 回路図、確率、振幅、位相、状態表
- Bloch Sphere: 量子ビットごとに 1 つの球
- Measurement: Run Measurement は状態を変えずにショットをサンプリングし、Measure Qubit / Measure All Qubits は状態を収縮させます
- Entanglement, Noise, Algorithms: 独立したデモです。Load into Lab はベル回路をラボにコピーします。
- Reset System は |0…0⟩ に戻し、乱数生成器をシードから再スタートします。
グラフはインタラクティブです(ホバー、ズーム、回転)。グラフのツールバーにあるカメラボタンで PNG を保存でき、Save … ボタンは単体で動くインタラクティブな HTML ファイルをダウンロードします。
回路の例
| 目的 | 手順 | 期待される結果 |
|---|---|---|
| 重ね合わせ | 1 qubit: H → Q0 | P(0) = P(1) = 0.5; ブロッホベクトルは +x 方向 |
| ベル状態 |Φ+⟩ | 2 qubits: H → Q0, CNOT Q0 → Q1 | (|00⟩ + |11⟩)/√2; P(00) = P(11) = 0.5, P(01) = P(10) = 0; 両方のブロッホベクトルの長さは 0 |
| H·Z·H = X | 1 qubit: H, Z, H → Q0 | |1⟩ |
| GHZ 状態 | 3 qubits: H → Q0, CNOT Q0 → Q1, CNOT Q1 → Q2 | (|000⟩ + |111⟩)/√2 |
| 収縮 | ベル状態を作り、Q0 に Measure Qubit | |00⟩ / |11⟩; Q1 も確定します |
q0: ──[H]──●──
│
q1: ───────⊕──
Python からシミュレーターを使う
import numpy as np
from quantum_lab import Circuit, QuantumSimulator, gates
sim = QuantumSimulator(2)
sim.apply(gates.HADAMARD, [0])
sim.cnot(0, 1)
print(np.round(sim.state, 4)) # [0.7071 0 0 0.7071]
print(sim.sample_counts(1000, rng=42)) # [487 0 0 513] = counts of 00, 01, 10, 11
print(sim.measure_qubit(0, rng=7), sim.state) # 0 [1 0 0 0]: collapsed to |00>
circuit = Circuit(2).gate("H", 0).cnot(0, 1).measure(0).measure(1)
print(circuit.draw())
print(circuit.run(rng=1).outcomes) # {0: 0, 1: 0}; the two bits always agree
量子数学の規約
状態。 n 量子ビットのレジスタは、Σ|αᵢ|² = 1 を満たす 2ⁿ 個の振幅 αᵢ からなる複素ベクトルで、|0…0⟩ に初期化されます。
量子ビットの順序:ビッグエンディアン(全体で統一)。 量子ビット 0 は基底ラベルの最も左のビットであり、回路図の一番上の線です:
|q0 q1 … q(n-1)⟩ index = Σ_k q_k · 2^(n-1-k) |ψ⟩ = |q0⟩ ⊗ |q1⟩ ⊗ … ⊗ |q(n-1)⟩
したがって 2 量子ビットでは、Q0 への X は |00⟩ を |10⟩(インデックス 2)に変えます。量子ビットのリスト [a, b] に作用する行列は a を最上位ビットとして扱います。特に gates.CNOT は [control, target] に対する行列です。これは教科書(Nielsen & Chuang)の規約です。Qiskit は逆のリトルエンディアン順を使うので、比較するときはビット列を反転してください。
時間発展。 すべての演算子は適用前にユニタリ性(U†U = I、許容誤差 10⁻¹⁰)を検査し、ユニタリ発展の途中で状態を再規格化することはありません。テストでは、3000 ゲート後もノルムと 1 との差が 10⁻¹⁰ 以内であることを確認しています。
測定(計算基底):
- ショットサンプリングは P(i) = |αᵢ|² から結果を抽出します。ショットごとに同じ状態を準備し直すことをモデル化しており、状態は変化しません。
- 量子ビット k の射影測定は P(m) = Σ_{i: bit k = m} |αᵢ|² で m ∈ {0, 1} を抽出し、状態を P_m|ψ⟩ / √P(m) に置き換えます。すべての量子ビットを測定すると基底状態が残ります。
- *乱数。*整数のシードを指定すると結果を再現できます(
numpy.random.default_rng)。アプリでは、ショットサンプリングはシードを直接使い(同じシードと状態 → 同じヒストグラム)、射影測定は 1 つの生成器を使い続けます。この生成器はリセット時、シード変更時、レジスタサイズ変更時に再スタートします。
ブロッホベクトル。 量子ビット k について、縮約密度行列 ρ_k = Tr_{others} |ψ⟩⟨ψ| から r = (Tr ρ_kX, Tr ρ_kY, Tr ρ_kZ) が得られ、ρ_k = (I + r·σ)/2 です。純粋な量子ビットでは |r| = 1、他の量子ビットともつれている場合やノイズを受けた場合は |r| < 1 となり、純粋度は Tr ρ_k² = (1 + |r|²)/2 です。もつれたレジスタ全体には単一のブロッホベクトルがないため、描画しません。
ノイズ。 各ゲートの後、選択したチャネルがそのゲートの作用した各量子ビットに作用します(1 回の適用あたりのエラー確率 p):
| チャネル | 写像 |
|---|---|
| ビット反転 | ρ → (1 − p)ρ + p XρX |
| 位相反転 | ρ → (1 − p)ρ + p ZρZ |
| 脱分極 | ρ → (1 − p)ρ + (p/3)(XρX + YρY + ZρZ) |
このパラメーター化では、脱分極チャネルはブロッホベクトルを 1 − 4p/3 倍に縮めます(p = 3/4 で最大混合状態)。待機中の量子ビットと測定にはノイズがありません。密度行列は厳密に発展させ、ノイズのある回路内の測定は結果について平均します。
忠実度。 純粋状態の基準に対しては ⟨ψ|ρ|ψ⟩、一般にはウールマン忠実度 (Tr √(√ρ σ √ρ))²。
対応している量子ゲート
| ゲート | 行列 | 作用 |
|---|---|---|
| Identity (I) | [[1, 0], [0, 1]] | 量子ビットを変化させない |
| Pauli-X | [[0, 1], [1, 0]] | ビット反転 |0⟩ ↔ |1⟩ |
| Pauli-Y | [[0, −i], [i, 0]] | Y|0⟩ = i|1⟩, Y|1⟩ = −i|0⟩ |
| Pauli-Z | [[1, 0], [0, −1]] | 位相反転 |1⟩ → −|1⟩ |
| Hadamard (H) | [[1, 1], [1, −1]]/√2 | |0⟩ → |+⟩, |1⟩ → |−⟩ |
| S | diag(1, i) | 位相 π/2 |
| T | diag(1, e^{iπ/4}) | 位相 π/4 |
| CNOT | |0⟩⟨0| ⊗ I + |1⟩⟨1| ⊗ X | 制御が |
Python API ではさらに rx、ry、rz、phase、任意の量子ビットリストに対する任意のユニタリ、多重制御の 1 量子ビットゲートを利用できます。これらはテレポーテーションとグローバーの回路で使われていますが、サイドバーにはまだありません。
アルゴリズムとプロトコル
- ベル状態。 X ゲートで入力を選び、続いて H と CNOT を適用します。
- テレポーテーション。 Q0 は cos(θ/2)|0⟩ + e^{iφ}sin(θ/2)|1⟩ を持ち、Q1–Q2 はベル対を共有します。アリスは CNOT と H を適用して Q0、Q1 を測定し、ボブは m₁ = 1 なら X、m₀ = 1 なら Z を適用します。表示される忠実度はシミュレートした状態から計算したもので、4 つの分岐すべてで 1 です。
- Grover. オラクル = 印を付けた要素の 0 のビットに X、多重制御 Z、再び X。拡散 = Hⁿ Xⁿ (MCZ) Xⁿ Hⁿ。シミュレートした成功確率は sin²((2k+1)θ)、sin θ = 1/√N と一致します。
- Deutsch–Jozsa. オラクル U_f|x⟩|y⟩ = |x⟩|y ⊕ f(x)⟩ は f の真理値表から構成します。アプリでは定数関数、選択したビットのパリティ、ランダムな均等関数を選べます。
アーキテクチャ
quantum-computing-simulation/
├── main.py Streamlit interface (widgets, session state, layout)
├── translations.py original 54 keys × 15 languages + lookup helpers
├── translations_extra.py 80 keys added in 2.0 × 15 languages
├── quantum_lab/ simulation core, no Streamlit imports
│ ├── gates.py gate matrices, unitarity check, dense reference expansions
│ ├── simulator.py QuantumSimulator (state vector)
│ ├── measurement.py probabilities, shot sampling, projective collapse
│ ├── states.py reduced density matrices, Bloch vectors, entropy
│ ├── circuit.py Circuit / Operation, execution, text diagram
│ ├── density.py DensityMatrix (mixed states)
│ ├── noise.py Kraus channels, noisy circuit simulation
│ ├── protocols.py Bell, GHZ, teleportation
│ ├── algorithms.py Grover, Deutsch–Jozsa
│ └── visualization.py Plotly figures
├── tests/ pytest suite (500 tests)
├── benchmarks/bench_gates.py
├── docs/AUDIT.md audit of version 1.0
├── assets/ screenshots
├── requirements.txt runtime dependencies
└── requirements-dev.txt + pytest, ruff
依存関係は一方向です:main.py → quantum_lab と translations。パッケージ内で Plotly をインポートするのは visualization だけで、Streamlit をインポートするモジュールはないため、コアは単体で利用およびテストできます。
テスト
pip install -r requirements-dev.txt
pytest
pytest --ignore=tests/test_app.py
ruff check .
python benchmarks/bench_gates.py
pytest は約 1.5 分かかります(大半はブラウザなしの UI テスト)。--ignore=tests/test_app.py を付けるとコアだけを数秒でテストします。
| ファイル | 対象 |
|---|---|
test_gates.py |
各ゲートのユニタリ性、代数的恒等式、クロネッカー展開、CNOT 行列 |
test_simulator.py |
規格化、パウリ/アダマールの振る舞い、H を 2 回、CNOT の真理値表、ベル状態と GHZ 状態、密行列との比較、不正な入力 |
test_measurement.py |
ボルンの規則、周辺分布、シード付きサンプリング、統計、収縮と再規格化 |
test_states.py |
部分トレース、ブロッホベクトル、純粋度、エンタングルメントエントロピー |
test_circuit.py |
回路の構築と実行、条件付きゲート、回路図のレイアウト |
test_noise.py |
チャネルのトレース保存性、解析的な結果、エラー軌道についての全数和 |
test_protocols.py |
4 つのベル状態、4 つの分岐すべてでのテレポーテーション |
test_algorithms.py |
グローバーと閉形式の比較、2 入力および 3 入力のすべての均等関数に対するドイッチュ–ジョサ |
test_visualization.py |
図が正しいデータを含むこと |
test_translations.py |
15 言語、キーとプレースホルダーの一致、UI が使うすべてのキーの存在 |
test_app.py |
Streamlit アプリのエンドツーエンド(ヘッドレス)、全言語 |
数値の比較には、厳密な浮動小数点の等値ではなく許容誤差を使います(振幅は 10⁻¹²、サンプリング統計は 5σ の範囲)。
検証済みの組み合わせ: Python 3.11 + NumPy 1.26.4 / Streamlit 1.50.0 / Plotly 5.24.0; Python 3.13 + NumPy 2.5.4 / Streamlit 1.67.0 / Plotly 7.1.0.
性能と上限
| 項目 | 状態ベクトル | 密度行列 |
|---|---|---|
| メモリ | 16 · 2ⁿ bytes | 16 · 4ⁿ bytes |
| k 量子ビットゲート 1 つ | O(2ⁿ · 2ᵏ) | O(4ⁿ · 2ᵏ) |
| コード上の上限 | MAX_QUBITS = 20 (16 MiB) |
MAX_DENSITY_QUBITS = 10 (16 MiB) |
| インターフェース上の上限 | 6 qubits | 6 qubits |
バージョン 1.0 はゲートごとに 2ⁿ × 2ⁿ の密行列を作っていましたが、2.0 はゲートを状態テンソルと縮約します。benchmarks/bench_gates.py による計測です(アダマール 1 つ、複数回実行の最良値、1 台のマシン。目安としてご覧ください):
| Qubits | 密行列 (1.0) | 縮約 (2.0) | 比 |
|---|---|---|---|
| 3 | 35 µs | 40 µs | 0.9× |
| 6 | 100 µs | 43 µs | 2× |
| 8 | 553 µs | 44 µs | 13× |
| 10 | 7.6 ms | 49 µs | 155× |
| 12 | 184 ms | 57 µs | ≈ 3200× |
以前の上限である 3 量子ビットでは高速化はありません(入力検証に数マイクロ秒かかります)。利点は、より大きなレジスタが実用的になったことです。シミュレーションのコストは量子ビットが 1 つ増えるごとに 2 倍になる点は変わりません。これは小さなレジスタ向けの教材であり、汎用シミュレーターではありません。
既知の制限
- インターフェースで扱えるのは 1〜6 量子ビットで、サイドバーのゲートは I、X、Y、Z、H、S、T と CNOT です。回転ゲートは Python API にしかありません。
- 測定は計算基底(Z)のみです。
- ノイズはゲート後の 1 量子ビットパウリノイズです。振幅減衰、読み出しエラー、待機中のノイズ、相関のあるノイズはありません。
- グローバーは印を付けた要素 1 つを探します。ドイッチュ–ジョサのオラクルは基本ゲートに分解せず、1 つのユニタリのボックスとして適用します。
- 回路は追加のみです(元に戻す、編集、ドラッグ&ドロップはありません)。
- 回路図は等幅テキストで、非常に長い回路は横にスクロールします。
- アラビア語は翻訳済みですが、ページのレイアウトは右から左へ反転しません。
- 2.0 で追加した 80 個の文字列はネイティブ話者の確認なしで翻訳しています。修正を歓迎します。
- 実際の量子ハードウェアやクラウドのバックエンドには接続しません。
1.0 からの変更点(影響がありうるもの)
- CNOT の結果が変わりました。以前の結果が誤っていたためです。 1.0 は 2 種類の量子ビット順序を混在させており、1 量子ビットゲートと CNOT を組み合わせた回路が誤った状態を返していました(
docs/AUDIT.mdの指摘 Q1 を参照)。 QuantumSimulatorはmain.pyからquantum_labに移りました。1.0 のメソッド(apply_gate、get_probabilities、get_amplitudes、measure、reset、_expand_gate、_create_cnot_matrix)は残しています。不正な入力は黙って受け入れられる代わりにValueError/TypeErrorを送出し、stateは読み取り専用になり、非ユニタリ行列は拒否されます。- 測定のヒストグラムは操作のたびに再生成されるのではなく、Run Measurement を押した後に表示されます。
- グラフは Matplotlib ではなく Plotly です。Save … ボタンはインタラクティブな HTML をダウンロードするようになり、PNG の書き出しは各グラフのツールバーにあります。
matplotlibと未使用のqiskitをrequirements.txtから削除し、plotlyを追加しました。
Streamlit Community Cloud へのデプロイ
- リポジトリ(または自分のフォーク)を GitHub にプッシュします。
- https://share.streamlit.io に GitHub でサインインし、新しいアプリを作成します。
- リポジトリとブランチを選び、main file path を
main.pyに設定します。 - advanced settings で Python 3.11 以降を選び、デプロイします。
依存パッケージは requirements.txt からインストールされ、シークレットや環境変数は不要です。この手順はプラットフォームの利用経験に基づいて書いたもので、このリリースの準備時点では最新のドキュメントと照合できていません。画面が異なる場合は次を参照してください: https://docs.streamlit.io/deploy/streamlit-community-cloud.
.devcontainer の設定は CORS と XSRF の保護を無効にして Streamlit を起動します。これは GitHub Codespaces のポート転送に必要なものです。公開デプロイではこれらのフラグを使わないでください。
ロードマップ
- サイドバーへの回転ゲート(Rx、Ry、Rz)と 2 量子ビットゲート(CZ、SWAP)の追加
- 元に戻す機能と回路の編集、回路の保存と読み込み
- 他の基底での測定、パウリ観測量の期待値
- 振幅減衰チャネルと読み出しエラーチャネル
- 回路の OpenQASM への書き出し
- ネイティブ話者による翻訳の確認、右から左へのレイアウト
ライセンスと帰属
MIT ライセンス で公開しています。Copyright (c) 2025 rasidi3112。ライセンスファイルは変更していません。
Mini Quantum Lab は Rasidi が作成し、元のアプリケーション、インターフェース、翻訳を書きました。バージョン 2.0(シミュレーションコア、テスト、可視化、追加機能)はその成果の上に構築されています。





