Rinex File Nominal Renaming Support¶
RINEX File Nominal Renaming Support (2, 3 or 4)¶
A fast file name conversion of RINEX-3 or 4 files with RINEX-2 style file names to RINEX-3 or 4 style file names is supported. It can be used without reading the input files, using all necessary information from the RINEX-2 style file name and from information provided via command line parameters (useful for compressed files).
For uncompressed observation files, including hatanaka compressed files, some required information can also be derived from the file header.
The supported RINEX-2 style file names are:
| Name | Example | Description |
|---|---|---|
| nnnnddd0.yyt | pots1230.15o | daily obs. file |
| pots1230.15d | daily obs. file (hatanaka compressed) | |
| nnnnddd[a-z].yyt. | pots123a.15n | hourly nav. file |
| nnnnddd[a-z]mm.yyt | pots123x15.15m | sub-hourly met. file |
The renaming support can be invoked via the -nomren23 (nominal rename) command line parameter. The output is the RINEX-3 file name (printed to STDOUT) which can be used for renaming operations. The input can be a full path, the output is the file name only.
gfzrnx -finp pots1230.15n -nomren23
POTS00XXX_R_20151230000_01D_GN.rnx
gfzrnx -finp /tmp/data/pots1230.15n -nomren23
POTS00XXX_R_20151230000_01D_GN.rnx
Using -nomren23 command line parameter the following additional information s,mr,iso has to be provided via command line because they are not available from the RINEX-2 style file name or RINEX file header.
| Information | Values | Default | |
|---|---|---|---|
| s | data source | R or S | R |
| mr | marker/receiver number | mr | 00 |
| iso | iso country code | ISO | XXX |
gfzrnx -finp pots1230.15n -nomren23 DEU,12
POTS12DEU_R_20151230000_01D_GN.rnx
gfzrnx -finp pots1230.15g -nomren23 S,DEU,12
POTS12DEU_S_20151230000_01D_RN.rnx
gfzrnx -finp pots1230.15m -nomren23 DEU
POTS00DEU_R_20151230000_01D_00U_MM.rnx
Via the -4to9 command line parameter, one can provide multiple site identifier information from a provided configuration file. See the Automatic Output File Naming section for details on -4to9.
gfzrnx -finp pots1230.15o -nomren23 -4to9 four2nine.conf
gfzrnx -finp tash1230.15o -nomren23 -4to9 four2nine.conf
There are default mappings from the extension letter to the RINEX-3 data type identifier:
| Extension | Data Type |
|---|---|
| o | _MO.rnx |
| d | _MO.crx |
| n | _GN.rnx |
| g | _RN.rnx |
| l | _EN.rnx |
| c | _CN.rnx |
| q | _JN.rnx |
| j | _JN.rnx |
| h | _SN.rnx |
| p | _MN.rnx |
| m | _MM.rnx |
All other extension letters end up with _XX.rnx.
To support additional extensions, these default mappings can be overwritten or extended via the -extsysdt23 command line parameter, providing a comma-separated list of extension letter-colon-data type pairs.
Meteo- and Navigation files don't have additional information which can be derived from the file header.
For observation files, the data frequency and satellite system can be derived from the "INTERVAL" and
"SYS / # / OBS TYPES" RINEX header records. For compressed files, this information can be provided via the command line parameters -smp and -satsys.
Here are some examples, including hatanaka compressed files:
gfzrnx -finp pots1230.15o.gz -nomren23 DEU -smp 30 -satsys G
POTS00DEU_R_20151230000_01D_30S_GO.rnx.gz
gfzrnx -finp pots1230.15o.gz -nomren23 DEU -smp 30 -satsys GR
POTS00DEU_R_20151230000_01D_30S_MO.rnx.gz
gfzrnx -finp pots1230.15d.gz -nomren23 DEU -smp 30 -satsys GR
POTS00DEU_R_20151230000_01D_30S_MO.crx.gz
gfzrnx -finp pots1230.15d.gz -nomren23 DEU
POTS00DEU_R_20151230000_01D_00U_MO.crx.gz
Using the following RINEX-3 or 4 header information:
E 6 C1X C5X L1X L5X S1X S5X SYS / # / OBS TYPES
G 8 C1C C1P C2C C2P L1P L2P S1P S2P SYS / # / OBS TYPES
R 8 C1C C1P C2C C2P L1P L2P S1P S2P SYS / # / OBS TYPES
10.000 INTERVAL
results in the following file names:
gfzrnx -finp pots1230.15o -nomren23 DEU
POTS00DEU_R_20151230000_01D_10S_MO.rnx
gfzrnx -finp pots1230.15d -nomren23 DEU
POTS00DEU_R_20151230000_01D_10S_MO.crx
A single satellite system file with the following information:
leads to the file names:
gfzrnx -finp pots1230.15o -nomren23 DEU
POTS00DEU_R_20151230000_01D_05S_EO.rnx
gfzrnx -finp pots1230.15d -nomren23 DEU
POTS00DEU_R_20151230000_01D_05S_EO.crx
Sub-daily files need the additional duration information if it is not 15 minutes (std.). It can be given via the -d, -duration command line parameter.
gfzrnx -finp pots123b30.15o -nomren23 DEU
POTS00DEU_R_20151230130_15m_01S_MO.rnx
gfzrnx -finp pots1230c35.15o.gz -nomren23 DEU -d 300 -smp 5
POTS00DEU_R_20151230235_05M_05S_MO.rnx.gz
Remark
Information provided via the command line has priority.