Sim-Ops is software suite for running spacecraft operations simulations exercises and demonstrations. It includes a minimalist spacecraft simulator, a ground station simulator and a Monitoring and Control System (MCS). Note, that the software suite is under constant development so things change fast. The following video illustrates the MCS UI.

Repository content:

• sim-ops-lib/: Python packages to run in the background, including API and simulators.
• sim-ops-mcs/: MCS frontend interface.
• containers/: containers files and configurations.

The following scripts are required to be running:

• so-master.py: the master script managing the simulations in the background.
• so/api.py: the API required for the web interface.

Run using Docker containers, recommended, make sure to set the required content in the .env file, or by using the option --env-file, for example to use the .env.local run:

sim-ops$ docker compose --env-file .env.local build
sim-ops$ docker compose --env-file .env.local up
# mcs is available from http://localhost:8080

The default credentials for the basic authentication are:

Username: sim
Password: ops

The default password for the admin section in the MCS is admin. In case you are running behind a reverse proxy, firewall, or any similar setting you may need to update the values described in .env.local to your needs.

A Python (version 3.11 recommended) needs to be available, the list of required packages is available from sim-ops-lib/requirements.txt file.

Note A MQTT service, e.g. Eclipse Mosquitto to run the scripts from a command line, check containers/mqtt/config/mosquitto.conf for an example configuration

Once an MQTT is running and reachable and all the requirements installed, run:

# setup environment variables (required for all scripts and npm)
sim-ops$ . scripts/export-env.sh .env.local

sim-ops$ cd sim-ops-lib

# run master script
sim-ops-lib$ python so-master.py

# run api
sim-ops-lib$ uvicorn so.api:app

sim-ops$ cd sim-ops-mcs

# run mcs
sim-ops-mcs$ npm run dev
# mcs is available from http://localhost:5173

Running Python lib tests:

$ cd sim-ops-lib
sim-ops-lib$ pytest

Nuno Carvalho, Peter Stöferle, Adrian Calleja, Vladimir Zelenevskiy, Rodrigo Laurinovics, Marcin Kovalevskij, Tim Oerther, Frederik Dall'Omo, Guilhem Honore and David Evans.

MCS UI theme based on HUD Vue by Sean Ngu.