Adam Pearson

Adam Pearson, Francesco Mazza, Marcello Caleffi et al.

As quantum networking hardware remains costly and not yet widely accessible, simulation tools are essential for the design and evaluation of quantum network architectures and protocols. However, designing a scalable and computationally efficient quantum network simulator is intrinsically challenging: i) quantum dynamics must be emulated on classical computing platforms while capturing the stateful and non-local nature of entanglement, a quantum resource without any classical networking analog; ii) quantum networking is inherently hybrid, as protocol execution also fundamentally depends on classical signaling. This makes a tight and faithful co-simulation of quantum operations and classical message exchanges a core requirement. In this light, we present Q2NS, a modular and extensible quantum network simulator, built on top of ns-3, designed to seamlessly integrate quantum-network primitives with ns-3's established classical protocol stack. Q2NS adopts a modular architecture that decouples protocol control logic from node- and channel-level operations, enabling rapid prototyping and adaptation across heterogeneous and evolving Quantum Internet scenarios. Q2NS natively supports multiple quantum state representations through a unified interface, allowing interchangeable state-vector, density-matrix, and stabilizer backends. We validate Q2NS through realistic use-case studies and comprehensive benchmarks, demonstrating superior computational efficiency over representative state-of-the-art alternatives, while preserving modeling flexibility. Finally, we provide a dedicated visualization tool that jointly captures physical and entanglement-enabled connectivity and supports entangled-state manipulations, facilitating an intuitive interpretation of entanglement dynamics and protocol behavior. Q2NS offers a flexible, open, and scalable simulation platform for advancing Quantum Internet research.

Francesco Mazza, Adam Pearson, Marcello Caleffi et al.

Q2NS is an open-source quantum network simulator built on ns-3, the de facto standard for classical network simulation. By inheriting ns-3's mature classical stack and event-driven execution model, Q2NS enables faithful co-simulation of quantum-network dynamics and classical signaling, a core requirement for the functioning of any quantum network. Its modular architecture is designed for extensibility, with pluggable quantum-state backends (state-vector, density matrix, stabilizer) and a clean separation between network control and node-level operations. Q2NS comes with a quantum network visualizer Q2NSViz, supporting interactive inspection of both physical- and entanglement-induced connectivity graphs, helping users interpret protocol behavior and entanglement manipulation processes. We present a demonstration of Q2NS, highlighting its ability to capture and simulate the coexistence of quantum and classical communication. The proposed demonstration presents quantum communication scenarios of increasing complexity: from entanglement distribution basics to multipartite graph-state manipulation, complemented by pre-loaded examples in Q2NSViz that require no prior quantum communication or coding experience.