12 stable releases

1.4.0 Feb 20, 2025
1.3.1 Sep 4, 2024
1.2.4 Apr 27, 2024
1.2.1 Feb 25, 2024
0.0.1 Sep 26, 2022

#19 in Geospatial

Download history 4/week @ 2024-12-08 218/week @ 2025-02-16 26/week @ 2025-02-23 6/week @ 2025-03-02

250 downloads per month

MPL-2.0 license

19KB
159 lines

RNX2CRX

Rust Rust crates.io

License

rnx2crx is a small command line utility to compress your RINEX files to CRINEX (Compact RINEX) files. It is modern replacement of the historical tool.

This tool is based on the GeoRust/RINEX parser.

Download the tool

You can download the latest version from the release portal

Install from Cargo

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

cargo install rnx2crx

Build from sources

Download the version you are interested in:

git clone https://github.com/rtk-rs/rnx2crx

And build it using cargo:

cargo build --all-features -r

Getting started

The tool expects one input file that needs to be a valid Observation RINEX file:

rnx2crx AJAC3550.21O
Compressed AJAC3550.21D

By default the tool lets you know what the output file is (stdout).

If that bothers you, simply use -q (quiet option):

rnx2crx -q AJAC3550.21O

RINEX Revision

The tool supports RINEX V2, V3 and V4. It will preserve the input format by default, so standardized V3 filenames will produce a standardized file name:

rnx2crx ACOR00ESP_R_20213550000_01D_30S_MO.rnx
Compressed ACOR00ESP_R_20213550000_01D_30S_MO.crx

We have one option that let's you convert a V3 format to V2 directly:

rnx2crx -s ACOR00ESP_R_20213550000_01D_30S_MO.rnx
Compressed ACOR3550.21D

Custom output name

You can specify a custom output location with --prefix [directory]:

rnx2crx --prefix /tmp -s ACOR00ESP_R_20213550000_01D_30S_MO.rnx
Compressed /tmp/ACOR3550.21D

You can specify a filename yourself with -o [filename], which overrides any filename determination logic:

rnx2crx -o TEST.txt ACOR00ESP_R_20213550000_01D_30S_MO.rnx
Compressed TEST.txt

Gzip files

The tool supports gzip compressed CRINEX files natively, but can only generate "plain" CRINEX at the moment:

crx2rnx ESBC00DNK_R_20201770000_01D_30S_MO.crx.gz
Compressed ESBC00DNK_R_20201770000_01D_30S_MO.crx

Compression customizations

We support several option to optimize your compression scenario:

  1. -d YYYY-MM-DD let's you customize the CRINEX compression date. When -d is not specified, we use the system time:
rnx2crx -q -d 2000-01-01 ESBC00DNK_R_20201770000_01D_30S_MO.rnx.gz
  1. -t HH:MM:SS let's you customize the CRINEX compression time during that date. When -t is not specified, we use the system time.
crx2rnx -q -d 2000-01-01 -t 01:02:03 ESBC00DNK_R_20201770000_01D_30S_MO.crx.gz

When Time is specified without Date, we use the date retrieved from system time and replace the time during that day.

Licensing

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

Dependencies

~10–14MB
~258K SLoC