Skip to content

Latest commit

 

History

History
175 lines (137 loc) · 10.9 KB

README.md

File metadata and controls

175 lines (137 loc) · 10.9 KB
Raw

RINEX

Rust Rust crates.io crates.io

minimum rustc: 1.64 License License

Rust tool suites to parse, analyze and process RINEX and GNSS data.

The Wiki pages contain all documentation and example applications of this toolbox.

Use Github Issues to report bugs and other malfunctions.
You can also open a Discussion or leave us a message on Discord.

Advantages 🚀

  • Fast
  • Render High level Geodetic survey reports
  • Resolve PPP solutions in a few seconds
  • Open sources: read and access all the code!
  • Self sustained examples and tutorials: data hosted within this repo
  • All modern GNSS constellations, codes and signals
    • Surveying with GPS, Galileo, BeiDou and QZSS
  • Time scales: GPST, QZSST, BDT, GST, UTC, TAI
  • Efficient seamless compression and decompression
  • RINEX V4 full support
  • All RINEX formats supported (see following table)
  • High Precision Clock RINEX products (for PPP)
  • High Precision Orbital SP3 for PPP
  • DORIS (special RINEX)
  • Many pre-processing algorithms including Filter Designer
  • Several file operations: merging, splitting, time binning (batch)
  • Post processing:

Disadvantages ⚠️

  • BINEX support is currently work in progress
  • Navigation is currently not feasible with Glonass and IRNSS
  • Differential navigation (SBAS, DGNSS or RTK) is not support yet
  • Our applications do not accept proprietary formats like Septentrio for example
  • File production might lack some features, mostly because we're currently focused on data processing

Repository

  • rinex is the core library
  • rinex-cli is a command line application to process RINEX, SP3 and soon Ublox, and dedicated to typical GNSS post processing.
    It is growing as some sort of Anubis/Teqc/Glab combination. No GUI currently available, this will be developed later.
    It integrates a PVT and CGGTTS solutions solver.
    The application is auto-generated for a few architectures, you can directly download it from Github.com
  • tutorials is a superset of scripts (Linux/MacOS compatible) to get started quickly. The examples span pretty much everything our applications allow.
  • sp3 High Precision Orbits (by IGS)
  • binex BINEX Encoding and Decoding library
  • 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 to generate RINEX files from Ublox receivers.
    This application is currently work in progress
  • tools are utility scripts and development tools
  • logs is dedicated to store session logs, if you work within this workspace directly.

Relevant Ecosystem

  • IGS Network: browse and monitor any IGS station status
  • Nyx-space: Navigation and Orbital calculations in Rust
  • Hifitime: Precise Time and Timescale support in Rust
  • CGGTTS: Common View Time Transfer file format, in Rust
  • Geo: Geospatial primitives and algorithms, in Rust
  • RTK-RS: Precise Positioning (calculations) in Rust

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

RINEX-Cli

rinex-cli is our main application, build it without any features to obtain its smallest form. The available options are:

  • kml: allows formatting PPP solutions as KML tracks
  • gpx: allows formatting PPP solutions as GPX tracks
  • cggtts: enable CGGTTS solutions solver

Formats & revisions

The core library supports parsing RINEX V4.0, that includes RINEX V4 Navigation files.
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 Content Record Iteration Timescale
Navigation (NAV) ✔️ 🚧 ✔️ 📈 Ephemerides, Ionosphere models Epoch SV System time broadcasting this message
Observation (OBS) ✔️ ✔️ ✔️ 📈 Phase, Pseudo Range, Doppler, SSI Epoch GNSS (any)
CRINEX (Compressed OBS) ✔️ RNX2CRX1 ✔️ RNX2CRX3 🚧 ✔️ 📈 Phase, Pseudo Range, Doppler, SSI Epoch GNSS (any)
Meteorological data (MET) ✔️ ✔️ ✔️ 📈 Meteo sensors data (Temperature, Moisture..) Epoch UTC
Clocks (CLK) ✔️ 🚧 ✔️ 📈 Precise SV and Reference Clock states Epoch GNSS (any)
Antenna (ATX) ✔️ 🚧 🚧 Precise RX/SV Antenna calibration antex::Antenna ➖
Ionosphere Maps (IONEX) ✔️ 🚧 ✔️ 📈 Ionosphere Electron density Epoch UTC
DORIS RINEX ✔️ 🚧 ✔️ Temperature, Moisture, Pseudo Range and Phase observations Epoch TAI
SINEX (SNX) 🚧 🚧 ➖ SINEX are special RINEX, they are managed by a dedicated core library Epoch ❓
Troposphere (TRO) 🚧 🚧 ❓ Troposphere modeling Epoch ❓
Bias (BIA) ✔️ 🚧 ❓ Bias estimates, like DCB.. Epoch ❓

✔️ means all revisions supported
🚧 : means Work in Progress

CLI : possibility to load this format in the apps.
CLI + 📈 : possibility to project or extract and plot this format.

Other formats

RINEX-Cli accepts more than RINEX data.

Type Parser Writer CLI Content Record Iteration Timescale
SP3 ✔️ 🚧 Work in progress ✔️ 📈 High precision SV orbital state Epoch GNSS (any)

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
.Z compressed RINEX Not supported Not supported
DORIS RINEX ➖ 🚧 Work in progress
gzip compressed DORIS Name must end with .gz --flate2 feature must be enabled
.Z compressed DORIS Not supported Not supported
SP3 ➖ ✔️
gzip compressed SP3 Name must end with .gz --flate2 feature must be enabled
.Z compressed SP3 Not supported Not supported
BINEX ➖ ➖ We do not support proprietary formats
UBX ➖ 🚧 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.