2 releases

0.1.1 Sep 14, 2023
0.1.0 Sep 7, 2023

#7 in #rinex

Download history 28/week @ 2023-12-22 16/week @ 2023-12-29 4/week @ 2024-01-05 7/week @ 2024-02-16 25/week @ 2024-02-23 86/week @ 2024-03-01 18/week @ 2024-03-08 7/week @ 2024-03-15 10/week @ 2024-03-22 20/week @ 2024-03-29

56 downloads per month
Used in 3 crates (2 directly)

MIT/Apache

3KB

RINEX

Rust crates.io crates.io

minimum rustc: 1.64 License License

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

The Wiki pages is the main documentation portal. It contains several examples spanning different GNSS applications.

If you have any question or experience any problems, feel free to open an issue on Github.
You can also contact us on our Discord channel

Advantages 🚀

  • Fast 🦀
  • Open sources
  • Seamless Hatanaka compression and decompression
  • Seamless Gzip decompression with flate2 build option
  • RINEX V4 full support
  • Meteo RINEX full support
  • IONEX 2D support. Partial IONEX 3D support.
  • Partial ANTEX support
  • Full support of High Precision Clock RINEX products
  • Full support of SP3 High precision orbit products
  • Several pre processing algorithms:
  • Several post processing operations
  • All modern GNSS constellations, codes and signals
  • Time scales: GPST, BDT, GST, UTC
  • SBAS support
  • High precision phase data (micro cycle precision) theoretically supported but not tested yet
  • Quality Check (QC): file quality and statistical analysis to help precise positioning (historical teqc function).

Disadvantages ⚠️

  • QZNSST is represented as GPST at the moment.
  • We're waiting for Hifitime V4 to support GLONASST and IRNSST.
    Until then, orbital calculations on these systems are not feasible.
    In other term, positioning is not feasible and you're limited to basic analysis.
  • These tools are oriented towards the latest revisions of the RINEX format. RINEX4 is out and we already support it. Some minor features in the RINEX2 or 3 revisions may not be supported.
  • Our command line applications do not accept BINEX or other proprietary formats
  • File production is not fully concluded to this day. We're currently focused on RINEX post processing rather than RINEX data production. Do not hesitate to fork and submit your improvements

Repository

  • rinex is the core library

  • rinex-cli : an application dedicated to RINEX post processing. It supports some of teqc operations. It integrates a position solver and can format CGGTTS tracks for clock comparison. The application is auto-generated for a few architectures, download it from the release portal

  • sp3 High Precision Orbits (by IGS)

  • rnx2crx is a RINEX compressor (RINEX to Compact RINEX)

  • crx2rnx is a CRINEX decompresor (Compact RINEX to RINEX)

  • rinex-qc is a library dedicated to RINEX files analysis

  • qc-traits declares Traits that are shared between rinex and rinex-qc

  • sinex SNX dedicated core library

  • ublox-rnx is an application intended to generate RINEX Data from raw uBlox GNSS receiver frames. This application is work in progress at the moment.

Other tools and relevant Ecosystems

  • Nyx-space: Navigation, Orbital attitude
  • Hifitime: Precise Timing, Timescales, ...
  • CGGTTS: Common View Time Transfer

Citation and referencing

If you need to reference this work, please use the following model:

GeoRust RINEX Team (2023), RINEX: analysis and processing (Apache-2/MIT), https://georust.org

Formats & revisions

The core library supports parsing RINEX V4.00 and the current behavior is to fail on higher revisions. NAV V4 is correctly supported as described in the following table.

We support the latest revisions for both IONEX and Clock RINEX.

We support the latest (rev D) SP3 format.

RINEX formats & applications

Type Parser Writer CLI UBX Content Record browsing
Navigation (NAV) ✔️ Ephemeris 🚧 V4 🚧 ✔️ 📈 🚧 Orbit parameters, Ionospheric models.. Epoch iteration
Observation (OBS) ✔️ ✔️ ✔️ 📈 🚧 Phase, Pseudo Range, Doppler, SSI Epoch iteration
CRINEX (Compressed OBS) ✔️ RNX2CRX1 ✔️ RNX2CRX3 🚧 ✔️ 📈 🚧 Phase, Pseudo Range, Doppler, SSI Epoch iteration
Meteorological data (MET) ✔️ ✔️ ✔️ 📈 🚧 Meteo sensors data (Temperature, Moisture..) Epoch iteration
Clocks (CLK) ✔️ 🚧 🚧 🚧 Precise Clock product Epoch iteration
Antenna (ATX) ✔️ 🚧 🚧 🚧 Antenna calibration data Sorted by antex::Antenna
Ionosphere Maps (IONEX) ✔️ 🚧 ✔️ 📈 🚧 Ionosphere Electron density Epoch iteration
SINEX (SNX) 🚧 🚧 🚧 SINEX are special RINEX, they are managed by a dedicated core library Epoch iteration
Troposphere (TRO) 🚧 🚧 🚧 Troposphere modeling Epoch iteration
Bias (BIA) ✔️ 🚧 🚧 Bias estimates, like DCB.. Epoch iteration

✔️ means all revisions supported
🚧 : Work in Progress
CLI + 📈 means the cli app provides one or several visualizations

RINEX-Cli accepts more than RINEX input, for example SP3 (high precision orbits) are accepted.
Read how to load your GNSS context in our Wiki.

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
SP3 ✔️
gzip compressed SP3 Name must end with .gz --flate2 feature must be enabled
BINEX ➖ We do not support proprietary formats
UBX 🚧 This is work in progress

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

Special Thanks

These tools would not exist without the great libraries written by C. Rabotin, check out his work.

Some features would not exist without the invaluable help of J. Lesouple, through our countless discussions. Check out his PhD manuscript (french)

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.


lib.rs:

Specific traits to generate RINEX quality reports.

Dependencies

~63KB