RINEX

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:
  • Position solver
  • CGGTTS solver

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

• GNSS definitions, 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.