SimQN快速上手:10行代码构建150节点纠缠分发网络全流程
SimQN快速上手:10行代码构建150节点纠缠分发网络全流程
SimQN 是一个基于离散事件驱动的量子网络模拟器(Python3 库),支持 QKD 协议、纠缠分发协议、路由算法与资源分配等大规模仿真。本文带你用官方示例完整走一遍流程:仅用约 10 行核心代码,即可搭建并运行一个 150 个节点、450 条量子信道的纠缠分发网络,最后统计每个源宿会话的纠缠分发成功次数。
完整示例代码见 examples/entanglement_distribution_random_topo.py,教程文档见 docs/source/tutorials.quickstart.rst。
SimQN 一键安装:pip 命令快速部署
SimQN 已发布到 PyPI,一条命令即可完成安装与升级:
pip3 install -U qns
核心依赖为 numpy(见 requirements.txt),无需额外配置即可运行全部示例。若追求更高仿真性能,可用 Cython 编译核心事件调度代码(见 setup-cython.py)。
一图看懂 SimQN 模块架构
架构图展示了 SimQN 的五大模块:
| 模块 | 目录 | 职责 |
|---|---|---|
qns.simulator |
qns/simulator/ | 离散事件驱动的仿真核心(事件池、时间戳) |
qns.entity |
qns/entity/ | 节点、量子/经典信道、量子存储、定时器 |
qns.models |
qns/models/ | 量子比特、纠缠(EPR/Werner/Bell)物理模型 |
qns.network |
qns/network/ | 拓扑生成器、路由算法、协议应用、请求管理 |
qns.utils |
qns/utils/ | 日志、随机数、多进程工具 |
这种"节点模块化 + 协议可复用"的设计,意味着你无需重复实现路由与协议栈,专注自己的研究问题即可。
构建150节点纠缠分发网络的完整代码
下面按 6 个步骤拆解官方示例,核心调用仅 10 行左右:
第1步:创建模拟器并挂载日志
from qns.simulator.simulator import Simulator
import qns.utils.log as log
import logging
# 仿真 0~10 秒,每 1 秒划分为 1e6 个时间槽
s = Simulator(0, 10, accuracy=1000000)
log.logger.setLevel(logging.INFO)
log.install(s)
第2步:生成随机拓扑并预装协议应用
RandomTopology 基于生成树保证网络连通,每个节点自动安装量子存储与 EntanglementDistributionApp(逐跳纠缠分发应用,源码见 qns/network/protocol/entanglement_distribution.py):
from qns.network.topology import RandomTopology
from qns.network.protocol.entanglement_distribution import EntanglementDistributionApp
topo = RandomTopology(nodes_number=150, # 节点数
lines_number=450, # 量子信道数
qchannel_args={"delay": 0.05},
cchannel_args={"delay": 0.05},
memory_args=[{"capacity": 50}],
nodes_apps=[EntanglementDistributionApp(init_fidelity=0.99)])
第3步:构建网络并生成路由表
使用 Dijkstra 路由算法(qns/network/route/dijkstra.py),经典信道取全连接模式:
from qns.network import QuantumNetwork
from qns.network.route.dijkstra import DijkstraRouteAlgorithm
from qns.network.topology.topo import ClassicTopology
net = QuantumNetwork(topo=topo,
classic_topo=ClassicTopology.All,
route=DijkstraRouteAlgorithm())
net.build_route()
第4步:随机生成源宿会话并启动仿真
net.random_requests(10, attr={"send_rate": 10}) # 10 个源宿对
net.install(s) # 所有实体安装模拟器并完成初始化
s.run() # 运行仿真
核心参数速查表
| 参数 | 示例值 | 含义 |
|---|---|---|
init_fidelity |
0.99 | 初始纠缠保真度 |
nodes_number |
150 | 网络节点数 |
lines_number |
450 | 量子信道(链路)数 |
qchannel_delay |
0.05 | 量子信道传输时延(秒) |
cchannel_delay |
0.05 | 经典信道传输时延(秒) |
memory_capacity |
50 | 每节点量子存储容量 |
send_rate |
10 | 源节点纠缠发送速率(次/秒) |
requests_number |
10 | 随机源宿会话(SD-pair)数量 |
获取仿真结果:统计纠缠分发成功次数
仿真结束后,每个源节点的应用会记录分发成功计数:
# 每个会话的纠缠分发成功次数
results = [req.src.apps[0].success_count for req in net.requests]
log.monitor(requests_number, nodes_number, results, s.time_spend, sep=" ")
如需查看具体纠缠对的保真度,可访问 success 列表中的 EPR 对象(见 docs/source/tutorials.entity.qchannel.rst)。
进阶玩法:扩展拓扑、协议与并行仿真
官方 examples/ 目录提供了丰富的可扩展起点:
- 线型拓扑纠缠分发:examples/entanglement_distribution_line_topo.py,对比不同链路时延下的端到端保真度;
- BB84 量子密钥分发:examples/simple_bb84.py,手动构建双节点链路并统计成码率;
- 可信中继 BB84:examples/trusted_relay_bb84.py;
- 多进程并行仿真:继承
MPSimulations(qns/utils/multiprocess.py)可把"节点数 × 时延 × 存储容量"等参数组合分派到多核并行执行,适合大规模参数扫描实验,参考 examples/parallel_experiments.py; - 更多拓扑生成器:ER、BA、Grid、Tree、Waxman、真实互联网拓扑等,见 qns/network/topology/ 与 docs/source/tutorials.network.topology.rst。
想修改协议行为?只需继承 Application 基类,实现 install 方法并注册事件处理器,内置的 BB84SendApp、EntanglementDistributionApp 都是很好的模板(源码位于 qns/network/protocol/)。
学习资源清单:从文档到测试用例
| 资源 | 路径 | 说明 |
|---|---|---|
| 快速入门教程 | docs/source/tutorials.quickstart.rst | 两条仿真路线的逐步讲解 |
| 实体/模型/网络教程 | docs/source/tutorials.entity.rst、docs/source/tutorials.models.rst | 节点、信道、量子比特与纠缠模型 |
| API 手册 | docs/source/modules.rst | 全部模块接口说明 |
| 单元测试 | test/ | 每个功能均配有 pytest 用例,是最好的"活文档" |
| 官方论文示例复现 | examples/ | 多协议、多拓扑的完整可运行脚本 |
至此,你已经掌握了 SimQN 从安装、建网、路由、注入请求到收集结果的完整链路。下一步建议:把示例中的随机拓扑换成 WaxmanTopology,或调大 requests_number 观察网络瓶颈——这正是 SimQN 被 20+ 篇学术论文用于纠缠路由与 QKD 网络研究的方式。🚀
