https://github.com/wojciech-graj/libsatcat
Satellite Catalogue (SATCAT) Parser
https://github.com/wojciech-graj/libsatcat
c celestrak parser parsing satcat satellite satellite-catalog satellite-catalogue
Last synced: about 2 months ago
JSON representation
Satellite Catalogue (SATCAT) Parser
- Host: GitHub
- URL: https://github.com/wojciech-graj/libsatcat
- Owner: wojciech-graj
- License: mit
- Created: 2022-06-06T18:56:20.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2025-04-08T06:46:27.000Z (3 months ago)
- Last Synced: 2025-04-08T07:38:04.040Z (3 months ago)
- Topics: c, celestrak, parser, parsing, satcat, satellite, satellite-catalog, satellite-catalogue
- Language: C
- Homepage:
- Size: 1.19 MB
- Stars: 7
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# libSATCAT
C Parser for the SATCAT Format.
ANSI C compliant and linkable with C++.
- SATCAT Format Documentation: https://www.celestrak.org/satcat/satcat-format.php
- SATCAT Data: https://www.celestrak.org/pub/satcat.txt
## Build
The demo program `test/test.c` can be compiled as follows:
```
cd test
gcc ../src/satcat.c ../src/satcat_code.c test.c -lm -ansi -I../src -o bin
./bin
```
Yielding the following output:
```
Parsed and Validated 52802 satellites in 0.066405s.
Found 51898 valid satellites and 904 invalid satellites.
First satellite:
Name: SL-1 R/B
Catalog Number: 1
Status: Decayed
Source: Commonwealth of Independent States (former USSR)
Launch Site: Tyuratam Missile and Space Center, Kazakhstan
```
## Usage
By default, strings within `struct SatCat` are **NOT** NULL-terminated, and are right-padded with spaces. To enable NULL-terminated strings, define `SC_CSTRING`.
The SATCAT library consists of the following files:
#### `satcat.c` + `satcat.h`
Parses and validates SATCAT strings.
- `sc_parse`: Parses a SATCAT-formatted string into a `struct SatCat`
- `sc_validate`: Validates if string is SATCAT-formatted
#### `satcat_code.c` + `satcat_code.h` [**Optional**]
Provides description strings for SATCAT Operational Status, Source, and Launch Site Codes.
- `SC_STR5_TO_CODE` macro: converts a 5-character code (either `char source[5]` or `char launch_site[5]` in `struct SatCat`) into a numeric contant of type `sc_code_t`, equal to one of `SCSRC_*` or `SCSITE_*`
- `sc_source_str` & `sc_launch_site_str`: takes a `sc_code_t` code and return a verbose description of the satellite's source or launch site.
- `sc_status_str`: takes an Operational Status Code (`char opstat` in `struct SatCat`, or `SCSTAT_*`), and returns a description of the satellite's status.
These files can be regenerated using `util/gen_code.py` if the SATCAT Operational Status, Source, and Launch Site Codes are expanded.