source: ntrip/trunk/rtcm3torinex/rtcm3torinex.txt@ 318

Last change on this file since 318 was 318, checked in by stoecker, 16 years ago

some fixed, better error support

File size: 5.0 KB
Line 
1Manual for rtcm3torinex
2
3The program rtcm3torinex is an real-time converter from NTRIP streamed RTCM3
4data into the RINEX format.
5
6RTCM3 defines a number of message types. Among them are the following:
7
8Message
9Type Contains information about
10--------------------------------------------------------------------------
111001 GPS L1 code and phase
121002 GPS L1 code and phase and ambiguities and carrier to noise ratio
131003 GPS L1 and L1 code and phase
141004 GPS L1 and L2 code and phase and ambiguities and carrier to noise ratio
151005 Station coordinates XZY for antenna reference point
161006 Station coordinates XYZ for antenna reference point and antenna height
171007 Antenna descriptor and ID
181008 Antenna serial number
191009 GLONASS L1 code and phase
201010 GLONASS L1 code and phase and ambiguities and carrier to noise ratio
211011 GLONASS L1 and L1 code and phase
221012 GLONASS L1 and L2 code and phase and ambiguities and carrier to noise ratio
231013 Modified julian date, leep second, configured message types and intervall
241014-1017 Network RTK (MAK) messages (under development)
251019 GPS Ephemeris (under development)
261020 GLONASS Ephemeris (under development)
274088-4095 Proprietary messages (under development)
28
29Note that this version of rtcm3torinex only handles RTCM3 message types 1001,
301002, 1003, 1004, 1009, 1010, 1011 and 1012.
31
32The generated RINEX is somewhat limited due to the streaming character of the
33conversion:
34
35 - Header records can only represent data, which is known after receiving the
36 very first epoch. Data rate, position, number of observations and any such
37 additional fields cannot be provided.
38 - The number of observables cannot change during the program runtime. Only
39 the observables, which exist in the first epoch are outputted. If there
40 are new observables later on, these are ignored.
41 - Only known message types are interpreted. This means only GPS data at the
42 moment. Send me new RTCM3 data files and data support can be improved.
43 See contact address at the end of this document.
44 - If the ambiguity field in the RTCM3 data is not set, the output will be no
45 valid RINEX. All values will be stored modulo 299792.458. A COMMENT line
46 will tell you, when this happens. It would be necessary to approximately
47 calculate the range to fix the ambiguity (needing ephemeris/alamanac and
48 easy positioning algorithm).
49
50Usage: rtcm3torinex -s server -u user ...
51 -d --data the requested data set
52 -f --headerfile file for RINEX header information
53 -s --server the server name or address
54 -p --password the login password
55 -r --port the server port number (default 80)
56 -u --user the user name
57
58The fields --user and --password are used to specify the access data for the
59NTRIP server. The arguments --server and --port are used to specify the NTRIP
60server itself (defaults to "www.euref-ip.net" port 80). The Argument --data
61must be used to specify the RTCM3 input data stream. If it is not given, you
62will be shown the source table of the selected NTRIP caster.
63
64Alternatively a single text of the form
65"ntrip:mountpoint[/username[:password]][@server[:port]]"
66can be used. Everything in brackets is optional.
67
68Additionally the argument --headerfile can be used to provide additional header
69information. The file must contain normal RINEX observation file header lines.
70The given lines overwrite the automatical generated lines. Overwriting the
71lines "# / TYPES OF OBSERV" and "TIME OF FIRST OBS" usually is a bad idea and
72you will get warned if you do so. The line "END OF HEADER" is ignored.
73Unknown lines or COMMENT lines will be appended before the "END OF HEADER".
74
75NOTE: The tool does not check the input lines for validity. So be sure to
76use correct RINEX specifiers as well as correct alignment.
77
78To stop RINEX output send the program a killing signal. Following signal
79sources are supported:
80
81signal number usual source of the signal
82---------------------------------------------------------------------------
83SIGINT 2 pressing CTRL+C in the shell running the tool
84SIGQUIT 3 pressing CTRL-\ or sending QUIT signal
85SIGTERM 15 called kill <num> with the process number of rtcm3torinex
86SIGPIPE 13 the output or input of rtcm3torinex has been closed
87
88The programm will be terminated after the current epoch has been finished.
89You will not get corrupted RINEX files.
90
91When compiling the program with older gcc versions running the `make'
92command, you may receive an informative error message saying
93
94rtcm3torinex.c: In function `signalhandler_alarm':
95rtcm3torinex.c:1240: warning: `noreturn' function does return
96
97This is most likely a compiler problem which only concerns the optimization
98and is thus not critical. New compilers will not show this problem.
99
100Program written by
101
102Dirk Stoecker
103Euronik GmbH
104http://www.euronik.eu/
105
106for
107
108Federal Agency for Cartography and Geodesy (BKG)
109Richard-Strauss-Allee 11
110D-60598 Frankfurt
111http://igs.bkg.bund.de/index_ntrip.htm
112
113Contact Dirk Stoecker [stoecker@euronik.eu] or [euref-ip@bkg.bund.de]
114with your comments, suggestions, improvements, patches, ...
Note: See TracBrowser for help on using the repository browser.