DSNS: The Deep Space Network Simulator
======================================

The Deep Space Network Simulator (DSNS) is an event-based network simulator designed for efficient simulation of satellite networks and interplanetary communication, to facilitate protocol testing and development.
The paper introducing it can be found on arXiv `here <https://arxiv.org/pdf/2508.04317>`__.

When using DSNS, please cite the following paper: **"DSNS: The Deep Space Network Simulator"**.
The BibTeX entry is given below:

.. code-block:: bibtex

    @inproceedings{smailesDSNS2025,
        author = {Smailes, Joshua and Futera, Filip and K{\"o}hler, Sebastian and Birnbach, Simon and Strohmeier, Martin and Martinovic, Ivan},
        title = {{DSNS}: {The Deep Space Network Simulator}},
        booktitle={2025 Security for Space Systems (3S)},
        year={2025},
        organization={IEEE}
    }


Papers and projects which have used DSNS:
- "KeySpace: Enhancing Public Key Infrastructure for Interplanetary Networks" (2025): https://arxiv.org/abs/2408.10963
- "Secure and Scalable Rerouting in LEO Satellite Networks" (2025): https://arxiv.org/abs/2509.10173

To add your project to this list, or to merge your contributions with DSNS, feel free to submit a pull request.

We welcome any contributions to DSNS, including but not limited to improved documentation, refactoring, new features, examples, and reference scenarios.
To make a contribution, please add an issue to the tracker or create a pull request, and we will aim to merge any changes shortly.
Please note that any code changes must come with corresponding changes to the documentation.

License
-------

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.


.. toctree::
    :maxdepth: 2
    :caption: Contents:

    installation
    examples
    api



Indices and tables
==================

* :ref:`genindex`
* :ref:`search`

.. * :ref:`modindex`