Extends Q5 with a dissipative jump channel and EN/ZH golds so docs can show energy loss, not only Pauli flips. Co-authored-by: Cursor <cursoragent@cursor.com>
70 lines
2.3 KiB
Markdown
70 lines
2.3 KiB
Markdown
# `ext/quantum` Q5 — 最小噪声(教学用)
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | **Accepted · 最小实现已落地** |
|
||
| 日期 | 2026-08-12 |
|
||
| 父设计 | [ext-quantum.md](ext-quantum.md) |
|
||
| 路线图 | [roadmap/ext-quantum.md](../roadmap/ext-quantum.md) |
|
||
|
||
---
|
||
|
||
## 1. 目标
|
||
|
||
在 **不** 引入完整开放系统 / 云后端的前提下,让教学文档能写「带噪声的采样」,金样可复现。
|
||
|
||
**刻意不做(本 Q5 切片):** 任意 Kraus 组、振幅阻尼完整表、>12 qubits 张量网络、噪声参数学习。振幅阻尼教学轨迹见 [ext-quantum-q5.5.md](ext-quantum-q5.5.md)。
|
||
|
||
---
|
||
|
||
## 2. 作者面
|
||
|
||
电路上可选噪声字段(方法链设置,返回新句柄):
|
||
|
||
```markdown
|
||
*`qc` = > `qc`.noise kind=bitflip p=0.05 *
|
||
# 或
|
||
*`qc` = > `qc`.noise kind=depolarizing p=0.02 *
|
||
```
|
||
|
||
| 参数 | 含义 |
|
||
|------|------|
|
||
| `kind` | `bitflip` \| `depolarizing`(中文:`比特翻转` / `退极化`) |
|
||
| `p` | 每比特、每个非 `barrier`/`measure` 门后的错误概率,`0…1` |
|
||
|
||
`simulate` / `probabilities`:**忽略噪声**(仍为理想酉演化),避免概率图被蒙特卡洛抖动。
|
||
`run shots= seed=`:**启用噪声**(若 `p>0`):按轨迹采样,结果可复现。
|
||
|
||
---
|
||
|
||
## 3. 模拟语义(轨迹)
|
||
|
||
每个 shot:
|
||
|
||
1. 从 `|0…0⟩` 施电路门(跳过 `BARRIER`;`MEASURE` 不改变酉演化)。
|
||
2. 每施一个会改态的门后,对**该门涉及的每个比特**独立:
|
||
- `bitflip`:以概率 `p` 施 `X`;
|
||
- `depolarizing`:以概率 `p` 均匀随机施 `X`/`Y`/`Z` 之一。
|
||
3. 若电路含 `MEASURE` 标记:只对标记比特做计算基采样;否则测全部比特。
|
||
|
||
RNG:与现有 `run seed=` 同一 SplitMix64 流(门后噪声与最终采样共用)。
|
||
|
||
---
|
||
|
||
## 4. 与作者面补齐的关系
|
||
|
||
| API | 行为 |
|
||
|-----|------|
|
||
| `barrier` | 仅可视化;模拟跳过 |
|
||
| `measure` | 可视化测量符号;决定 `run` 读出哪些比特 |
|
||
| `append` | 追加另一 `circuit` 的 `ops`(或单门) |
|
||
| `state` | 等价于当前理想 `simulate` 结果(`quantum_state`) |
|
||
|
||
---
|
||
|
||
## 5. 验收
|
||
|
||
- 金样:理想 Bell `run` 不变;`noise kind=bitflip p=1` 在已知电路上计数偏离理想(`seed=` 固定)。
|
||
- `barrier`/`measure` 出现在 `draw kind=circuit` SVG。
|
||
- 中英 L1 对称;仍无 `host_*` 于 `ext/**`。
|