HERON orbit analysis for mission OPS.
Hermes uses supernova and celest to perform analysis on HERON orbit, and passes over the ground station.
It's still in development.
- Python 3.8 - 3.10
- C compiler (e.g. GCC, MSVC, Clang)
- On linux, GCC should already be installed by default
- On Windows, install MSVC
- Make doubly sure that you have a C compiler installed!
- Clone the repo and open a terminal in the resository root
- Make a virtual environment (optional, but recommended, especially on Windows)
- Run
pip install -e .
The installation script will automatically compile the C extension.
That's it! You're ready to go. If you need to pull TLEs from Space-Track, see the next section.
If you want to use anything under hermes.spacetrack
, you will need to give your Space-Track credentials. There are two ways to do this:
Create environment variables called SPACETRACK_EMAIL
and SPACETRACK_PASSWORD
.
Create a file called .env
in the repository root, and add the following lines:
SPACETRACK_EMAIL=<your email>
SPACETRACK_PASSWORD=<your password>
There are two demo scripts which show off the functionality of Hermes:
This script propagates the HERON orbit for 50 days, starting from an initial state vector. It plots the orbit, initial/final TLEs, and finds times when the spacecraft is in view of the ground station.
This script finds the latest TLE for the ISS. Make sure to set your Space-Track credentials first!
If you need something custom, there are probably bits and pieces in the existing codebase that may suit your needs. Take a look, and get in touch if you need something specific.