celestia-galmon/README.md

134 lines
3.1 KiB
Markdown

# Spacecruft Celestia Galmon
`celestia-galmon` is a set of scripts to retrieve Galmon GNSS
data and feed it to Celestia for visualization.
The Galmon GNSS Monitoring Project's
*"goals are to monitor the major Global Navigation Satellite Systems,
including GPS, GLONASS, Galileo and BeiDou, but also Space Base
Augmentation Systems like WAAS, EGNOS and GAGAN. Galmon is an open
source & open data project with a community of over 30 station operators
running more than 50 receivers."*
Celestia is a *"real-time space simulation that lets you experience our
universe in three dimensions".*
# Screenshots
Screenshots of running Celestia with GNSS satellites and
Galmon Observers, generated by `celestia-galmon-observers`.
The goal is to have something like the screenshots below,
including more Galmon data.
*Celestia with Galmon Observer locations and GNSS satellites.*
![celestia-galmon-observers](pics/celestia-galmon-observers.png)
# Install
Install thusly.
Quick & dirty if you want to use pre-generated file:
```
sudo mkdir -p /usr/share/celestia/extras-standard/galmon
# Use your username for debian
sudo chown debian:debian /usr/share/celestia/extras-standard/galmon
wget \
-O /usr/share/celestia/extras-standard/galmon/galmon-observers.ssc \
https://spacecruft.org/spacecruft/celestia-galmon/raw/branch/main/extras/galmon/galmon-observers.ssc
# Then (re)start Celestia.
```
If you want to generate your own files:
```
# Quick & dirty Python setup
sudo apt update
sudo apt install python3-pip
pip install --user --upgrade pip
pip install --user -r requirements.txt
```
# Run
Run thusly.
Retrieve Galmon observers, output SSC format for Celestia:
```
./celestia-galmon-observers
# Save file for Celestia:
./celestia-galmon-observers > \
/usr/share/celestia/extras-standard/galmon/galmon-observers.ssc
```
# Galmon Data
Galmon data can be retrieved from the website in JSON format.
Available URLs:
Global, overview of data collection:
* https://galmon.eu/global.json
Service Vehicles (Satellites):
* https://galmon.eu/svs.json
Almanac. Can also be queried with `t` time flag:
* https://galmon.eu/almanac.json
* https://galmon.eu/almanac.json?t=1653332121
Observers (Ground Stations):
* https://galmon.eu/observers.json
Coverage:
* https://galmon.eu/cov.json
* https://galmon.eu/cov.json?gps=0&galileo=1&beidou=0&glonass=0
SBAS:
* https://galmon.eu/sbas.json
# See Also
Refs.
## Spacecruft
Spacecruft:
* https://spacecruft.org/spacecruft/celestia-gnss
* https://spacecruft.org/spacecruft/gnss-earth
* https://spacecruft.org/spacecruft/celestia
## Celestia
Upstream Celestia:
* https://celestia.space/
* https://github.com/CelestiaProject/Celestia
## Galmon
Galmon main page:
* https://galmon.eu
Galmon web map:
* https://galmon.eu/geo/
Source code:
* https://github.com/berthubert/galmon
Observers:
* https://berthub.eu/articles/posts/galmon-project/
# Status
Alpha, under development.
Appears to work for Galmon observer locations.
# License / Copyright
Unofficial project, not part of Celestia or Galmon.
Upstream sources under their respective copyrights.
Copyright (C) 2022 Jeff Moe.
License: GPLv2 or any later version.