jbangelo / rinex

:artificial_satellite: :rocket: RINEX data in Rust: compression, analysis, processing

RINEX

Rust tool suites to parse, analyze and process RINEX Data.

• rinex is the core library

• rinex-cli is a command line application based on the core library.
  It can be used to process RINEX files and perform operations similar to teqc.
  The application is auto-generated for a few architectures, download it from the release portal

• rnx2crx is a RINEX compression program

• crx2rnx is a CRINEX decompression program (Compact RINEX to RINEX)

• sinex SNX dedicated core library

• ublox-rnx is an application that connects to a Ublox receiver and generates RINEX data quickly & easily.
  It is the combination of the ublox and rinex crates.

By default, all timestamps are in UTC with leap seconds correctly managed.

This RINEX toolsuite is part of the GeoRust community, and we aim towards advanced geodesic and ionospheric analysis.

RINEX files

Type	Parser	Writer	CLI	UBX	Notes
Navigation (NAV)	✔️	Ephemeris 🚧 V4 🚧	✔️ 📈	🚧	Epoch iteration
Observation (OBS)	✔️	✔️	✔️ 📈	🚧	Epoch iteration
CRINEX (Compressed OBS)	✔️	RNX2CRX1 ✔️ RNX2CRX3 🚧	✔️ 📈	🚧	Epoch iteration
Meteorological data (MET)	✔️	✔️	✔️ 📈	🚧	Epoch iteration
Clocks (CLK)	✔️	🚧	🚧	🚧	Epoch iteration
Antenna (ATX)	✔️	🚧	🚧	🚧	Sorted by antex::Antenna
Ionosphere Maps (IONEX)	✔️	🚧	✔️ 📈	🚧	Epoch iteration
SINEX (SNX)	🚧	🚧	➖	🚧	SINEX are special RINEX, they are managed by a dedicated core library
Troposphere (TRO)	🚧	🚧	❓	🚧	Troposphere are one possible SINEX declination
Bias (BIA)	✔️	🚧	❓	🚧	Bias solutions are one possible SINEX declination

✔️ means all revisions supported
🚧 under development
CLI + 📈 means record analysis is supported by the CLI, README

File formats

Format	File name restrictions	Support
RINEX	➖	✔️
CRINEX	➖	✔️
gzip compressed RINEX	Name must end with .gz	--flate2 feature must be enabled
gzip compressed CRINEX	Name must end with .gz	--flate2 feature must be enabled

➖ No restrictions: file names do not have to follow naming conventions.

Known weaknesses ⚠️

• Glonass Time Scale is not known to this day. We cannot parse and apply system time corrections from other time scales into the glonass time scale.

Benchmarking

Test	Results
textdiff/decompression/epoch	979.55 ns
textdiff/decompression/flag	147.16 ns
numdiff/decompression/small	191.86 ns
numdiff/decompression/big	1.0973 µs
parsing/OBSv2/zegv0010.21o	951.40 µs
parsing/OBSv3/ACOR00ESP	4.1139 ms
processing/esbc00dnkr2021/mask:gnss	352.81 ms
processing/esbc00dnkr2021/mask:obs	438.73 ms
processing/esbc00dnkr2021/mask:sv	341.42 ms
processing/esbc00dnkr2021/smooth:hatch:l1c,l2c	502.90 ms

Contributions

Contributions are welcomed, do not hesitate to open new issues and submit Pull Requests through Github.

If you want to take part in active developments, check out our contribution guidelines and hints to navigate this library quicker.