Skip to content

file merging

Jump to bottom
Guillaume W. Bres edited this page May 26, 2024 · 6 revisions

File Merging

RINEXCLI supports a -m flag to let you "merge" several files into a single one. The result is generated in the Workspace.

Observation RINEX example

When working with Observation RINEX, you should always work with data that were sampled by the same station (identical GNSS receiver).
Otherwise, the operation is incorrect, it will trigger weird behavior in the generate filenames, etc..

The only almost realistic scenario we currently host in the repo, is the following example.
With this command, we specify that VLNS0010.22O and VLNS0630.22O are to be merged together:

rinex-cli \
    -f test_resources/OBS/V3/VLNS0010.22O \
    -m test_resources/OBS/V3/VLNS0630.22O

[INFO rinex_cli] "WORKSPACE/VLNS0010/VLNS0630.22O" has been generated

The tool indicates which file has been generated and where it is located.

If we look into the results, we can see that both files were merged in chronological order.
This example is somewhat unrealistic, due to the 3 month data gap between them.

CRINEX case

When working with CRINEX, the file format is preserved:

rinex-cli \
  -f test_resources/CRNX/V3/ACOR00ESP_R_20213550000_01D_30S_MO.crx \
  -m test_resources/CRNX/V3/BME100HUN_R_20213550000_01D_30S_MO.crx
[2024-05-26T09:21:58Z INFO  rinex_cli::fops] 
   "WORKSPACE/ACOR00ESP_R_20213550000_01D_30S_MO/BME100HUN_R_20213550000_01D_30S_MO.crx" has been generated

Compressed files

File compression is also preserved by all our file operations:

rinex-cli \
    -f test_resources/CRNX/V3/ESBC00DNK_R_20201770000_01D_30S_MO.crx.gz \
    -m test_resources/CRNX/V3/MOJN00DNK_R_20201770000_01D_30S_MO.crx.gz
[2024-05-26T09:21:28Z INFO  rinex_cli::fops] 
   "WORKSPACE/ESBC00DNK_R_20201770000_01D_30S_MO/MOJN00DNK_R_20201770000_01D_30S_MO.crx.gz" has been generated

Preprocess then merge

Like any other command line, File Merging allows preprocessing prior perform the actual operation.

If we take the previous Observation RINEX (VLNSXXXX) example, this context describes both Glonass and GPS constellations. We can use the following command to only merge GPS constellation, from both files:

rinex-cli \
    -f test_resources/OBS/V3/VLNS0010.22O \
    -P GPS \
    -m test_resources/OBS/V3/VLNS0630.22O

[INFO rinex_cli] "WORKSPACE/VLNS0010/VLNS0630.22O" has been generated

Now if we look into the actual file content, we can see that Glonass vehicles have been dropped.

As always, the preprocessing (like -f) options are expected first and must come prior the actual opmode.
Any other Preprocessor option may apply, especially resampling and time reframing.

Other RINEX files

More RINEX examples will be provided in the future.

SP3 files

SP3 file generation is not supported yet

Merging several files at once

The toolbox does not support merging more than two files at once, or at least it has not been tested yet.
Until then, you need to work in paired groups of files.

Filenaming conventions

This toolbox can operate on files that do not follow naming conventions, and can also help generate files that do follow conventions. Read more on this topic, right here.

Next step

Read about other types of file operations we support

Clone this wiki locally