Skip to content

Commit 03849c7

Browse files
valgurvalgur
committed
update RNXCMP to 4.1.0
1 parent c658887 commit 03849c7

16 files changed

+704
-477
lines changed

‎hatanaka/__init__.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@
22
from .hatanaka import *
33

44
__version__ = '2.6.0'
5-
rnxcmp_version = '4.0.8'
5+
rnxcmp_version = '4.1.0'

‎rnxcmp/docs/CHANGES.md

+28
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,33 @@
11
Change history of the RNXCMP software
22

3+
2022-01-06
4+
- Version # of crx2rnx.c, which was not updated. is corrected.
5+
all binaries are replaced with re-compiled ones.
6+
7+
2021-12-24
8+
- Version 4.1.0 released.
9+
- RINEX ver.4.xx files are accepted as inputs. The correspondence between
10+
versions of RINEX format and those of Compact RINEX format is as follows:
11+
RINEX Compact RINEX
12+
ver. 2.xx <---> ver.1.0
13+
ver. 3.xx <---> ver.3.0
14+
ver. 4.xx <---> ver.3.0
15+
- The front-end tools RNX2CRZ.bat and CRZ2RNX.bat for Windows are replaced
16+
with completely new ones. Long filenames or old short filenames of RINEX
17+
conventions are assumed for input RINEX and Compacct RINEX files and
18+
output RINEX files, accordingly. For old short file names of compressed
19+
files, NOT VMS/DOS types, but only UNIX types can be handled.
20+
The old DOS tools, that can handle short file names of compressed files
21+
of VMS/DOS types, are obsolete and not provided any more.
22+
- The default command is now "gzip" instead of "compress" for the text
23+
compression in the front-end tools.
24+
- Following bugs of RNX2CRX are fixed:
25+
+ Error in case the number of special records exceeds 99
26+
in RINEX ver.2 files.
27+
+ Error in case clock offset is padded with spaces in RINEX ver. 3 or 4 files.
28+
+ Error in case a bad GNSS type is detected even if option -s
29+
is specified with RNX2CRX.
30+
331
2019-07-16
432
- Version 4.0.8 released.
533
- Correction of a bug in rnx2crx.c which eliminates clock

‎rnxcmp/docs/LICENSE.txt

+1-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
RNXCMP SOFTWARE
2-
Copyright (c) 2007, 2009, 2012, 2014, 2016, 2019 Geospatial
3-
Information Authority of Japan All rights reserved.
2+
Copyright (c) 2007 Geospatial Information Authority of Japan All rights reserved.
43

54
This is the license document of the RNXCMP software (Technical
65
Reports of the Geospatial Information Authority of Japan H1-No.6 "The

‎rnxcmp/docs/README.txt

+6-6
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
**********************************************************************
2-
* RNX2CRX/CRX2RNX (Ver.4.0.8) *
3-
* RINEX file compression programs for RINEX version 2/3 files. *
2+
* RNX2CRX/CRX2RNX (Ver.4.1.0) *
3+
* RINEX file compression programs for RINEX version 2/3/4 files. *
44
* *
55
* Geospatial Information Authority of Japan *
66
* Kitasato-1, Tsukuba, Ibaraki, 305-0811 Japan *
77
**********************************************************************
88
==== Contents of the directory ====
9-
RNXCMP_4.0.8_src.tar.gz tar (gzip) package of source codes, front-end-tools
9+
RNXCMP_4.1.0_src.tar.gz tar (gzip) package of source codes, front-end-tools
1010
and documents. (for users who need to build binaries
1111
for their own platform)
12-
RNXCMP_4.0.8_[OS type].tar.gz tar (gzip) package of binaries and
12+
RNXCMP_4.1.0_[OS type].tar.gz tar (gzip) package of binaries and
1313
front-end-tools (C-shell scripts) for
1414
several UNIX platforms with documents.
15-
RNXCMP_4.0.8_Windows.tar tar package of binaries and front-end-tools
15+
RNXCMP_4.1.0_Windows.tar tar package of binaries and front-end-tools
1616
(batch scripts) for Windows OS with documents.
17-
RNXCMP_4.0.8_Windows.zip the same as the above but in zip format.
17+
RNXCMP_4.1.0_Windows.zip the same as the above but in zip format.
1818
LICENSE.txt License terms. (also included in each of the above packages)
1919
CHANGES.txt Change history of the software (also included in each of the
2020
above packages)

‎rnxcmp/docs/RNXCMP.txt

+85-76
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,18 @@
11
**********************************************************************
22
* RNX2CRX/CRX2RNX *
33
* RINEX file compression programs. *
4-
* for RINEX version 2/3 files *
5-
* (Ver.4.0.8) *
4+
* for RINEX version 2/3/4 files *
5+
* (Ver.4.1.0) *
66
* *
77
* Yuki Hatanaka, *
88
* Geospatial Information Authority of Japan *
99
* Kitasato-1, Tsukuba, Ibaraki, 305-0811 Japan *
1010
* e-mail: [email protected] *
1111
* *
12-
* 2007/06/08 *
13-
* (comment on file naming convention: 2009/06/31) *
14-
* (Update URLs and description of file name conventions: 2019/07/12) *
12+
* 2007-06-08 *
13+
* (2009-06-31: comment on file naming convention) *
14+
* (2019-07-12: Update URLs and description of file name conventions) *
15+
* (2021-12-22: Handling of RINEX ver. 4 is added) *
1516
* *
1617
**********************************************************************
1718

@@ -25,14 +26,18 @@ From the version 4.0.0, these programs are able to handle not only the
2526
RINEX format version 2.xx (and the corresponding Compact RINEX format
2627
version 1.0), but also the RINEX format version 3.xx (and the corresponding
2728
Compact RINEX format version 3.0):
29+
From the version 4.1.0, The programs are able to handle RINEX format version 4.xx, too.
2830

2931
[compression]
3032
RINEX format version 2.xx --> (RNX2CRX) --> Compact RINEX format version 1.0
3133
RINEX format version 3.xx --> (RNX2CRX) --> Compact RINEX format version 3.0
34+
RINEX format version 4.xx --> (RNX2CRX) --> Compact RINEX format version 3.0
3235

3336
[restoration]
3437
Compact RINEX format version 1.0 --> (CRX2RNX) --> RINEX format version 2.xx
35-
Compact RINEX format version 3.0 --> (CRX2RNX) --> RINEX format version 3.xx
38+
Compact RINEX format version 3.0 --> (CRX2RNX) --> RINEX format version 3.xx
39+
or 4.xx according to the
40+
version of the original RINEX
3641

3742
Since Compact RINEX is ASCII text format, the high compression rate is achieved
3843
by combining the Compact RINEX file generation with an additional standard
@@ -61,21 +66,21 @@ The following is an instruction to install the programs.
6166
directories are listed, type "echo $PATH" for unix or
6267
"echo %PATH%" for DOS. Or, you would add new path to those list.
6368
3. (for UNIX) Set permission of the files to be executed.
69+
If you need to output .Z file, UNIX 'compress' command have to be
70+
installed.
6471
4. (for DOS) To use DOS frontend tools, put following tools into the
6572
directory which is included in the command serch paths.
66-
1) compress.exe, compr.bat, decompr.bat
67-
These programs are avairable from, e.g.
68-
ftp://ftp.aiub.unibe.ch/pcrinex/compress.zip
69-
compress.exe in the above works on 16- or 32-bit system.
73+
To input .gz or .Z files or to output .gz files, 'gzip.exe' must be
74+
installed and command serch path is appropriately set.
75+
To output .Z files, "compress.exe" (UNIX compress command) is needed.
76+
too.
77+
78+
1) compress.exe
7079
The compress.exe for 64-bit Windows system is available from
7180
http://www.willus.com/archive/utils.shtml
7281
--> "Unix-style command archive"
7382
or
7483
https://sourceforge.net/projects/unxutils/
75-
2) SPLNAME.EXE (provided with the package, or, if needed, you may
76-
compile the source code splname.c which is also avairable in
77-
the source package.
78-
7984

8085
==== How to compile the programs? ====
8186

@@ -92,6 +97,10 @@ The following is an instruction to install the programs.
9297
# non-standard behaviour of function "sprintf" that was provided in
9398
# the library of OS. Support for this irregularity was terminated,
9499

100+
[using GNU C on MacOSX10.14]
101+
gcc -ansi -O2 rnx2crx.c -o RNX2CRX
102+
gcc -ansi -O2 crx2rnx.c -o CRX2RNX
103+
95104
[using SUN C compiler on Sun OS 5.9]
96105
cc -xO2 -Bstatic rnx2crx.c -o RNX2CRX
97106
cc -xO2 -Bstatic crx2rnx.c -o CRX2RNX
@@ -109,18 +118,26 @@ The following is an instruction to install the programs.
109118

110119
The basic usage of the program RNX2CRX is as follows.
111120

112-
RNX2CRX [file] [-] [-f] [-e # of epochs] [-s] [-h]
121+
RNX2CRX [file] [-] [-f] [-e # of epochs] [-s] [-d] [-h]
113122
stdin and stdout are used if input file name is not given.
114123
- : output to stdout
115124
-f : force overwrite of output file
116125
-e # : initialize the compression operation at every # epochs
126+
When some part of the Compact RINEX file is lost, the data
127+
can not be recovered thereafter until all the data arc are
128+
initialized for differential operation. This option may be used to
129+
increase chances to recover parts of data by using an option of
130+
CRX2RNX(ver. 4.0 or after) with cost of increase of file size.
117131
-s : warn and skip strange epochs (default: stop with error status)
132+
-d : delete the input file if conversion finishes without errors
133+
(i.e. exit code = 0 or 2).
134+
This option does nothing if stdin is used for the input.
118135
-h : display help message
119136

120-
The default file name of the CompactRINEX file is "*.??d".
121-
If the input RINEX file name follows the file name convention of RINEX
122-
format (*.??o) and option '-' is not specified, then the default file
123-
name is chosen for the output file.
137+
The default file name of the CompactRINEX file is "*.??d" and "*.crx".
138+
If the input RINEX filename follows the filename convention of RINEX
139+
format (*.??o or *O.rnx) and option '-' is not specified, then the default
140+
filename is chosen for the output.
124141
The followings are the example of usage of RNX2CRX for UNIX environment:
125142
- If a standard naming convention is adoped;
126143
RNX2CRX rinex.07o
@@ -175,11 +192,12 @@ The following is an instruction to install the programs.
175192
If RNX2CRX and CRX2RNX detect a truncation of the file or other strange
176193
things, the programs stop with an error message.
177194

178-
The line feed code of the input files can be one of "LF", "CR+LF", or even
179-
mixture of them. "CR" (that is often the case of Mac OS) is not supported
180-
at current. Please convert "CR" into "LF" or "CR+LF" before the processing.
181-
The line feed code of the output file depends on the OS (LF for UNIX,
182-
CR+LF for DOS/Windows).
195+
The line feed code of the input files can be "LF" or "CR+LF" and may even
196+
change in the middle of the file. "CR" (that was the case of old MacOS
197+
until ver.9) is not supported at current. Please convert "CR" into "LF"
198+
or "CR+LF" before the processing.
199+
The line feed code of the output file depends on the OS on which the
200+
program is run (LF on UNIX, CR+LF on DOS/Windows).
183201

184202
Some old RINEX (version 2.xx) files assign the format (12(A1,I2)) for
185203
continuation lines of satellite list instead of (32X,12(A1,I2)). RNX2CRX
@@ -202,91 +220,82 @@ The following is an instruction to install the programs.
202220

203221
RINEX obs --> CRINEX --> z-compressed CRINEX
204222

205-
????????.??o --> ????????.??d --> ????????.??d.Z (UNIX)
206-
????????.??O --> ????????.??D --> ????????.??E (DOS)
207-
*O.rnx --> *O.crx --> *O.crx.Z (UNIX)
208-
*o.rnx --> *o.crx --> *o.crx.Z (UNIX)
223+
????????.??o --> ????????.??d --> ????????.??d.gz
224+
????????.??O --> ????????.??D --> ????????.??D.gz
225+
*O.rnx --> *O.crx --> *O.crx.gz
226+
*o.rnx --> *o.crx --> *o.crx.gz
209227

210228
- and vice versa (CRZ2RNX)
211229

212-
- to generate z-compressed CompactRINEX files from old z-compressed RINEX
230+
- to generate compressed CompactRINEX files from old z-compressed RINEX
213231
observation files (RNX2CRZ):
214232

215-
z-compressed RINEX obs --> CRINEX --> z-compressed CRINEX
233+
compressed RINEX obs --> CRINEX --> compressed CRINEX
216234

217-
????????.??o.Z --> ????????.??d --> ????????.??d.Z (UNIX)
218-
????????.??Y --> ????????.??D --> ????????.??E (DOS)
219-
*o.rnx.Z --> *o.crx --> *o.crx.Z (UNIX)
235+
????????.??o.gz --> ????????.??d --> ????????.??d.gz
236+
????????.??o.Z --> ????????.??d --> ????????.??d.gz
237+
*o.rnx.Z --> *o.crx --> *o.crx.gz
220238

221-
- to z-compress CompactRINEX files (RNX2CRZ):
239+
- to compress CompactRINEX files (RNX2CRZ):
222240

223-
CRINEX --> z-compressed CRINEX
241+
CRINEX --> compressed CRINEX
224242

225-
????????.??d --> ????????.??d.Z (UNIX)
226-
????????.??D --> ????????.??E (DOS)
227-
*o.crx --> *o.crx.Z (UNIX)
243+
????????.??d --> ????????.??d.gz
244+
*o.crx --> *o.crx.gz
228245

229246
- to z-compress RINEX NAV/MET/etc. files (RNX2CRZ):
230247

231-
RINEX nav --> z-compressed RINEX nav
232-
233-
????????.??n --> ????????.??n.Z (UNIX)
234-
????????.??g --> ????????.??g.Z (UNIX)
235-
????????.??l --> ????????.??l.Z (UNIX)
236-
????????.??p --> ????????.??p.Z (UNIX)
237-
????????.??h --> ????????.??h.Z (UNIX)
238-
????????.??b --> ????????.??b.Z (UNIX)
239-
????????.??m --> ????????.??m.Z (UNIX)
240-
????????.??c --> ????????.??c.Z (UNIX)
241-
????????.??N --> ????????.??X (DOS)
242-
????????.??G --> ????????.??V (DOS)
243-
????????.??L --> ????????.??T (DOS)
244-
????????.??P --> ????????.??Q (DOS)
245-
????????.??H --> ????????.??U (DOS)
246-
????????.??B --> ????????.??A (DOS)
247-
????????.??M --> ????????.??W (DOS)
248-
????????.??C --> ????????.??K (DOS)
249-
*n.rnx --> *n.rnx.Z (UNIX)
250-
*m.rnx --> *m.rnx.Z (UNIX)
248+
RINEX --> z-compressed RINEX nav
249+
250+
????????.??n --> ????????.??n.gz
251+
????????.??g --> ????????.??g.gz
252+
????????.??l --> ????????.??l.gz
253+
????????.??p --> ????????.??p.gz
254+
????????.??h --> ????????.??h.gz
255+
????????.??b --> ????????.??b.gz
256+
????????.??m --> ????????.??m.gz
257+
????????.??c --> ????????.??c.gz
258+
*n.rnx --> *n.rnx.gz
259+
*m.rnx --> *m.rnx.gz
251260

252261
- and vice versa (CRZ2RNX)
253262

254263
- to decompress old z-compressed RINEX observation files (CRZ2RNX):
255264

256-
????????.??o.Z --> ????????.??o (UNIX)
257-
????????.??Y --> ????????.??O (DOS)
258-
*.rnx.Z --> *.rnx (UNIX)
265+
????????.??o.gz --> ????????.??o
266+
????????.??o.Z --> ????????.??o
267+
*.rnx.gz --> *.rnx
268+
*.rnx.Z --> *.rnx
259269

260270
- to convert CompactRINEX files to RINEX observation files (CRZ2RNX):
261271

262-
????????.??d --> ????????.??o (UNIX)
263-
????????.??d.Z --> ????????.??o (UNIX)
264-
????????.??D --> ????????.??O (DOS)
265-
????????.??E --> ????????.??O (DOS)
266-
*.crx --> *.rnx (UNIX)
272+
????????.??d --> ????????.??o
273+
????????.??d.gz --> ????????.??o
274+
????????.??d.Z --> ????????.??o
275+
????????.??D --> ????????.??O
276+
*.crx --> *.rnx
267277

268278

269279
Remarks:
270280
- The extensions of the input files should conform to the RINEX convention
271281
recommended in the documentation of RINEX. The current and old conventions
272282
are written in the following references:
273-
International GNSS Service (IGS), RINEX Working Group and Radio Technical
274-
Commission for Maritime Services Special Committee 104 (RTCM-SC104),
275-
2013, RINEX The Receiver Independent Exchange Format Version 3.02
276-
Gurtner, W., L. Estey (2006), RINEX The Receiver Independent Exchange
277-
Format Version 3.01, avairable from
278-
ftp://ftp.igs.org/pub/data/format/rinex301.pdf
283+
Romero I. (ed.), RINEX The Receiver Independent Exchange Format Version 4.00,
284+
1 December 2021;
285+
https://files.igs.org/pub/data/format/rinex_4.00.pdf
286+
Gurtner, W., L. Estey (2009), RINEX The Receiver Independent Exchange
287+
Format Version 3.01, 22 June 2009;
288+
https://files.igs.org/pub/data/format/rinex301.pdf
279289
The software accept both of them.
280-
The extentions of the output files alse follow the RINEX convention.
281-
- UNIX versino of the front-end tools has following feature (ver. 4.0.4-)
290+
- The UNIX version of the front-end tools has following feature (ver. 4.0.4-)
282291
* help message is shown if executed with option -h or with no argument.
283292
* The output files are created to the same directory as the
284293
input file in default. The option "-c" may be used to change
285294
them to the current directory.
286295
* The input files are removed if option "-d" is specified,
287296
otherwise they are preserved.
288-
* The tools inquire if overwrite the an output file if it preexist.
297+
* The UNIX tools inquire if overwrite the an output file if it preexist.
289298
The option -f forces overwriting without inquiring
290-
* Both Z-compressed and gzipped files can be processed.
299+
* Both gzipped and Z-compressed files can be processed.
291300

292301

‎rnxcmp/front-end-tools/dos/CRZ2RNX.BAT

-23
This file was deleted.

0 commit comments

Comments
 (0)