SimQN快速上手:10行代码构建150节点纠缠分发网络全流程

原创2026-10-14 09:49:561,663 阅读

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量子网络模拟器模块架构图:Network拓扑/路由/请求、Entities实体、Simulator事件模拟器与Backends物理模型

架构图展示了 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/ 目录提供了丰富的可扩展起点:

想修改协议行为?只需继承 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 网络研究的方式。🚀

登录后查看全文
SimQN