量子网络模拟器SimQN完全解析:为什么QKD与纠缠路由研究者都该试试这款Python利器
量子网络模拟器SimQN完全解析:为什么QKD与纠缠路由研究者都该试试这款Python利器
SimQN 是一款开源的量子网络模拟器(Quantum Network Simulator),基于 Python3 和离散事件驱动架构设计,专门面向量子密钥分发(QKD)、纠缠分发与量子路由算法研究。它被定位为"量子网络领域的 NS-3"——提供拓扑生成、路由表构建、协议栈和监控工具,让你把精力放在算法创新本身,而不是仿真框架上。目前已有 21 篇同行评审学术论文采用 SimQN 完成仿真实验,累计被引 70 次,是量子网络研究中最值得关注的仿真利器之一。
SimQN 是什么?离散事件驱动的量子网络仿真平台
如果把经典网络仿真比作在沙盘中推演车流,SimQN 做的就是同样的事——只不过沙盘里跑的是量子比特和纠缠对。
它的核心是一套离散事件仿真内核:网络中每一次信道传输、内存存储、协议交互都被建模为事件,由事件调度器按时间顺序推进(见 qns/simulator/simulator.py 中的 Simulator 类)。这意味着你不需要关心"谁先收到消息"这类并发细节,只需声明拓扑、挂载协议、调用 s.run() 即可。
与传统量子物理仿真器不同,SimQN 不做架构假设:QKD 网络、纠缠分发网络、混合架构都可以建模,天然适配"量子互联网标准尚未统一"的研究现状。
为什么 QKD 与纠缠路由研究者都该试试 SimQN
对比其他量子网络仿真工具,SimQN 的优势集中在"网络视角":
- 🧩 模块化设计:可复用的节点、信道、内存、协议组件,换协议不用重写框架
- 🚀 高性能内核:关键调度代码经 Cython 编译,v0.2.3 还引入了基于堆的
StableEventPool(qns/simulator/stablepool.py)和哈希桶调度器(qns/simulator/hashbucketpool.py) - 📊 双物理模型:既支持量子比特态模型(含量子门、退相干、噪声),也支持更轻量的保真度(fidelity)模型,大规模网络仿真开销显著更低
- 🌐 内置协议栈:BB84 协议(含 CASCADE 纠错与隐私放大)、纠缠分发、经典包转发开箱即用
- 🔌 生态扩展:已有 7 个仿真平台/系统扩展构建在 SimQN 之上,包括 Docker 化的 QKD 仿真环境、与 5G OAI 协议栈集成的 Q-RAN 等
一分钟看懂 SimQN 的分层架构
如上图所示,SimQN 分为五层,自上而下各司其职:
| 层 | 职责 | 主要源码位置 |
|---|---|---|
| Network | 拓扑、路由、会话请求管理 | qns/network/ |
| Apps | 挂载在节点上的协议应用 | qns/network/protocol/ |
| Entities | 节点、量子/经典信道、量子内存 | qns/entity/ |
| Simulator | 离散事件调度内核 | qns/simulator/ |
| Backends | 量子比特与纠缠物理模型 | qns/models/ |
这种分层意味着你可以只替换某一层:例如换个路由算法,或把物理后端从保真度模型换成完整的量子比特态模型,其余代码保持不动。
快速安装:三步搭建量子网络仿真环境
✅ 第一步:安装
一条 pip 命令搞定(PyPI 包名为 qns):
pip3 install -U qns
✅ 第二步:定义网络——用拓扑生成器 + 节点 + 应用组装网络
✅ 第三步:运行仿真——调用 net.install(s) 后执行 s.run()
完整可运行的最小示例见 examples/classic_communication.py 和 examples/simple_bb84.py,每个文件都配有清晰的场景注释,建议直接打开阅读。
内置量子网络拓扑生成器:从随机图到真实互联网拓扑
仿真第一步永远是建拓扑。SimQN 在 qns/network/topology/ 中提供了一整组生成器,覆盖研究中最常见的网络模型:
- 基础结构:线性
LineTopology、树形TreeTopology、网格GridTopology - 随机模型:随机图
RandomTopology、Waxman 模型WaxmanTopology、ER 模型ErdosRenyiTopology - 无标度模型:BA 模型
BarabasiAlbertTopology与双 BA 模型DualBarabasiAlbertTopology - 真实拓扑:
AboveNetTopology、AGISTopology,以及可直接解析 Internet Topology Zoo 导出的 GML 文件的GMLTopology(仓库自带示例文件 AboveNet.gml)
配合 qns/network/route/dijkstra.py 中基于二叉堆优化的 Dijkstra 路由算法,构建路由表只需 net.build_route() 一行调用。
协议仿真实战:BB84 与纠缠分发怎么用
SimQN 将协议实现为"应用"(App),直接挂载到节点上即可运行:
- BB84 密钥分发:
BB84SendApp/BB84RecvApp分别挂在收发节点上,自动完成基矢协商、纠错与隐私放大。examples/simple_bb84.py 演示了不同链路长度下的成码率变化,examples/trusted_relay_bb84.py 则展示了可信中继组网 - 逐跳纠缠分发:
EntanglementDistributionApp让每个节点参与逐跳纠缠生成,examples/entanglement_distribution_line_topo.py 演示了 150 节点、450 条量子链路上的大规模分发 - 纠缠交换与高级协议:examples/entanglement_swapping.py 用几行代码展示了 H 门、CNOT 门实现的两对纠缠合并,examples/DEJMPS.py 实现了著名的 DEJMPS 纠缠纯化协议
- 自定义应用:继承 App 基类(qns/entity/app.py)即可编写自己的协议,配合 qns/network/requests.py 的会话请求生成器批量注入流量
大规模仿真实测:性能如何保证?
量子网络研究往往需要 100+ 节点、数百条链路的长时仿真,性能是硬指标。SimQN 的应对方案:
- Cython 加速:事件调度等热点代码编译为 C 扩展(见 setup.py 与 setup-cython.py)
- 多进程支持:qns/utils/multiprocess.py 提供并行实验能力,examples/parallel_experiments.py 演示了同时跑多组参数扫描
- 高保真时间模型:时间以
Time对象(时隙精度)表达,Simulator构造时可指定纳秒级精度,避免浮点误差累积 - 监控工具:内置
Monitor实体(qns/entity/monitor/monitor.py)和完整日志体系(qns/utils/log.py),随时观察各节点队列、成码率等指标
学术验证与项目资料导航
SimQN 不是"玩具模拟器":自 2023 年发表于 IEEE Network 以来,已被 Q-DDCA 路由、REDP 可靠纠缠分发、NarrowGap 瓶颈优化等 21 篇论文采用,覆盖 IEEE JSAC、IEEE/ACM ToN 等顶刊。
新手入门建议按此路线查阅仓库内资料:
- 📖 项目概述:README.md(含完整快速上手示例)
- 📚 官方文档:docs/source/introduction.rst(架构与开发状态)、docs/source/develop.rst(贡献指南)
- 🧪 回归测试即教程:test/ 目录下按模块组织的测试用例,每个都是可直接运行的最小示例
- 🔧 物理模型细节:qns/models/qubit/(量子比特、门、退相干)与 qns/models/epr/(Bell 态、Werner 态、混合态)
总结:量子网络研究者的下一站
如果你正在研究 QKD 组网、纠缠路由算法或量子网络资源调度,SimQN 值得花一个下午跑通第一个示例:模块化架构降低工程负担,Cython 内核撑住大规模仿真,内置协议栈省去重复造轮子,而活跃的学术生态意味着你遇到的问题很可能已有论文踩过坑。量子互联网的研究竞赛已经开跑,选好你的仿真平台,从一条 pip install 开始吧。
