sequence 0.8.5.dev217420613__tar.gz → 1.0.0.dev1539950__tar.gz

sequence-1.0.0.dev1539950/LICENSE

@@ -0,0 +1,41 @@
+Copyright © 2026, UChicago Argonne, LLC
+
+All Rights Reserved
+
+Software Name: SeQUeNCe: Simulator of QUantum Network Communication
+
+By: Argonne National Laboratory, Illinois Institute of Technology, and 
+Encore Consulting Services, Inc.
+
+OPEN SOURCE LICENSE
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, 
+this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, 
+this list of conditions and the following disclaimer in the documentation 
+and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors 
+may be used to endorse or promote products derived from this software without 
+specific prior written permission.
+
+
+*****************************************************************************
+DISCLAIMER
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE 
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY 
+OF SUCH DAMAGE.
+*****************************************************************************

sequence-1.0.0.dev1539950/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: sequence
+Version: 1.0.0.dev1539950
+Summary: 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.
+Keywords: quantum,network,discrete,event,simulator
+Author: Xiaoliang Wu, Joaquin Chung, Alexander Kolar, Alexander Kiefer, Eugene Wang, Tian Zhong, Rajkumar Kettimuthu, Martin Suchara, Robert Hayek, Ansh Singal, Caitao Zhan
+Author-email: Xiaoliang Wu, Joaquin Chung, Alexander Kolar, Alexander Kiefer, Eugene Wang, Tian Zhong, Rajkumar Kettimuthu, Martin Suchara, Robert Hayek, Ansh Singal, Caitao Zhan <czhan@anl.gov>
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: dash>=3.3.0
+Requires-Dist: dash-bootstrap-components>=2.0.4
+Requires-Dist: dash-core-components>=2.0.0
+Requires-Dist: dash-cytoscape>=1.0.2
+Requires-Dist: dash-html-components>=2.0.0
+Requires-Dist: dash-table>=5.0.0
+Requires-Dist: gmpy2>=2.2.2
+Requires-Dist: graphviz>=0.21
+Requires-Dist: ipywidgets>=8.1.8
+Requires-Dist: jupyterlab>=4.5.0
+Requires-Dist: matplotlib>=3.10.7
+Requires-Dist: networkx>=3.6.1
+Requires-Dist: numpy>=2.3.5
+Requires-Dist: pandas>=2.3.3
+Requires-Dist: plotly>=6.5.0
+Requires-Dist: pytest>=9.0.2
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: qutip>=5.2.2
+Requires-Dist: qutip-qip>=0.4.1
+Requires-Dist: scipy>=1.16.3
+Requires-Dist: seaborn>=0.13.2
+Requires-Dist: tqdm>=4.67.1
+Requires-Dist: typer>=0.24.1
+Requires-Dist: stim>=1.15
+Maintainer: Caitao Zhan, Robert Hayek
+Maintainer-email: Caitao Zhan <czhan@anl.gov>, Robert Hayek <rhayek@anl.gov>
+Requires-Python: >=3.12, <3.15
+Project-URL: Homepage, https://github.com/sequence-toolbox/SeQUeNCe
+Project-URL: Documentation, https://sequence-rtd-tutorial.readthedocs.io/
+Project-URL: Issues, https://github.com/sequence-toolbox/SeQUeNCe/issues
+Project-URL: Changelog, https://github.com/sequence-toolbox/SeQUeNCe/blob/master/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/sequence-toolbox/SeQUeNCe/master/docs/Sequence_Icon_Name_Dark.png">
+   <img src="https://raw.githubusercontent.com/sequence-toolbox/SeQUeNCe/master/docs/Sequence_Icon_Name.svg" alt="sequence icon" width="450" class="center">
+  </picture>
+</p>
+
+<h3><p align="center">Quantum Networking in SeQUeNCe: Customizable, Scalable, Easy Debugging</p></h3>
+
+
+
+<div align="center">
+
+[![PyPi](https://img.shields.io/pypi/v/sequence)](https://pypi.org/project/sequence/)
+![pyversions](https://img.shields.io/pypi/pyversions/sequence)
+[![Documentation](https://img.shields.io/readthedocs/sequence-rtd-tutorial)](https://sequence-rtd-tutorial.readthedocs.io/)
+[![QuTiP](https://img.shields.io/badge/integration-QuTiP-blue)](https://qutip.org/)
+[![Stim](https://img.shields.io/badge/integration-Stim-blue)](https://github.com/quantumlib/Stim)
+[![Paper](https://img.shields.io/badge/10.1088%2F2058-9565%2Fac22f6?label=DOI)](https://iopscience.iop.org/article/10.1088/2058-9565/ac22f6)
+[![Download-month](https://img.shields.io/pypi/dm/sequence)](https://pypistats.org/packages/sequence)
+
+</div>
+
+
+
+<br>
+
+## SeQUeNCe: Simulator of QUantum Network Communication
+
+SeQUeNCe is an open source, discrete-event simulator for quantum networks. As described in our [paper](http://arxiv.org/abs/2009.12000), 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.
+
+## Installation
+### For Users
+SeQUeNCe requires [Python](https://www.python.org/downloads/) 3.12 or later. You can install SeQUeNCe using `pip`:
+```
+pip install sequence
+```
+
+### Development Environment Setup     
+If you wish to modify the source code, use an editable installation with either pip or [uv](https://docs.astral.sh/uv/):
+
+Editable installations let Python use your local source tree directly, so changes you make to the SeQUeNCe code are available **without reinstalling the package after each edit**. The `pip` option is a lightweight way to install the local package into an environment you already manage, while `uv` can create and synchronize a reproducible virtual environment from the project's dependency files.
+
+#### (1) Using pip
+```
+git clone https://github.com/sequence-toolbox/SeQUeNCe.git
+cd sequence
+make install_editable
+```
+
+In the Makefile, `install_editable` will run the following:
+```
+pip install --editable . --config-settings editable_mode=strict
+```
+The `--config-settings editable_mode=strict` setting makes the editable install behaves more like a real packaged install.
+
+#### (2) Using uv 
+
+##### Install uv ([Astral Instructions](https://docs.astral.sh/uv/getting-started/installation/))
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+##### Clone the repository and create the virtual environment
+
+Here we clone the repository and let uv configure the development environment with the target python version.
+```bash
+git clone https://github.com/sequence-toolbox/SeQUeNCe.git
+cd sequence
+uv sync
+```
+
+##### Activate the virtual environment
+
+Now that the virtual environment is created with all dependencies installed, you can activate it using the following command.
+
+```bash
+source .venv/bin/activate # macOS/Linux
+source .venv\Scripts\activate # Windows
+```
+
+##### Running the test suite
+
+SeQUeNCe includes a comprehensive test suite, this can be ran with the following command
+```
+uv run pytest tests
+```
+
+## 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},
+}
+```
+
+<!-- * X. Wu, A. Kolar, J. Chung, D. Jin, T. Zhong, R. Kettimuthu and M. Suchara. "SeQUeNCe: Simulator of QUantum Network Communication." GitHub repository, https://github.com/sequence-toolbox/SeQUeNCe, 2021. -->
+
+## Running the GUI
+Once SeQUeNCe has been installed as described above, 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](/example) folder. The example includes jupyter notebook demos, and code used in published papers.
+
+## 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](https://www.graphviz.org/download/).
+
+To view a network, 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](https://caitaozhan.github.io/) at [czhan@anl.gov](mailto:czhan@anl.gov).
+
+Here is the updated table with the Code column populated:
+
+## Papers that Used and/or Extended SeQUeNCe
+| Year | Authors | Title | Venue | Code |
+|------|---------|-------|-------|------|
+| 2026 | S. Pantage et al. | [Realistic Simulation of Quantum Repeater with Encoding and Classical Error Correction](https://arxiv.org/abs/2605.06928) | arXiv preprint | [GitHub](https://github.com/SagarPatange/Quantum-Repeater-Encoding) |
+| 2026 | A. Pirker et al. | [Centralizing Task-based Approach to Quantum Network Control](https://arxiv.org/abs/2605.03336) | arXiv preprint | [GitHub](https://github.com/sequence-toolbox/central_scheduler) |
+| 2026 | A. Amlou et al. | [Physics-Informed Discrete-Event Simulation of Polarization-Encoded Quantum Networks](https://arxiv.org/abs/2604.07289) | arXiv preprint | |
+| 2026 | H. Miller et al. | [Simulation of a Heterogeneous Quantum Network](https://doi.org/10.1109/QCNC69040.2026.00085) | IEEE QCNC | [GitHub](https://github.com/haydenmllr1317/heterogenous) |
+| 2026 | A. Zang et al. | [Quantum Advantage in Distributed Sensing with Noisy Quantum Networks](https://doi.org/10.1103/7n9w-9xd4) | Physical Review Research | |
+| 2025 | C. Zhan et al. | [Design and Simulation of the Adaptive Continuous Entanglement Generation Protocol](https://doi.org/10.1109/QCNC64685.2025.00028) | IEEE QCNC | [GitHub](https://github.com/caitaozhan/adaptive-continuous) |
+| 2025 | F. Mazza et al. | [Simulation of Entanglement-Enabled Connectivity in QLANs using SeQUeNCe](https://doi.org/10.1109/ICC52391.2025.11434940) | IEEE ICC | |
+| 2025 | L. d'Avossa et al. | [Simulation of Quantum Transduction Strategies for Quantum Networks](https://doi.org/10.1109/QCE65121.2025.00142) | IEEE QCE | |
+| 2025 | V. S. Mai et al. | [Towards Optimal Orders for Entanglement Swapping in Path Graphs: A Greedy Approach](https://arxiv.org/abs/2504.14040) | IEEE QCE | |
+| 2024 | C. Howe et al. | [Towards Scalable Quantum Repeater Networks](https://arxiv.org/abs/2409.08416) | arXiv preprint | |
+| 2024 | X. Wu et al. | [Parallel Simulation of Quantum Networks with Distributed Quantum State Management](https://dl.acm.org/doi/abs/10.1145/3634701) | ACM TOMACS | |
+| 2023 | R. Zhou et al. | [A Simulator of Atom-Atom Entanglement with Atomic Ensembles and Quantum Optics](https://doi.org/10.1109/QCE57702.2023.00143) | IEEE QCE | |
+| 2023 | M.G. Davis et al. | [Towards Distributed Quantum Computing by Qubit and Gate Graph Partitioning Techniques](https://doi.org/10.1109/QCE57702.2023.00026) | IEEE QCE | |
+| 2022 | A. Zang et al. | [Simulation of Entanglement Generation between Absorptive Quantum Memories](https://doi.org/10.1109/QCE53715.2022.00084) | IEEE QCE | |
+| 2022 | V. Semenenko et al. | [Entanglement generation in a quantum network with finite quantum memory lifetime](https://doi.org/10.1116/5.0082239) | AVS Quantum Science | |
+| 2021 | X. Wu et al. | [SeQUeNCe: A Customizable Discrete-Event Simulator of Quantum Networks](https://iopscience.iop.org/article/10.1088/2058-9565/ac22f6) | IOP Quantum Science and Technology | |
+| 2019 | X. Wu et al. | [Simulations of Photonic Quantum Networks for Performance Analysis and Experiment Design](https://ieeexplore.ieee.org/document/8950718) | IEEE/ACM PHOTONICS | |
+
+Please do a Pull Request to add your paper here! 

sequence-1.0.0.dev1539950/README.md

@@ -0,0 +1,165 @@
+<p align="center">
+  <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/sequence-toolbox/SeQUeNCe/master/docs/Sequence_Icon_Name_Dark.png">
+   <img src="https://raw.githubusercontent.com/sequence-toolbox/SeQUeNCe/master/docs/Sequence_Icon_Name.svg" alt="sequence icon" width="450" class="center">
+  </picture>
+</p>
+
+<h3><p align="center">Quantum Networking in SeQUeNCe: Customizable, Scalable, Easy Debugging</p></h3>
+
+
+
+<div align="center">
+
+[![PyPi](https://img.shields.io/pypi/v/sequence)](https://pypi.org/project/sequence/)
+![pyversions](https://img.shields.io/pypi/pyversions/sequence)
+[![Documentation](https://img.shields.io/readthedocs/sequence-rtd-tutorial)](https://sequence-rtd-tutorial.readthedocs.io/)
+[![QuTiP](https://img.shields.io/badge/integration-QuTiP-blue)](https://qutip.org/)
+[![Stim](https://img.shields.io/badge/integration-Stim-blue)](https://github.com/quantumlib/Stim)
+[![Paper](https://img.shields.io/badge/10.1088%2F2058-9565%2Fac22f6?label=DOI)](https://iopscience.iop.org/article/10.1088/2058-9565/ac22f6)
+[![Download-month](https://img.shields.io/pypi/dm/sequence)](https://pypistats.org/packages/sequence)
+
+</div>
+
+
+
+<br>
+
+## SeQUeNCe: Simulator of QUantum Network Communication
+
+SeQUeNCe is an open source, discrete-event simulator for quantum networks. As described in our [paper](http://arxiv.org/abs/2009.12000), 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.
+
+## Installation
+### For Users
+SeQUeNCe requires [Python](https://www.python.org/downloads/) 3.12 or later. You can install SeQUeNCe using `pip`:
+```
+pip install sequence
+```
+
+### Development Environment Setup     
+If you wish to modify the source code, use an editable installation with either pip or [uv](https://docs.astral.sh/uv/):
+
+Editable installations let Python use your local source tree directly, so changes you make to the SeQUeNCe code are available **without reinstalling the package after each edit**. The `pip` option is a lightweight way to install the local package into an environment you already manage, while `uv` can create and synchronize a reproducible virtual environment from the project's dependency files.
+
+#### (1) Using pip
+```
+git clone https://github.com/sequence-toolbox/SeQUeNCe.git
+cd sequence
+make install_editable
+```
+
+In the Makefile, `install_editable` will run the following:
+```
+pip install --editable . --config-settings editable_mode=strict
+```
+The `--config-settings editable_mode=strict` setting makes the editable install behaves more like a real packaged install.
+
+#### (2) Using uv 
+
+##### Install uv ([Astral Instructions](https://docs.astral.sh/uv/getting-started/installation/))
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+##### Clone the repository and create the virtual environment
+
+Here we clone the repository and let uv configure the development environment with the target python version.
+```bash
+git clone https://github.com/sequence-toolbox/SeQUeNCe.git
+cd sequence
+uv sync
+```
+
+##### Activate the virtual environment
+
+Now that the virtual environment is created with all dependencies installed, you can activate it using the following command.
+
+```bash
+source .venv/bin/activate # macOS/Linux
+source .venv\Scripts\activate # Windows
+```
+
+##### Running the test suite
+
+SeQUeNCe includes a comprehensive test suite, this can be ran with the following command
+```
+uv run pytest tests
+```
+
+## 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},
+}
+```
+
+<!-- * X. Wu, A. Kolar, J. Chung, D. Jin, T. Zhong, R. Kettimuthu and M. Suchara. "SeQUeNCe: Simulator of QUantum Network Communication." GitHub repository, https://github.com/sequence-toolbox/SeQUeNCe, 2021. -->
+
+## Running the GUI
+Once SeQUeNCe has been installed as described above, 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](/example) folder. The example includes jupyter notebook demos, and code used in published papers.
+
+## 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](https://www.graphviz.org/download/).
+
+To view a network, 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](https://caitaozhan.github.io/) at [czhan@anl.gov](mailto:czhan@anl.gov).
+
+Here is the updated table with the Code column populated:
+
+## Papers that Used and/or Extended SeQUeNCe
+| Year | Authors | Title | Venue | Code |
+|------|---------|-------|-------|------|
+| 2026 | S. Pantage et al. | [Realistic Simulation of Quantum Repeater with Encoding and Classical Error Correction](https://arxiv.org/abs/2605.06928) | arXiv preprint | [GitHub](https://github.com/SagarPatange/Quantum-Repeater-Encoding) |
+| 2026 | A. Pirker et al. | [Centralizing Task-based Approach to Quantum Network Control](https://arxiv.org/abs/2605.03336) | arXiv preprint | [GitHub](https://github.com/sequence-toolbox/central_scheduler) |
+| 2026 | A. Amlou et al. | [Physics-Informed Discrete-Event Simulation of Polarization-Encoded Quantum Networks](https://arxiv.org/abs/2604.07289) | arXiv preprint | |
+| 2026 | H. Miller et al. | [Simulation of a Heterogeneous Quantum Network](https://doi.org/10.1109/QCNC69040.2026.00085) | IEEE QCNC | [GitHub](https://github.com/haydenmllr1317/heterogenous) |
+| 2026 | A. Zang et al. | [Quantum Advantage in Distributed Sensing with Noisy Quantum Networks](https://doi.org/10.1103/7n9w-9xd4) | Physical Review Research | |
+| 2025 | C. Zhan et al. | [Design and Simulation of the Adaptive Continuous Entanglement Generation Protocol](https://doi.org/10.1109/QCNC64685.2025.00028) | IEEE QCNC | [GitHub](https://github.com/caitaozhan/adaptive-continuous) |
+| 2025 | F. Mazza et al. | [Simulation of Entanglement-Enabled Connectivity in QLANs using SeQUeNCe](https://doi.org/10.1109/ICC52391.2025.11434940) | IEEE ICC | |
+| 2025 | L. d'Avossa et al. | [Simulation of Quantum Transduction Strategies for Quantum Networks](https://doi.org/10.1109/QCE65121.2025.00142) | IEEE QCE | |
+| 2025 | V. S. Mai et al. | [Towards Optimal Orders for Entanglement Swapping in Path Graphs: A Greedy Approach](https://arxiv.org/abs/2504.14040) | IEEE QCE | |
+| 2024 | C. Howe et al. | [Towards Scalable Quantum Repeater Networks](https://arxiv.org/abs/2409.08416) | arXiv preprint | |
+| 2024 | X. Wu et al. | [Parallel Simulation of Quantum Networks with Distributed Quantum State Management](https://dl.acm.org/doi/abs/10.1145/3634701) | ACM TOMACS | |
+| 2023 | R. Zhou et al. | [A Simulator of Atom-Atom Entanglement with Atomic Ensembles and Quantum Optics](https://doi.org/10.1109/QCE57702.2023.00143) | IEEE QCE | |
+| 2023 | M.G. Davis et al. | [Towards Distributed Quantum Computing by Qubit and Gate Graph Partitioning Techniques](https://doi.org/10.1109/QCE57702.2023.00026) | IEEE QCE | |
+| 2022 | A. Zang et al. | [Simulation of Entanglement Generation between Absorptive Quantum Memories](https://doi.org/10.1109/QCE53715.2022.00084) | IEEE QCE | |
+| 2022 | V. Semenenko et al. | [Entanglement generation in a quantum network with finite quantum memory lifetime](https://doi.org/10.1116/5.0082239) | AVS Quantum Science | |
+| 2021 | X. Wu et al. | [SeQUeNCe: A Customizable Discrete-Event Simulator of Quantum Networks](https://iopscience.iop.org/article/10.1088/2058-9565/ac22f6) | IOP Quantum Science and Technology | |
+| 2019 | X. Wu et al. | [Simulations of Photonic Quantum Networks for Performance Analysis and Experiment Design](https://ieeexplore.ieee.org/document/8950718) | IEEE/ACM PHOTONICS | |
+
+Please do a Pull Request to add your paper here! 

{sequence-0.8.5.dev217420613 → sequence-1.0.0.dev1539950}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sequence"
-version = "0.8.5.dev217420613"
+version = "1.0.0.dev1539950"
 authors = [
     { name = "Xiaoliang Wu, Joaquin Chung, Alexander Kolar, Alexander Kiefer, Eugene Wang, Tian Zhong, Rajkumar Kettimuthu, Martin Suchara, Robert Hayek, Ansh Singal, Caitao Zhan", email = "czhan@anl.gov" }
 ]
@@ -8,11 +8,11 @@ maintainers = [
     { name = "Caitao Zhan", email = "czhan@anl.gov" },
     { name = "Robert Hayek", email = "rhayek@anl.gov" }
 ]
+license-files = ["LICENSE"]
 description = "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."
 readme = "README.md"
-requires-python = ">=3.11, <3.15"
+requires-python = ">=3.12, <3.15"
 classifiers = [
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14"
@@ -26,36 +26,52 @@ dependencies = [
     "dash-html-components>=2.0.0",
     "dash-table>=5.0.0",
     "gmpy2>=2.2.2",
+    "graphviz>=0.21",
     "ipywidgets>=8.1.8",
     "jupyterlab>=4.5.0",
     "matplotlib>=3.10.7",
     "networkx>=3.6.1",
     "numpy>=2.3.5",
     "pandas>=2.3.3",
-    "pandas-stubs~=2.3.3",
     "plotly>=6.5.0",
     "pytest>=9.0.2",
+    "pyyaml>=6.0.3",
     "qutip>=5.2.2",
     "qutip-qip>=0.4.1",
     "scipy>=1.16.3",
-    "scipy-stubs~=1.16.3",
     "seaborn>=0.13.2",
     "tqdm>=4.67.1",
+    "typer>=0.24.1",
+    "stim>=1.15"
 ]
 
+[project.scripts]
+generate-topology = "sequence.utils.config_generator_cli:app"
+
 [build-system]
-requires = ["uv_build>=0.9.17,<0.10.0"]
+requires = ["uv_build>=0.11.11,<0.12"]
 build-backend = "uv_build"
 
 [tool.uv.build-backend]
 module-root = ""
 module-name = "sequence"
 
-[tool.setuptools.package-data]
-sequence = ["gui/user_templates.json", "gui/default_params.json", "gui/starlight.json"]
+[tool.pytest.ini_options]
+markers = [
+    "unit: Marks tests as unit tests",
+]
+
+[dependency-groups]
+dev = [
+    "coverage>=7.13.4",
+    "ruff>=0.15.1",
+    "ty>=0.0.16",
+    "pandas-stubs~=2.3.3",
+    "scipy-stubs~=1.16.3",
+]
 
 [project.urls]
 Homepage = "https://github.com/sequence-toolbox/SeQUeNCe"
 Documentation = "https://sequence-rtd-tutorial.readthedocs.io/"
 Issues = "https://github.com/sequence-toolbox/SeQUeNCe/issues"
-Changelog = "https://github.com/sequence-toolbox/SeQUeNCe/blob/master/CHANGELOG.md"
+Changelog = "https://github.com/sequence-toolbox/SeQUeNCe/blob/master/CHANGELOG.md"

{sequence-0.8.5.dev217420613 → sequence-1.0.0.dev1539950}/sequence/__init__.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 
 __all__ = ['app', 'components', 'entanglement_management', 'kernel', 'network_management', 'qkd', 'resource_management',
-           'topology', 'utils', 'message', 'protocol', 'gui', 'qlan', 'read_version_from_pyproject']
+           'topology', 'utils', 'message', 'protocol', 'gui', 'read_version_from_pyproject']
 
 
 def read_version_from_pyproject() -> str:

{sequence-0.8.5.dev217420613 → sequence-1.0.0.dev1539950}/sequence/app/request_app.py

@@ -82,7 +82,20 @@ class RequestApp:
         self.reservation_result = result
         if result:
             self.schedule_reservation(reservation)
-            log.logger.info(f"Successful reservation of resources for request app on node {self.node.name}")
+            log.logger.info(f"{self.node.name}, reservation successful: {reservation}")
+        else:
+            log.logger.info(f"{self.node.name}, reservation failed: {reservation}")
+
+    def get_other_reservation(self, reservation: Reservation) -> None:
+        """Method to add the approved reservation that is requested by other nodes. The responder will call this method
+
+        Args:
+            reservation (Reservation): reservation that uses the node of an application as the responder
+
+        Side Effects:
+            Will add calls to `add_memo_reservation_map` and `remove_memo_reservation_map` methods.
+        """
+        self.schedule_reservation(reservation)
 
     def add_memo_reservation_map(self, index: int, reservation: Reservation) -> None:
         """Maps memory index to the corresponding reservation.
@@ -132,23 +145,20 @@ class RequestApp:
     def get_throughput(self) -> float:
         return self.memory_counter / (self.end_t - self.start_t) * 1e12
 
-    def get_other_reservation(self, reservation: Reservation) -> None:
-        """Method to add the approved reservation that is requested by other nodes. The responder will call this method
 
-        Args:
-            reservation (Reservation): reservation that uses the node of application as the responder
+    def schedule_reservation(self, reservation: Reservation) -> None:
+        """Calling the `add_memo_reservation_map` and `remove_memo_reservation_map` methods at the 
+           reservation's start_time and end_time for all timecards (memory) involved in the reservation. 
+           
+           Called by the initiator and the responder when reservation is approved.
 
-        Side Effects:
-            Will add calls to `add_memo_reservation_map` and `remove_memo_reservation_map` methods.
+        Args:
+            reservation (Reservation): reservation to schedule
         """
-        self.schedule_reservation(reservation)
-
-    def schedule_reservation(self, reservation: Reservation) -> None:
         if reservation.initiator == self.node.name:
             self.path = reservation.path
 
-        reservation_protocol = self.node.network_manager.protocol_stack[1]
-        for card in reservation_protocol.timecards:
+        for card in self.node.network_manager.get_timecards():
             if reservation in card.reservations:
                 process = Process(self, "add_memo_reservation_map", [card.memory_index, reservation])
                 event = Event(reservation.start_time, process)

{sequence-0.8.5.dev217420613 → sequence-1.0.0.dev1539950}/sequence/components/bsm.py

@@ -21,7 +21,7 @@ from .photon import Photon
 from ..kernel.entity import Entity
 from ..kernel.event import Event
 from ..kernel.process import Process
-from ..constants import KET_STATE_FORMALISM, DENSITY_MATRIX_FORMALISM
+from ..constants import KET_VECTOR_FORMALISM, DENSITY_MATRIX_FORMALISM
 from ..utils.encoding import *
 from ..utils import log
 
@@ -54,7 +54,7 @@ def _set_state_with_fidelity(keys: list[int], desired_state: list[complex], fide
                        BSM._psi_plus, BSM._psi_minus]
     assert desired_state in possible_states
 
-    if qm.get_active_formalism() == KET_STATE_FORMALISM:
+    if qm.get_active_formalism() == KET_VECTOR_FORMALISM:
         probabilities = [(1 - fidelity) / 3] * 4
         probabilities[possible_states.index(desired_state)] = fidelity
         state_ind = rng.choice(4, p=probabilities)
@@ -73,26 +73,24 @@ def _set_state_with_fidelity(keys: list[int], desired_state: list[complex], fide
 
 
 def _set_pure_state(keys: list[int], ket_state: list[complex], qm: "QuantumManager"):
-    if qm.get_active_formalism() == KET_STATE_FORMALISM:
+    if qm.get_active_formalism() == KET_VECTOR_FORMALISM:
         qm.set(keys, ket_state)
     elif qm.get_active_formalism() == DENSITY_MATRIX_FORMALISM:
         state = outer(ket_state, ket_state)
         qm.set(keys, state)
     else:
-        raise NotImplementedError("formalism of quantum state {} is not "
-                                  "implemented in the set_pure_quantum_state "
+        raise NotImplementedError("formalism of quantum state {} is not implemented in the set_pure_quantum_state "
                                   "function of bsm.py".format(qm.get_active_formalism()))
 
 
 def _eq_psi_plus(state: "State", formalism: str):
-    if formalism == KET_STATE_FORMALISM:
+    if formalism == KET_VECTOR_FORMALISM:
         return array_equal(state.state, BSM._psi_plus)
     elif formalism == DENSITY_MATRIX_FORMALISM:
-        d_state = outer(BSM._phi_plus, BSM._psi_plus)
+        d_state = outer(BSM._psi_plus, BSM._psi_plus)
         return array_equal(state.state, d_state)
     else:
-        raise NotImplementedError("formalism of quantum state {} is not "
-                                  "implemented in the eq_phi_plus "
+        raise NotImplementedError("formalism of quantum state {} is not implemented in the eq_phi_plus "
                                   "function of bsm.py".format(formalism))
 
 
@@ -166,9 +164,9 @@ class BSM(Entity):
             photon (Photon): photon to measure.
         """
 
-        assert photon.encoding_type["name"] == self.encoding, \
-            "BSM expecting photon with encoding '{}' received photon with encoding '{}'".format(
-                self.encoding, photon.encoding_type["name"])
+        assert photon.encoding_type["name"] == self.encoding, (
+            f"BSM expecting photon with encoding '{self.encoding}' "
+            f"received photon with encoding '{photon.encoding_type['name']}'")
 
         # check if photon arrived later than current photon
         if self.photon_arrival_time < self.timeline.now():
@@ -725,4 +723,4 @@ class ShellBSM(BSM):
         This method is intentionally left empty as ShellBSM serves as a placeholder BSM implementation.
         No action is performed when a detector is triggered.
         """
-        pass
+        pass

{sequence-0.8.5.dev217420613 → sequence-1.0.0.dev1539950}/sequence/components/circuit.py

@@ -4,7 +4,6 @@ This module introduces the QuantumCircuit class. The qutip library is used to ca
 """
 
 from math import e, pi, sqrt
-from typing import Optional
 
 import numpy as np
 from qutip_qip.circuit import QubitCircuit

{sequence-0.8.5.dev217420613 → sequence-1.0.0.dev1539950}/sequence/components/detector.py

@@ -371,7 +371,7 @@ class QSDetectorFockDirect(QSDetector):
         series_elem_list = [((-1) ** i) * fractional_matrix_power(create1, i + 1).dot(
             fractional_matrix_power(destroy1, i + 1)) / factorial(i + 1) for i in range(truncation)]
         povm1_1 = sum(series_elem_list)
-        povm1_0 = eye(truncation + 1) - povm0_1
+        povm1_0 = eye(truncation + 1) - povm1_1
 
         self.povms = [povm0_0, povm0_1, povm1_0, povm1_1]
 
@@ -518,8 +518,8 @@ class QSDetectorFockInterference(QSDetector):
         arrival_time = self.timeline.now()
         self.arrival_times[input_port].append(arrival_time)
         # record in temporary photon list
-        assert not self.temporary_photon_info[input_port], \
-            "At most 1 Photon instance should arrive at an input port at a time."
+        assert not self.temporary_photon_info[input_port], (
+            "At most 1 Photon instance should arrive at an input port at a time.")
         self.temporary_photon_info[input_port]["photon"] = photon
         self.temporary_photon_info[input_port]["time"] = arrival_time