README.md

RINEX-Cli

rinex-cli is a command line tool to post process RINEX and SP3 files.

Because RINEX and SP3 cover many applications, rinex-cli can be used for many applications. The most important being:

• File management
  • patching & reworking (for example: zero repair)
  • splitting: create a batch of files
  • transposing: to a single timescale, into a batch of timescales
  • reformat: export to CSV
• Analysis
  • generate high level reports
• Synthesis
  • generate RINEX (and soon SP3) from provided products
• Post processed navigation (ppp mode) because it integrates a complete PVT solver (on ppp feature only)
• CGGTTS solutions solver (ppp --cggtts mode) by combining the ppp and cggtts options

Static surveying of a geodetic marker:

Errors from the geodetic marker (CPP, Galileo E1+E5)

REFSYS resolved from PPP+CGGTTS (CPP, Galileo E1+E5)

Download the tool

You can download the latest version from the release portal.

Two version of the toolbox are automatically released:

• the smallest is published under the name rinex-cli and is only compatible with file management
• the heaviest allows all features, including the NAV PVT Solver and NAV CGGTTS solutions solver, and is published under the name rinex-cli-ppp

Install from Cargo

You can directly install the tool from Cargo with internet access:

cargo install rinex-cli

Build from sources

Download the version you are interested in:

git clone https://github.com/rtk-rs/rinex-cli

If you're interested in running one of the demos, you should enable all features and should download our example data set:

git clone --recurse-submodules https://github.com/rtk-rs/rinex-cli

To install in the default location, in this example activating all features, you should run this:

cargo install --all-features --path .
rinex-cli --version

which rinex-cli
${HOME}/.cargo/bin/rinex-cli

File formats & revisions

rinex-cli supports

• all formats & revisions supported by the RINEX parser
• all revisions supported by the SP3 parser

Summary:

Format	File name restrictions	Support
RINEX	➖	✔️
CRINEX	➖	✔️
gzip compressed RINEX	Name must end with .gz	✔️
gzip compressed CRINEX	Name must end with .gz	✔️
.Z compressed RINEX	Not supported	Not supported
DORIS RINEX	➖	🚧 Work in progress
gzip compressed DORIS	Name must end with .gz
.Z compressed DORIS	Not supported	Not supported
SP3	➖	✔️
gzip compressed SP3	Name must end with .gz	✔️
.Z compressed SP3	Not supported	Not supported
BINEX	➖	➖
UBX	➖	➖

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

Documentation

⚠️ All our examples and demos are expected to be execute at the base of this repo.

Once you have installed the tool, read the first few steps:

• File loading interface: learn how to load data into the toolbox
• The Preprocessor documentation will teach you how design a filter and deploy up to complex processing pipelines
• The Input / Output page summarizes the output you can generate, based on your input products

Then, continue your learning journey with:

• merge mode: to merge RINEX files together, which is particularly useful in Data production context & files management

• split mode: divide/split your input products at a specific point in time (Epoch)

• tbin (time) binning mode create a batch (file series) of RINEX of equal duration

• cbin (Constellation /Timescale) binning mode to split Multi-GNSS RINEX into individual Constellations, with possible Timescale re-expression

• diff mode: create a special RINEX=RINEX(A)-RINEX(B) by substracting two observation RINEX files together, per frequency and signal modulations

• filegen mode: generate output products (RINEX, SP3, CSV..) after a possible preprocessing pipeline. Use this to either reformat RINEX or perform a RINEX to CSV conversion.

Post Processed Positioning

Dive into the world of precise navigation:

• ppp opmode introduction: resolve PVT solutions
• ppp with special --cggtts option: resolve CGGTTS solutions

Examples

Many examples are provided for each mode individually.

Demos

Our Demo folder hosts many illustrations and high level applications

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)

Licensing

This application is part of the RTK-rs framework which is delivered under the Mozilla V2 Public license.