Skip to content

Latest commit

 

History

History
63 lines (47 loc) · 2.1 KB

README.md

File metadata and controls

63 lines (47 loc) · 2.1 KB
Raw

Hypatia

Build Status

Hypatia is a low earth orbit (LEO) satellite network simulation framework.

It consists of four main components:

  • satgenpy : Python framework to generate LEO satellite networks and generate routing over time over a period of time. It additionally includes several analysis tools to study individual cases. (license: MIT)

  • ns3-sat-sim : ns-3 based framework which takes as input the state generated by satgenpy to perform packet-level simulations over LEO satellite networks. It makes use of the satellite ns-3 module by Pedro Silva to calculate satellite locations over time. (license: GNU GPL version 2)

  • satviz : Cesium visualization pipeline to generate interactive satellite network visualizations. It makes use of the online Cesium API by generating CesiumJS code. The API calls require its user to obtain a Cesium access token (via https://cesium.com/). More information can be found in satviz/README.md. (license: MIT)

  • paper : Experimental and plotting code to reproduce the experiments and figures which are presented in the paper. (license: MIT)

(there is a fifth folder called integration_tests which is used for integration testing purposes)

This is the code repository introduced and used in "Exploring the “Internet from space” with Hypatia" by Simon Kassing*, Debopam Bhattacherjee*, André Baptista Águas, Jens Eirik Saethre and Ankit Singla (*equal contribution), which is published in the Internet Measurement Conference (IMC) 2020.

BibTeX citation:

To be announced.

Getting started

  1. System setup:

    • Python version 3.7+
    • Recent Linux operating system (e.g., Ubuntu 18+)

  2. Install dependencies:

    bash hypatia_install_dependencies.sh

  3. Build all four modules (as far as possible):

    bash hypatia_build.sh

  4. Run tests:

    bash hypatia_run_tests.sh

  5. The reproduction of the paper is essentially the tutorial for Hypatia. Please navigate to paper/README.md.