【创新应用】layered_phase_noise 分层相位噪声退相干工程验证工具包 · Pull Request !2 · 本源量子/pyqpanda-algorithm

功能简介

layered_phase_noise（包名 phase_noise_toolkit）是一个分层相位噪声退相干工程验证工具包，用于在 pyqpanda3 本地模拟器和本源量子云平台上进行相位退相干实验的工程化验证。

核心卖点：均匀 vs 高斯的判别性实验——在方差匹配条件下，均匀分布（硬边界）噪声与高斯噪声的相干性衰减在弱噪声区几乎一致（σ→0 完全同化），随噪声强度 σ 增大出现系统性分化（σ⁴ 阶峰度效应，均匀 μ₄/Σ⁴=1.8 vs 高斯 3.0），强噪声下差异可达 10 倍以上。判别性实验已前置为工具包核心入口。

核心特性

- 分层相位噪声注入：每层注入幅度按几何衰减（decay_rate^k · σ），复现多层退相干结构
- 均匀/高斯双噪声模型：支持均匀分布和高斯分布相位噪声，方差匹配对照实验
- 真机路径适配：run_prog_on_backend() 自动识别云平台真机后端，走 decompose→transpile→to_instruction→run_instruction 官方流程，含容错降级（v0.4.0 新增）
- 后端门集校验：check_gate_support() 按后端支持门集给出使用提示，避免在真机选择不支持的门（v0.4.0 新增）
- 读出校准与纠错：含读出校准矩阵，支持将有效读出错误压低到 1% 以下（含噪虚拟机验证）
- Ramsey 衰减测量：完整的 Ramsey 实验流程，自动计算相干性曲线
- 单比特与多比特并行：支持多比特同时测量，提升云平台效率
- 边界状态检查：run_and_get_probs 含 5 层边界检查，真机异常不崩溃
- 适配 pyqpanda3：本地模拟器与本源量子云平台通用接口

快速使用

from phase_noise_toolkit import LayeredPhaseInjector, RamseyDecayExperiment

injector = LayeredPhaseInjector(noise_type='uniform', sigma=0.3, decay_rate=0.99)
exp = RamseyDecayExperiment(injector, n_values=range(1, 61), repetitions=10000)
results = exp.run()

判别性实验数据（方差匹配 σ_g=σ_u/√3，decay_rate=0.99，理论相干性口径）

N=60 时均匀/高斯相干性比值 R(N)：

σ_u	0.1	0.3	0.5	1.0	2.0
R	1.000	0.999	0.992	0.874	0.078

- σ→0：均匀与高斯完全同化（R→1），二阶项相同
- σ 增大：R 单调下降，分化从 σ⁴ 阶开始（四阶矩/峰度效应）
- σ=2.0：均匀相干性约为高斯的 1/13（硬边界结构保护效应显现，数量级分化）

注：以上为理论相干性口径 I=|E[e^{iφ}]|；Ramsey 实测口径 I=E[|cosφ|] 在强噪声区系统性抬升（极限 2/π），两者在弱噪声区一致，详见 README 双口径说明。

模块结构

phase_noise_toolkit/
├── __init__.py            - 包入口与版本（v0.4.1）
├── layered_injector.py    - 分层相位噪声注入器（核心）
├── ramsey_decay.py        - Ramsey 衰减测量实验
├── readout_calibration.py - 读出校准与纠错
├── noise_utils.py         - 噪声模型适配工具
└── utils.py               - 通用工具函数（含真机路径适配与边界状态检查）
examples/demo_local_simulator.py - 本地模拟器完整示例
tests/test_phase_noise.py        - 单元测试

真机使用注意事项

在真机后端（如 WK_C180_2）上使用 RPhi 门时，原生门仅支持 θ=90°。任意角度旋转必须通过官方推荐的 decompose → transpile 标准流程分解后提交。本工具包在真机模式下会自动走 to_instruction + run_instruction 路径，并尝试进行门分解。但不同后端原生门限制可能不同，使用前请参考本源量子云官方文档，确认后端的门集和标准使用流程。本地模拟器不受此限制。

测试状态

本地模拟器验证通过：36 项测试全部通过，含边缘概率提取、多比特注入、2 比特并行 Ramsey、多比特扫描、单比特向后兼容、多比特判别性实验、真机路径分支、后端门集校验、噪声模型工厂等。

兼容性

- pyqpanda3 本地模拟器
- 本源量子云平台（含噪声虚拟机与真机）
- Python 3.7+

类型	指派人员	状态
审查	shenzhi	进行中 (0/1人)
测试	shenzhi	进行中 (0/1人)

本源量子 / pyqpanda-algorithm .gitee-modal { width: 500px !important; }

搜索帮助

本源量子 / pyqpanda-algorithm