An application for fetching the latest relevant satellite metadata and telemetry from SatNOGSs' and Space-Tracks' API's for immediate digestion by the Portland State Aerospace Society's UniClOGS server and respective services.
$ pip install uniclogs-cossi
Certain environment variables are required depending on which features are needed.
SpaceTrack:
These are required in order to fetch the latest TLE data.
(See: Space-Track's faq for setting up authentication)
SPACETRACK_USERNAMESPACETRACK_PASSWORD
SatNOGS:
These are required in order to fetch satellite metadata and telemetry.
(See: SatNOGS's api page for setting up authentication)
SATNOGS_DB_TOKEN
COSMOS DART:
These are required in order to submit data to COSMOS ground-station services, such as DART.
DART_HOSTDART_PORTDART_DBDART_USERNAMEDART_PASSWORD
$ uniclogs-cossi
(Help and usage)
$ uniclogs-cossi --help
In order to use COSI, it requires a known NORAD ID of an active satellite that is at least registered in SatNOGS if you wish to grab satellite metadata and telemetry and Space-Track if you wish to grab a satellite's latest TLE's.
Get Latest TLE for Bobcat-1: (NORAD ID: 46922)
$ uniclogs-cossi --tle 46922
Get Satellite Metadata and telemetry for Bobcat-1:
$ uniclogs-cossi --satellite-metadata --telemetry 46922
Get Telemetry for OreFlat0 in SatNOGS DB Dev and decode it using the OreFlat0 decoder:
$ uniclogs-cossi --telemetry --decode --satnogs-dev 99910
Check out our Read The Docs pages for more info on the applications and the various systems it interacts with.
$ pip install -e .[dev]
(Note: the -e flag creates a symbolic-link to your local development version. Set it once, and forget it)
$ make -C docs clean html
(Note: documentation is configured to auto-build with ReadTheDocs on every push to master)