panta-sim 0.1.0__tar.gz

panta_sim-0.1.0/Cargo.lock

@@ -0,0 +1,384 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "cc"
+version = "1.2.61"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d16d90359e986641506914ba71350897565610e87ce0ad9e6f28569db3dd5c6d"
+dependencies = [
+ "find-msvc-tools",
+ "shlex",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582"
+
+[[package]]
+name = "getrandom"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "wasi",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "matrixmultiply"
+version = "0.3.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a06de3016e9fae57a36fd14dba131fccf49f74b40b7fbdb472f96e361ec71a08"
+dependencies = [
+ "autocfg",
+ "rawpointer",
+]
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "ndarray"
+version = "0.15.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb12d4e967ec485a5f71c6311fe28158e9d6f4bc4a447b474184d0f91a8fa32"
+dependencies = [
+ "matrixmultiply",
+ "num-complex",
+ "num-integer",
+ "num-traits",
+ "rawpointer",
+]
+
+[[package]]
+name = "num-complex"
+version = "0.4.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "73f88a1307638156682bada9d7604135552957b7818057dcef22705b4d509495"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-integer"
+version = "0.1.46"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7969661fd2958a5cb096e56c8e1ad0444ac2bbcd0061bd28660485a44879858f"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "numpy"
+version = "0.23.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b94caae805f998a07d33af06e6a3891e38556051b8045c615470a71590e13e78"
+dependencies = [
+ "libc",
+ "ndarray",
+ "num-complex",
+ "num-integer",
+ "num-traits",
+ "pyo3",
+ "rustc-hash",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "ppv-lite86"
+version = "0.2.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9"
+dependencies = [
+ "zerocopy",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7778bffd85cf38175ac1f545509665d0b9b92a198ca7941f131f85f7a4f9a872"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94f6cbe86ef3bf18998d9df6e0f3fc1050a8c5efa409bf712e661a4366e010fb"
+dependencies = [
+ "once_cell",
+ "python3-dll-a",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e9f1b4c431c0bb1c8fb0a338709859eed0d030ff6daa34368d3b152a63dfdd8d"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fbc2201328f63c4710f68abdf653c89d8dbc2858b88c5d88b0ff38a75288a9da"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fca6726ad0f3da9c9de093d6f116a93c1a38e417ed73bf138472cf4064f72028"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "python3-dll-a"
+version = "0.2.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d80ba7540edb18890d444c5aa8e1f1f99b1bdf26fb26ae383135325f4a36042b"
+dependencies = [
+ "cc",
+]
+
+[[package]]
+name = "qsim-core"
+version = "0.1.0"
+dependencies = [
+ "num-complex",
+]
+
+[[package]]
+name = "qsim-python"
+version = "0.1.0"
+dependencies = [
+ "num-complex",
+ "numpy",
+ "pyo3",
+ "qsim-core",
+ "qsim-simulator",
+]
+
+[[package]]
+name = "qsim-simulator"
+version = "0.1.0"
+dependencies = [
+ "qsim-core",
+ "rand",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rand"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5ca0ecfa931c29007047d1bc58e623ab12e5590e8c7cc53200d5202b69266d8a"
+dependencies = [
+ "libc",
+ "rand_chacha",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_chacha"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"
+dependencies = [
+ "ppv-lite86",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
+dependencies = [
+ "getrandom",
+]
+
+[[package]]
+name = "rawpointer"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60a357793950651c4ed0f3f52338f53b2f809f32d83a07f72909fa13e4c6c1e3"
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94300abf3f1ae2e2b8ffb7b58043de3d399c73fa6f4b73826402a5c457614dbe"
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
+
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+
+[[package]]
+name = "zerocopy"
+version = "0.8.48"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eed437bf9d6692032087e337407a86f04cd8d6a16a37199ed57949d415bd68e9"
+dependencies = [
+ "zerocopy-derive",
+]
+
+[[package]]
+name = "zerocopy-derive"
+version = "0.8.48"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "70e3cd084b1788766f53af483dd21f93881ff30d7320490ec3ef7526d203bad4"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]

panta_sim-0.1.0/Cargo.toml

@@ -0,0 +1,3 @@
+[workspace]
+members = ["crates/core", "crates/simulator", "crates/python-binding"]
+resolver = "2"

panta_sim-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 quantumfia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

panta_sim-0.1.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: panta-sim
+Version: 0.1.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Dist: numpy>=1.20
+License-File: LICENSE
+Summary: Full Rust core quantum circuit simulator with Python bindings
+Keywords: quantum,simulator,quantum-computing,rust,pyo3
+Author: quantumfia
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Issues, https://github.com/quantumfia/quantum-sim/issues
+Project-URL: Repository, https://github.com/quantumfia/quantum-sim
+
+# panta-sim
+
+풀 Rust 코어 + Python 바인딩으로 작성한 양자 회로 시뮬레이터.
+Full state vector 방식으로 20~25큐비트 회로를 정확히 시뮬레이션 한다.
+
+- **Rust 코어**: `num-complex` 기반 상태 벡터, qubit-wise multiplication
+- **Python API**: PyO3 + maturin, NumPy 연동
+- **검증**: 100+ pytest + Qiskit statevector 교차검증 (오차 < 1e-10)
+
+## 설치
+
+```bash
+pip install panta-sim
+```
+
+> 위 명령은 PyPI 에 wheel 이 등록된 이후 동작합니다.
+> 아직 publish 전이라면 소스에서 빌드하세요:
+>
+> ```bash
+> # 사전 요구 사항: Rust toolchain (rustup), Python >= 3.9, maturin
+> pip install maturin
+> git clone https://github.com/quantumfia/quantum-sim
+> cd quantum-sim
+> maturin develop --release   # 또는 pip install .
+> ```
+
+## 빠른 시작
+
+```python
+from panta_sim import QuantumCircuit
+
+# Bell state |Φ+⟩ = (|00⟩ + |11⟩)/√2
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure_all()
+
+result = qc.run(shots=1024, seed=42)
+print(result.counts())          # {'00': ~512, '11': ~512}
+print(result.statevector())     # [0.707+0j, 0+0j, 0+0j, 0.707+0j]
+print(result.probabilities())   # [0.5, 0, 0, 0.5]
+```
+
+`QuantumCircuit` 의 게이트 메서드는 모두 self 를 반환하므로 메서드 체이닝도 가능하다:
+
+```python
+counts = (
+    QuantumCircuit(3)
+    .h(0)
+    .cx(0, 1)
+    .cx(0, 2)
+    .measure_all()
+    .run(shots=1024, seed=0)
+    .counts()
+)
+```
+
+> `pip install panta-sim` (배포 이름) → `import panta_sim` (Python 모듈 이름).
+
+## 지원 게이트
+
+| 분류 | 게이트 | 메서드 |
+| --- | --- | --- |
+| 단일 큐비트 | Hadamard | `h(q)` |
+| 단일 큐비트 | Pauli-X / Y / Z | `x(q)`, `y(q)`, `z(q)` |
+| 단일 큐비트 | Phase / T | `s(q)`, `t(q)` |
+| 단일 큐비트 | Identity | `id(q)` |
+| 회전 | Rx / Ry / Rz | `rx(theta, q)`, `ry(theta, q)`, `rz(theta, q)` |
+| 2큐비트 | CNOT / CZ / SWAP | `cx(c, t)`, `cz(a, b)`, `swap(a, b)` |
+| 3큐비트 | Toffoli (CCX) | `ccx(c1, c2, t)` |
+| 3큐비트 | Fredkin (CSWAP) | `cswap(c, t1, t2)` |
+| 측정 | 부분 / 전체 측정 | `measure(q, c)`, `measure_all()` |
+
+비트 순서 규약은 Qiskit 과 동일한 little-endian 이다 (`q_{n-1} … q_1 q_0`).
+`counts()` 의 키는 MSB-first 비트 문자열, statevector 의 인덱스는 동일한 비트열을 정수로 해석한 값이다.
+
+## 빌드 / 테스트
+
+```bash
+cargo build --release          # Rust 전체 빌드
+cargo test                     # Rust 유닛 테스트 (core + simulator)
+maturin develop --release      # Python 바인딩 빌드 (개발 모드)
+pytest tests/                  # Python 통합 테스트 + Qiskit 교차검증
+pytest tests/ -v               # 상세 출력
+```
+
+Qiskit 교차검증 테스트는 `qiskit` 패키지가 설치되어 있을 때만 실행되며,
+설치되어 있지 않으면 자동으로 skip 된다.
+
+## 예제
+
+`examples/` 디렉터리 참고:
+
+- `bell_state.py` — Bell 상태 생성 및 측정
+- `grover.py` — 2큐비트 Grover 탐색
+- `qft.py` — Quantum Fourier Transform
+
+```bash
+python examples/bell_state.py
+python examples/grover.py
+python examples/qft.py
+```
+
+## 프로젝트 구조
+
+```
+quantum-sim/
+├── crates/
+│   ├── core/              상태 벡터, 게이트 행렬, 복소수 연산
+│   ├── simulator/         시뮬레이션 엔진, 측정, 회로 실행기
+│   └── python-binding/    PyO3 바인딩
+├── python/panta_sim/      사용자용 Python 라이브러리
+├── tests/                 pytest 통합 테스트
+├── examples/              사용 예제
+└── docs/                  설계 문서 (plan.md, architecture.md, references.md)
+```
+
+## 5월 스코프 밖 (현재 미구현)
+
+트랜스파일러, 노이즈 모델, OpenQASM 파싱, GPU/멀티스레딩 가속,
+회로 시각화, tensor network/MPS, 실제 QPU 연동.
+
+## 참고 자료
+
+- 설계 문서: [`docs/architecture.md`](docs/architecture.md)
+- 개발 계획(WBS): [`docs/plan.md`](docs/plan.md)
+- 참고 논문: [`docs/references.md`](docs/references.md)
+

panta_sim-0.1.0/README.md

@@ -0,0 +1,127 @@
+# panta-sim
+
+풀 Rust 코어 + Python 바인딩으로 작성한 양자 회로 시뮬레이터.
+Full state vector 방식으로 20~25큐비트 회로를 정확히 시뮬레이션 한다.
+
+- **Rust 코어**: `num-complex` 기반 상태 벡터, qubit-wise multiplication
+- **Python API**: PyO3 + maturin, NumPy 연동
+- **검증**: 100+ pytest + Qiskit statevector 교차검증 (오차 < 1e-10)
+
+## 설치
+
+```bash
+pip install panta-sim
+```
+
+> 위 명령은 PyPI 에 wheel 이 등록된 이후 동작합니다.
+> 아직 publish 전이라면 소스에서 빌드하세요:
+>
+> ```bash
+> # 사전 요구 사항: Rust toolchain (rustup), Python >= 3.9, maturin
+> pip install maturin
+> git clone https://github.com/quantumfia/quantum-sim
+> cd quantum-sim
+> maturin develop --release   # 또는 pip install .
+> ```
+
+## 빠른 시작
+
+```python
+from panta_sim import QuantumCircuit
+
+# Bell state |Φ+⟩ = (|00⟩ + |11⟩)/√2
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure_all()
+
+result = qc.run(shots=1024, seed=42)
+print(result.counts())          # {'00': ~512, '11': ~512}
+print(result.statevector())     # [0.707+0j, 0+0j, 0+0j, 0.707+0j]
+print(result.probabilities())   # [0.5, 0, 0, 0.5]
+```
+
+`QuantumCircuit` 의 게이트 메서드는 모두 self 를 반환하므로 메서드 체이닝도 가능하다:
+
+```python
+counts = (
+    QuantumCircuit(3)
+    .h(0)
+    .cx(0, 1)
+    .cx(0, 2)
+    .measure_all()
+    .run(shots=1024, seed=0)
+    .counts()
+)
+```
+
+> `pip install panta-sim` (배포 이름) → `import panta_sim` (Python 모듈 이름).
+
+## 지원 게이트
+
+| 분류 | 게이트 | 메서드 |
+| --- | --- | --- |
+| 단일 큐비트 | Hadamard | `h(q)` |
+| 단일 큐비트 | Pauli-X / Y / Z | `x(q)`, `y(q)`, `z(q)` |
+| 단일 큐비트 | Phase / T | `s(q)`, `t(q)` |
+| 단일 큐비트 | Identity | `id(q)` |
+| 회전 | Rx / Ry / Rz | `rx(theta, q)`, `ry(theta, q)`, `rz(theta, q)` |
+| 2큐비트 | CNOT / CZ / SWAP | `cx(c, t)`, `cz(a, b)`, `swap(a, b)` |
+| 3큐비트 | Toffoli (CCX) | `ccx(c1, c2, t)` |
+| 3큐비트 | Fredkin (CSWAP) | `cswap(c, t1, t2)` |
+| 측정 | 부분 / 전체 측정 | `measure(q, c)`, `measure_all()` |
+
+비트 순서 규약은 Qiskit 과 동일한 little-endian 이다 (`q_{n-1} … q_1 q_0`).
+`counts()` 의 키는 MSB-first 비트 문자열, statevector 의 인덱스는 동일한 비트열을 정수로 해석한 값이다.
+
+## 빌드 / 테스트
+
+```bash
+cargo build --release          # Rust 전체 빌드
+cargo test                     # Rust 유닛 테스트 (core + simulator)
+maturin develop --release      # Python 바인딩 빌드 (개발 모드)
+pytest tests/                  # Python 통합 테스트 + Qiskit 교차검증
+pytest tests/ -v               # 상세 출력
+```
+
+Qiskit 교차검증 테스트는 `qiskit` 패키지가 설치되어 있을 때만 실행되며,
+설치되어 있지 않으면 자동으로 skip 된다.
+
+## 예제
+
+`examples/` 디렉터리 참고:
+
+- `bell_state.py` — Bell 상태 생성 및 측정
+- `grover.py` — 2큐비트 Grover 탐색
+- `qft.py` — Quantum Fourier Transform
+
+```bash
+python examples/bell_state.py
+python examples/grover.py
+python examples/qft.py
+```
+
+## 프로젝트 구조
+
+```
+quantum-sim/
+├── crates/
+│   ├── core/              상태 벡터, 게이트 행렬, 복소수 연산
+│   ├── simulator/         시뮬레이션 엔진, 측정, 회로 실행기
+│   └── python-binding/    PyO3 바인딩
+├── python/panta_sim/      사용자용 Python 라이브러리
+├── tests/                 pytest 통합 테스트
+├── examples/              사용 예제
+└── docs/                  설계 문서 (plan.md, architecture.md, references.md)
+```
+
+## 5월 스코프 밖 (현재 미구현)
+
+트랜스파일러, 노이즈 모델, OpenQASM 파싱, GPU/멀티스레딩 가속,
+회로 시각화, tensor network/MPS, 실제 QPU 연동.
+
+## 참고 자료
+
+- 설계 문서: [`docs/architecture.md`](docs/architecture.md)
+- 개발 계획(WBS): [`docs/plan.md`](docs/plan.md)
+- 참고 논문: [`docs/references.md`](docs/references.md)

panta_sim-0.1.0/crates/core/Cargo.toml

@@ -0,0 +1,7 @@
+[package]
+name = "qsim-core"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+num-complex = "0.4"