Skip to main content

Simulator of QUantum Network Communication (SeQUeNCe) is an open-source tool that allows modeling of quantum networks including photonic network components, control protocols, and applications.

Project description

sequence icon

Quantum Networking in SeQUeNCe: Customizable, Scalable, Easy Debugging

PyPi pyversions Documentation Qutip Paper Download-month


SeQUeNCe: Simulator of QUantum Network Communication

SeQUeNCe is an open source, discrete-event simulator for quantum networks. As described in our paper, the simulator includes 5 modules on top of a simulation kernel:

  • Hardware
  • Entanglement Management
  • Resource Management
  • Network Management
  • Application

These modules can be edited by users to define additional functionality and test protocol schemes, or may be used as-is to test network parameters and topologies.

Installing

SeQUeNCe requires Python 3.10 or later. You can simply install SeQUeNCe using pip:

pip install sequence

If you wish to make your own edits to the codebase, SeQUeNCe should be installed in development mode (a.k.a. editable install). To do so, clone and install the simulator as follows:

git clone https://github.com/sequence-toolbox/SeQUeNCe.git
cd SeQUeNCe
pip install --editable . --config-settings editable_mode=strict

For Linux and Mac users, you could use make install_editable instead of pip install --editable . --config-settings editable_mode=strict.

Citation

Please cite us, thank you!

@article{sequence,
author = {Xiaoliang Wu and Alexander Kolar and Joaquin Chung and Dong Jin and Tian Zhong and Rajkumar Kettimuthu and Martin Suchara},
title = {SeQUeNCe: a customizable discrete-event simulator of quantum networks},
journal = {Quantum Science and Technology},
volume = {6},
year = {2021},
month = {sep},
doi = {10.1088/2058-9565/ac22f6},
url = {https://dx.doi.org/10.1088/2058-9565/ac22f6},
publisher = {IOP Publishing},
}

Running the GUI

Once SeQUeNCe has been installed as described above, simply run the gui.py script found in the root of the project directory

python gui.py

Usage Examples

Many examples of SeQUeNCe in action can be found in the example folder. These include both quantum key distribution and entanglement distribution examples.

Starlight Experiments

Code for the experiments performed in our paper can be found in the file starlight_experiments.py. This script uses the starlight.json file (also within the example folder) to specify the network topology.

Jupyter Notebook Examples

The example folder contains several scripts that can be run with jupyter notebook for easy editing and visualization. These files require that the notebook package be installed (Anaconda recommended):

pip install notebook
pip install ipywidgets

To run each file, simply run

jupyter notebook <filename>

These examples include:

  • BB84_eg.ipynb, which uses the BB84 protocol to distribute secure keys between two quantum nodes
  • two_node_eg.ipynb, which performs entanglement generation between two adjacent quantum routers
  • three_node_eg_ep_es.ipynb, which performs entanglement generation, purification, and swapping for a linear network of three quantum routers

Additional Tools

Network Visualization

The example directory contains an example json file starlight.json to specify a network topology, and the utils directory contains the script draw_topo.py to visualize json files. To use this script, the Graphviz library must be installed. Installation information can be found on the Graphviz website.

To view a network, simply run the script and specify the relative location of your json file:

python utils/draw_topo.py example/starlight.json

This script also supports a flag -m to visualize BSM nodes created by default on quantum links between routers.

Contact

If you have questions, please contact Caitao Zhan at czhan@anl.gov.

Papers that Used and/or Extended SeQUeNCe

Please do a Pull Request to add your paper here!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sequence-0.7.2.tar.gz (138.9 kB view details)

Uploaded Source

Built Distribution

sequence-0.7.2-py3-none-any.whl (171.2 kB view details)

Uploaded Python 3

File details

Details for the file sequence-0.7.2.tar.gz.

File metadata

  • Download URL: sequence-0.7.2.tar.gz
  • Upload date:
  • Size: 138.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.5

File hashes

Hashes for sequence-0.7.2.tar.gz
Algorithm Hash digest
SHA256 d233562dea1f801f4498187c51851bd6872d0fe9bfabdd37803ca4f4d154916e
MD5 91860d13c34b3e6cda1aae51ed53dc89
BLAKE2b-256 b5cd19f1a81616b3e5530d55864c879b1ba5b87da18dff3f9a907f2950b4a2b9

See more details on using hashes here.

File details

Details for the file sequence-0.7.2-py3-none-any.whl.

File metadata

  • Download URL: sequence-0.7.2-py3-none-any.whl
  • Upload date:
  • Size: 171.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.5

File hashes

Hashes for sequence-0.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ab49b97ecb690aee65e9ea0297ad490b92d2981aca5e0e4dbf8cc4a28ab42c8f
MD5 e699ceeb66a27a68c9dbe4dc93a0df13
BLAKE2b-256 593436cf59711707decc2150f5a24e7ac5602bc8bac0b969d011008cec708b62

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page