source: ntrip/trunk/BNC/bnchelp.html@ 4155

Last change on this file since 4155 was 4155, checked in by weber, 13 years ago

Documentation completed

File size: 196.4 KB
Line 
1<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
2<h3>BKG Ntrip Client (BNC) Version 2.6 Manual</h3>
3
4<p>
5The BKG Ntrip Client (BNC) is a program for simultaneously retrieving, decoding, converting and processing real-time GNSS data streams from NTRIP Broadcasters like <u>http://www.euref-ip.net/home</u>, <u>http://www.igs-ip.net/home</u>, <u>http://products.igs-ip.net/home</u>, or <u>http://mgex.igs-ip.net/home</u>. It furthermore allows to edit and concatenate RINEX files or check their quality.
6</p>
7
8<p>
9BNC has been developed for the Federal Agency for Cartography and Geodesy (BKG) within the framework of the IAG subcommission for Europe (EUREF) and the International GNSS Service (IGS).
10</p>
11
12<p>
13BNC has been written under GNU General Public License (GPL). Binaries for BNC are available for Windows, 32-bit Linux, 64-bit Linux (compiled under -m32 32-bit compatibility mode), Solaris, and Mac systems. We used the MinGW Version 4.4.0 compiler to create the Windows binary. It is likely that BNC can be compiled on other systems where a GNU compiler and Qt Version 4.7.3 are installed.
14</p>
15
16<p>
17Please ensure that you have installed the latest version of BNC available from <u>http://igs.bkg.bund.de/ntrip/download</u>. We are continuously working on the program and would appreciate if you could send comments, suggestions, or bug reports to [euref-ip@bkg.bund.de] or [igs-ip@bkg.bund.de].
18</p>
19
20<p><b>Contents</b><br>
21<a href=#purpose>1. Purpose</a><br>
22<a href=#resources>2. Modes &amp; Resources</a><br>
23<a href=#opthandling>3. Handling</a><br>
24<a href=#optsettings>4. Settings</a><br>
25<a href=#limits>5. Limitations &amp; Known Bugs</a><br>
26<a href=#annex>6. Annex</a>
27</p>
28
29<p>
30<b><a name="authors">Authors</b><br>
31The BKG Ntrip Client (BNC) Qt Graphic User Interface (GUI) has been developed for the Federal Agency for Cartography and Geodesy (BKG) by Leos Mervart, Czech Technical University Prague, Department of Geodesy. BNC includes the following GNU GPL software components:
32<ul>
33<li> RTCM 2 decoder, written by Oliver Montenbruck, German Space Operations Center, DLR, Oberpfaffenhofen</li>
34<li> RTCM 3 decoder for standard messages and a RTCM 3 encoder & decoder for SSR messages, both written for BKG by Dirk Stoecker, Alberding GmbH, Schoenefeld</li>
35</ul>
36</p>
37<p>
38Georg Weber<br>
39Federal Agency for Cartography and Geodesy (BKG)<br>
40Frankfurt, Germany<br>
41[euref-ip@bkg.bund.de] or [igs-ip@bkg.bund.de]
42</p>
43
44<p>
45<b>Acknowledgements</b><br>
46BNC's Help Contents has been proofread by Thomas Yan, University of New South Wales, Australia.<br>
47Scott Glazier, OmniSTAR Australia has been helpful in finding BNC's bugs.<br>
48James Perlt, BKG, helped fixing bugs and redesigned BNC's main window.<br>
49Andre Hauschild, German Space Operations Center, DLR, revised the RTCM Version 2 decoder.<br>
50Zdenek Lukes, Czech Technical University Prague, Department of Geodesy, extended the RTCM Version 2 decoder to handle message types 3, 20, 21, and 22 and added loss of lock indicator.<br>
51Jan Dousa, Geodetic Observatory Pecny, Czech Republic, provided a tool for drawing stream distribution maps and also helped with fixing bugs.<br>
52Denis Laurichesse, Centre National d'Etudes Spatiales (CNES), suggested synchronizing observations and clock corrections to reduce high frequency noise in PPP solutions.
53</p>
54
55<p><a name="purpose"><h3>1. Purpose</h3></p>
56
57<p> The purpose of BNC is to
58<ul>
59<li>retrieve real-time GNSS data streams available through NTRIP transport protocol,</li>
60<li>retrieve real-time GNSS data streams via TCP directly from an IP address without using the NTRIP transport protocol,</li>
61<li>retrieve real-time GNSS data streams from a local UDP or serial port without using the NTRIP transport protocol,</li>
62<li>generate high-rate RINEX Observation and Navigation files to support near real-time GNSS post-processing applications,</li>
63<li>generate ephemeris and synchronized or unsynchronized observations epoch by epoch through an IP port to support real-time GNSS network engines,</li>
64<li>generate clock and orbit corrections to Broadcast Ephemeris through an IP port to support real-time Precise Point Positioning on GNSS rovers,</li>
65<li>generate synchronized or unsynchronized clock and orbit corrections to Broadcast Ephemeris epoch by epoch through an IP port to support the (outside) combination of such streams as coming simultaneously from various correction providers,</li>
66<li>monitor the performance of a network of real-time GNSS data streams to generate advisory notes in case of outages or corrupted streams,</li>
67<li>scan RTCM streams for incoming antenna information as well as message types and their repetition rates,</li>
68<li>feed a stream into a GNSS receiver via serial communication link,</li>
69<li>carry out a real-time Precise Point Positioning to determine a GNSS rover position,</li>
70<li>simultaneously process several incoming orbit and clock correction streams to produce, encode and upload a combination solution,</li>
71<li>upload a Broadcast Ephemeris stream in RTCM Version 3 format,</li>
72<li>read GNSS clocks and orbits in a plain ASCII format from an IP port - they can be produced by a real-time GNSS engine such as RTNet and should be referenced to the IGS Earth-Centered-Earth-Fixed (ECEF) reference system and</li>
73<ul>
74<li>convert the IGS Earth-Centered-Earth-Fixed clocks and and orbits into corrections to Broadcast Ephemeris with radial, along-track and cross-track components,</li>
75<li>upload the clock and orbit corrections as an RTCM Version 3 stream to an NTRIP Broadcaster,</li>
76<li>refer the clock and orbit corrections to a specific reference system,</li>
77<li>log the Broadcast Ephemeris clock corrections as Clock RINEX files for further processing using other tools than BNC,</li>
78<li>log the Broadcast Ephemeris orbit corrections as SP3 files for further processing using other tools than BNC,</li>
79</ul>
80<li>edit or concatenate RINEX files or check their quality.</li>
81</ul>
82</p>
83
84<p>
85BNC supports decoding the following GNSS stream formats and message types:
86</p>
87<p>
88<ul>
89<li>RTCM Version 2 message types for GPS and GLONASS observations, </li>
90<li>RTCM Version 3 'conventional' message types for observations and Broadcast Ephemeris for GPS, GLONASS, SBAS, Galileo, COMPASS, and QZSS,</li>
91<li>RTCM Version 3 'State Space Representation' (SSR) messages for GPS, GLONASS and Galileo,</li>
92<li>RTCM Version 3 'Multiple Signal Messages' (MSM) and 'High Precision Multiple Signal Messages' (HP MSM),</li>
93<li>RTNET, a plain ASCII format defined within BNC to receive orbits and clock from a serving GNSS engine.
94</ul>
95Furthermore, BNC allows to by-pass its decoding and conversion algorithms, leave whatever is received untouched and save it in files.
96</p>
97
98<p>
99The first of the following figures shows a flow chart of BNC connected to a GNSS receiver providing observations via serial or TCP communication link for the purpose of Precise Point Positioning. The second figure shows the conversion of RTCM streams to RINEX files. The third figure shows a flow chart of BNC feeding a real-time GNSS engine which estimates Broadcast Corrections. BNC is used in this scenario to encode correctors to RTCM Version 3 and upload them to an NTRIP Broadcaster. The fourth figure shows BNC combining several Broadcast Correction streams to disseminate the combination product while saving results in SP3 and Clock RINEX files.
100</p>
101<p><img src="IMG/screenshot10.png"/></p>
102<p><u>Figure 1:</u> Flowchart, BNC connected to a GNSS receiver for Precise Point Positioning.</p>
103
104<p>
105</p>
106<p><img src="IMG/screenshot01.png"/></p>
107<p><u>Figure 2:</u> Flowchart, BNC converting RTCM streams to RINEX batches.</p>
108
109<p>
110</p>
111<p><img src="IMG/screenshot02.png"/></p>
112<p><u>Figure 3:</u> Flowchart, BNC feeding a real-time GNSS engine and uploading an encoded Broadcast Corrections stream.</p>
113
114<p>
115</p>
116<p><img src="IMG/screenshot19.png"/></p>
117<p><u>Figure 4:</u> Flowchart, BNC combining Broadcast Correction streams.</p>
118
119
120<p><a name="resources"><h3>2. Modes &amp; Resources</h3></p>
121<p>
122Although BNC is mainly a real-time tool to be operated online, it can be run offline
123<ul>
124<li>to simulate real-time observation situations for debugging purposes,</li>
125<li>for post-processing purposes.</li>
126</ul>
127Furthermore, apart from its regular window mode, BNC can be run as a batch/background job in a 'no window' mode using processing options from a previously saved configuration or from command line.
128</p>
129<p>
130Unless it runs offline, BNC
131</p>
132<ul>
133<li>requires access to the Internet with a minimum of about 2 to 6 kbits/sec per stream depending on the stream format and the number of visible satellites. You need to make sure that the connection can sustain the required bandwidth.</li>
134<li>requires the clock of the host computer to be properly synchronized.</li>
135<li>has the capacity to retrieve hundreds of GNSS data streams simultaneously. Please be aware that such usage may incur a heavy load on the NTRIP Broadcaster side depending on the number of streams requested. We recommend limiting the number of streams where possible to avoid unnecessary workload.</li>
136</ul>
137</p>
138
139<p>
140The main window of BNC shows a 'Top menu bar' section, a 'Settings' sections with tabs to set processing options, a 'Streams' section, a section for 'Log' tabs, and a 'Bottom menu bar' section, see figure below.
141</p>
142<p><img src="IMG/screenshot09.png"/></p>
143<p><u>Figure 5:</u> Sections on BNC's main window.</p>
144
145
146<p><a name="opthandling"><h3>3. Handling</h3></p>
147
148<p>
149The usual handling of BNC is that you first select a number of streams ('Add Stream'). Any stream configured to BNC shows up on the 'Streams' canvas in the middle of BNC's main window. You then go through BNC's various configuration tabs to select a combination of input, processing and output options before you start the program ('Start'). Most configuration tabs are dedicated to a certain functionality of BNC. If the first option field on such a configuration tab is empty, the affected functionality is - apart from a few exceptions - deactivated.</p>
150
151Records of BNC's activities are shown in the 'Log' tab. The bandwidth consumption per stream, the latency of incoming observations and a PPP time series for coordinates are shown in the 'Throughput', 'Latency' and 'PPP Plot' tabs of the main window.
152</p>
153<p>
154As a default, configuration files for running BNC on Unix/Linux/Mac systems are saved in directory '${HOME}/.config/BKG'. On Windows systems, they are typically saved in directory 'C:/Documents and Settings/Username/.config/BKG'. The default configuration file name is 'BNC.ini'.</p>
155<p>
156The default file name 'BNC.ini' can be changed and the file contents can easily be edited. On graphical user interfaces it is possible to Drag &amp; Drop a configuration file icon to start BNC (not on Mac systems). Some configuration options can be changed on-the-fly. See annexed 'Configuration Examples' for a complete set of configuration options. It is also possible to start and configure BNC via command line.
157</p>
158<p><a name="optsettings"><h3>4. Settings</h3></p>
159<p>
160This chapter describes how to set the BNC program options. It explains the top menu bar, the processing options, the 'Streams' and 'Log' sections, and the bottom menu bar.
161</p>
162<p>
163<b>Top Menu Bar</b><br>
1644.1. <a href=#topmenu>Top Menu Bar</a><br>
1654.1.1 <a href=#file>File</a><br>
1664.1.2 <a href=#help>Help</a><br><br>
167<b>Settings Canvas</b><br>
1684.2. <a href=#network>Network</a><br>
1694.2.1 <a href=#proxy>Proxy</a><br>
1704.2.2 <a href=#ssl>SSL</a><br>
1714.3. <a href=#general>General</a><br>
172&nbsp; &nbsp; &nbsp; 4.3.1. <a href=#genlog>Logfile</a><br>
173&nbsp; &nbsp; &nbsp; 4.3.2. <a href=#genapp>Append Files</a><br>
174&nbsp; &nbsp; &nbsp; 4.3.3. <a href=#genconf>Reread Configuration</a><br>
175&nbsp; &nbsp; &nbsp; 4.3.4. <a href=#genstart>Auto Start</a><br>
176&nbsp; &nbsp; &nbsp; 4.3.5. <a href=#rawout>Raw Output File</a><br>
1774.4. <a href=#rinex>RINEX Observations</a><br>
178&nbsp; &nbsp; &nbsp; 4.4.1. <a href=#rnxname>File Names</a><br>
179&nbsp; &nbsp; &nbsp; 4.4.2. <a href=#rnxdir>Directory</a><br>
180&nbsp; &nbsp; &nbsp; 4.4.3. <a href=#rnxinterval>File Interval</a><br>
181&nbsp; &nbsp; &nbsp; 4.4.4. <a href=#rnxsample>Sampling</a><br>
182&nbsp; &nbsp; &nbsp; 4.4.5. <a href=#rnxskl>Skeleton Extension</a><br>
183&nbsp; &nbsp; &nbsp; 4.4.6. <a href=#rnxscript>Script</a><br>
184&nbsp; &nbsp; &nbsp; 4.4.7. <a href=#rnxvers>Version</a><br>
1854.5. <a href=#ephemeris>RINEX Ephemeris</a><br>
186&nbsp; &nbsp; &nbsp; 4.5.1. <a href=#ephdir>Directory</a><br>
187&nbsp; &nbsp; &nbsp; 4.5.2. <a href=#ephint>Interval</a><br>
188&nbsp; &nbsp; &nbsp; 4.5.3. <a href=#ephport>Port</a><br>
189&nbsp; &nbsp; &nbsp; 4.5.4. <a href=#ephvers>Version</a><br>
1904.6. <a href=#reqc>RINEX Editing & QC</a><br>
191&nbsp; &nbsp; &nbsp; 4.6.1 <a href=#reqcact>Action</a><br>
192&nbsp; &nbsp; &nbsp; 4.6.2 <a href=#reqcedit>Set Edit Options</a><br>
193&nbsp; &nbsp; &nbsp; 4.6.3 <a href=#reqcinput>Input Files</a><br>
194&nbsp; &nbsp; &nbsp; 4.6.4 <a href=#reqcoutput>Output Files</a><br>
195&nbsp; &nbsp; &nbsp; 4.6.5 <a href=#reqccommand>Command Line, No Window</a><br>
1964.7. <a href=#correct>Broadcast Corrections</a><br>
197&nbsp; &nbsp; &nbsp; 4.7.1. <a href=#corrdir>Directory, ASCII</a><br>
198&nbsp; &nbsp; &nbsp; 4.7.2. <a href=#corrint>Interval</a><br>
199&nbsp; &nbsp; &nbsp; 4.7.3. <a href=#corrport>Port</a><br>
200&nbsp; &nbsp; &nbsp; 4.7.4. <a href=#corrwait>Wait for Full Epoch</a><br>
2014.8. <a href=#syncout>Feed Engine</a><br>
202&nbsp; &nbsp; &nbsp; 4.8.1. <a href=#syncport>Port</a><br>
203&nbsp; &nbsp; &nbsp; 4.8.2. <a href=#syncwait>Wait for Full Epoch</a><br>
204&nbsp; &nbsp; &nbsp; 4.8.3. <a href=#syncsample>Sampling</a><br>
205&nbsp; &nbsp; &nbsp; 4.8.4. <a href=#syncfile>File</a><br>
206&nbsp; &nbsp; &nbsp; 4.8.5. <a href=#syncuport>Port (unsynchronized)</a><br>
2074.9. <a href=#serial>Serial Output</a><br>
208&nbsp; &nbsp; &nbsp; 4.9.1. <a href=#sermount>Mountpoint</a><br>
209&nbsp; &nbsp; &nbsp; 4.9.2. <a href=#serport>Port Name</a><br>
210&nbsp; &nbsp; &nbsp; 4.9.3. <a href=#serbaud>Baud Rate</a><br>
211&nbsp; &nbsp; &nbsp; 4.9.4. <a href=#serflow>Flow Control</a><br>
212&nbsp; &nbsp; &nbsp; 4.9.5. <a href=#serparity>Parity</a><br>
213&nbsp; &nbsp; &nbsp; 4.9.6. <a href=#serdata>Data Bits</a><br>
214&nbsp; &nbsp; &nbsp; 4.9.7. <a href=#serstop>Stop Bits</a><br>
215&nbsp; &nbsp; &nbsp; 4.9.8. <a href=#serauto>NMEA</a><br>
216&nbsp; &nbsp; &nbsp; 4.9.9. <a href=#serfile>File</a><br>
217&nbsp; &nbsp; &nbsp; 4.9.10. <a href=#serheight>Height</a><br>
2184.10. <a href=#advnote>Outages</a><br>
219&nbsp; &nbsp; &nbsp; 4.10.1. <a href=#obsrate>Observation Rate</a><br>
220&nbsp; &nbsp; &nbsp; 4.10.2. <a href=#advfail>Failure Threshold</a><br>
221&nbsp; &nbsp; &nbsp; 4.10.3. <a href=#advreco>Recovery Threshold</a><br>
222&nbsp; &nbsp; &nbsp; 4.10.4. <a href=#advscript>Script</a><br>
2234.11. <a href=#misc>Miscellaneous</a><br>
224&nbsp; &nbsp; &nbsp; 4.11.1. <a href=#miscmount>Mountpoint</a><br>
225&nbsp; &nbsp; &nbsp; 4.11.2. <a href=#miscperf>Log Latency</a><br>
226&nbsp; &nbsp; &nbsp; 4.11.3. <a href=#miscscan>Scan RTCM</a><br>
2274.12. <a href=#pppclient>PPP Client</a><br>
228&nbsp; &nbsp; &nbsp; 4.12.1 <a href=#pppmode>Mode & Mountpoints</a><br>
229&nbsp; &nbsp; &nbsp; 4.12.1.1 <a href=#pppmodus>Mode</a><br>
230&nbsp; &nbsp; &nbsp; 4.12.1.2 <a href=#pppobsmount>Obs Mountpoint</a><br>
231&nbsp; &nbsp; &nbsp; 4.12.1.3 <a href=#pppcorrmount>Corr Mountpoint</a><br>
232&nbsp; &nbsp; &nbsp; 4.12.2 <a href=#pppxyz>Marker Coordinates</a><br>
233&nbsp; &nbsp; &nbsp; 4.11.3 <a href=#pppneu>Antenna Excentricity</a><br>
234&nbsp; &nbsp; &nbsp; 4.12.4 <a href=#pppoutput>NMEA & Plot Output</a><br>
235&nbsp; &nbsp; &nbsp; 4.12.4.1 <a href=#pppnmeafile>NMEA File</a><br>
236&nbsp; &nbsp; &nbsp; 4.12.4.2 <a href=#pppnmeaport>NMEA Port</a><br>
237&nbsp; &nbsp; &nbsp; 4.12.4.3 <a href=#pppplot>PPP Plot</a><br>
238&nbsp; &nbsp; &nbsp; 4.12.5 <a href=#ppppost>Post Processing</a><br>
239&nbsp; &nbsp; &nbsp; 4.12.6 <a href=#ppprecant>Antennas</a><br>
240&nbsp; &nbsp; &nbsp; 4.12.6.1 <a href=#pppantex>ANTEX File</a><br>
241&nbsp; &nbsp; &nbsp; 4.12.6.2 <a href=#ppprecantenna>Antenna Name</a><br>
242&nbsp; &nbsp; &nbsp; 4.12.6.3 <a href=#pppsatant>Apply Satellite Antenna Offsets</a><br>
243&nbsp; &nbsp; &nbsp; 4.12.7 <a href=#pppbasics>Basics</a><br>
244&nbsp; &nbsp; &nbsp; 4.12.7.1 <a href=#pppphase>Use Phase Obs</a><br>
245&nbsp; &nbsp; &nbsp; 4.12.7.2 <a href=#ppptropo>Estimate Tropo</a><br>
246&nbsp; &nbsp; &nbsp; 4.12.7.3 <a href=#pppglo>Use GLONASS</a><br>
247&nbsp; &nbsp; &nbsp; 4.12.7.4 <a href=#pppgal>Use Galileo</a><br>
248&nbsp; &nbsp; &nbsp; 4.12.7.5 <a href=#pppsync>Sync Corr</a><br>
249&nbsp; &nbsp; &nbsp; 4.12.7.6 <a href=#pppaverage>Averaging</a><br>
250&nbsp; &nbsp; &nbsp; 4.12.7.7 <a href=#pppquick>Quick-Start</a><br>
251&nbsp; &nbsp; &nbsp; 4.12.7.8 <a href=#pppgap>Maximal Solution Gap</a><br>
252&nbsp; &nbsp; &nbsp; 4.12.8 <a href=#pppsigmas>Sigmas</a><br>
253&nbsp; &nbsp; &nbsp; 4.12.8.1 <a href=#pppsigc>Code</a><br>
254&nbsp; &nbsp; &nbsp; 4.12.8.2 <a href=#pppsigp>Phase</a><br>
255&nbsp; &nbsp; &nbsp; 4.12.8.3 <a href=#pppsigxyzi>XYZ Init</a><br>
256&nbsp; &nbsp; &nbsp; 4.12.8.4 <a href=#pppsigxyzn>XYZ White Noise</a><br>
257&nbsp; &nbsp; &nbsp; 4.12.8.5 <a href=#pppsigtrpi>Tropo Init</a><br>
258&nbsp; &nbsp; &nbsp; 4.12.8.6 <a href=#pppsigtrpn>Tropo White Noise</a><br>
2594.13. <a href=#combi>Combination</a><br>
260&nbsp; &nbsp; &nbsp; 4.13.1 <a href=#combimounttab>Combination Table</a><br>
261&nbsp; &nbsp; &nbsp; 4.13.1.1 <a href=#combiadd>Add Row, Delete</a><br>
262&nbsp; &nbsp; &nbsp; 4.13.1.2 <a href=#combimethod>Method</a><br>
263&nbsp; &nbsp; &nbsp; 4.13.1.3 <a href=#combimax>Maximal Residuum</a><br>
2644.14. <a href=#upclk>Upload (clk)</a><br>
265&nbsp; &nbsp; &nbsp; 4.14.1 <a href=#upadd>Add, Delete Row</a><br>
266&nbsp; &nbsp; &nbsp; 4.14.2 <a href=#uphost>Host, Port, Mountpoint, Password</a><br>
267&nbsp; &nbsp; &nbsp; 4.14.3 <a href=#upsystem>System</a><br>
268&nbsp; &nbsp; &nbsp; 4.14.4 <a href=#upcom>Center of Mass</a><br>
269&nbsp; &nbsp; &nbsp; 4.14.5 <a href=#upsp3>SP3 File</a><br>
270&nbsp; &nbsp; &nbsp; 4.14.6 <a href=#uprinex>RNX File</a><br>
271&nbsp; &nbsp; &nbsp; 4.14.7 <a href=#upinter>Interval</a><br>
272&nbsp; &nbsp; &nbsp; 4.14.8 <a href=#upclksmpl>Sampling (Clk)</a><br>
273&nbsp; &nbsp; &nbsp; 4.14.9 <a href=#uporbsmpl>Sampling (Orb)</a><br>
274&nbsp; &nbsp; &nbsp; 4.14.10 <a href=#upcustom>Custom Trafo</a><br>
2754.15. <a href=#upeph>Upload (eph)</a><br>
276&nbsp; &nbsp; &nbsp; 4.15.1 <a href=#brdcserver>Host &amp; Port</a><br>
277&nbsp; &nbsp; &nbsp; 4.15.2 <a href=#brdcmount>Mountpoint &amp; Password</a><br>
278&nbsp; &nbsp; &nbsp; 4.15.3 <a href=#brdcsmpl>Sampling</a><br><br>
279<b>Streams Canvas</b><br>
2804.16. <a href=#streams>Streams</a><br>
281&nbsp; &nbsp; &nbsp; 4.16.1 <a href=#streamedit>Edit Streams</a><br>
282&nbsp; &nbsp; &nbsp; 4.16.2 <a href=#streamdelete>Delete Stream</a><br>
283&nbsp; &nbsp; &nbsp; 4.16.3 <a href=#streamconf>Reconfigure Streams On-the-fly</a><br><br>
284<b>Logging Canvas</b><br>
2854.17. <a href=#logs>Logging</a><br>
286&nbsp; &nbsp; &nbsp; 4.17.1 <a href=#logfile>Log</a><br>
287&nbsp; &nbsp; &nbsp; 4.17.2 <a href=#throughput>Throughput</a><br>
288&nbsp; &nbsp; &nbsp; 4.17.3 <a href=#latency>Latency</a><br>
289&nbsp; &nbsp; &nbsp; 4.17.4 <a href=#ppptab>PPP Plot</a><br><br>
290<b>Bottom Menu Bar</b><br>
2914.18. <a href=#bottom>Bottom Menu Bar</a><br>
292&nbsp; &nbsp; &nbsp; 4.18.1. <a href=#streamadd>Add Stream - Coming from Caster</a><br>
293&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 4.18.1.1 <a href=#streamhost>Caster Host and Port</a><br>
294&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 4.18.1.2 <a href=#streamtable>Casters Table</a><br>
295&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 4.18.1.3 <a href=#streamuser>User and Password</a><br>
296&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 4.18.1.4 <a href=#gettable>Get Table</a><br>
297&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 4.18.1.5 <a href=#ntripv>NTRIP Version</a><br>
298&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 4.18.1.6 <a href=#map>Map</a><br>
299&nbsp; &nbsp; &nbsp; 4.18.2 <a href=#streamip>Add Stream - Coming from TCP/IP Port</a><br>
300&nbsp; &nbsp; &nbsp; 4.18.3 <a href=#streamudp>Add Stream - Coming from UDP Port</a><br>
301&nbsp; &nbsp; &nbsp; 4.18.4 <a href=#streamser>Add Stream - Coming from Serial Port</a><br>
302&nbsp; &nbsp; &nbsp; 4.18.5 <a href=#start>Start</a><br>
303&nbsp; &nbsp; &nbsp; 4.18.6 <a href=#stop>Stop</a><br><br>
304<b>Command Line</b><br>
3054.19. <a href=#cmd>Command Line Options</a><br>
306&nbsp; &nbsp; &nbsp; 4.19.1. <a href=#nw>No Window Mode</a><br>
307&nbsp; &nbsp; &nbsp; 4.19.2. <a href=#post>File Mode</a><br>
308&nbsp; &nbsp; &nbsp; 4.19.3. <a href=#conffile>Configuration File</a><br>
309&nbsp; &nbsp; &nbsp; 4.19.4. <a href=#confopt>Configuration Options</a><br>
310</p>
311
312<p><a name="topmenu"><h4>4.1. Top Menu Bar</h4></p>
313<p>
314The top menu bar allows to select a font for the BNC windows, save configured options, or quit the program execution. It also provides access to a program documentation.
315</p>
316
317<p><a name="file"><h4>4.1.1 File</h4></p>
318
319<p>
320The 'File' button lets you
321<ul>
322<li> select an appropriate font.<br>
323Use smaller font size if the BNC main window exceeds the size of your screen.
324</li>
325<li> save selected options in configuration file.<br>
326When using 'Save &amp; Reread Configuration' while BNC is already processing data, some configuration options become immediately effective on-the-fly without interrupting uninvolved threads. See annexed section 'Configuration Examples' for a list of on-the-fly changeable configuration options.
327</li>
328<li> quit the BNC program.
329</li>
330</ul>
331</p>
332
333<p><a name="help"><h4>4.1.2 Help</h4></p>
334
335<p>
336The 'Help' button provides access to
337<ul>
338<li>
339help contents.<br>
340You may keep the 'Help Contents' window open while configuring BNC.
341</li>
342<li>
343a 'Flow Chart' showing BNC linked to a real-time GNSS network engine such as RTNet.
344</li>
345<li>
346general information about BNC.<br>
347Close the 'About BNC' window to continue working with BNC.
348</li>
349</ul>
350</p>
351<p>
352BNC comes with a help system providing online information about its functionality and usage. Short descriptions are available for any widget. Focus to the relevant widget and press Shift+F1 to request help information. A help text appears immediately; it disappears as soon as the user does something else. The dialogs on some operating systems may provide a &quot;?&quot; button that users can click; they then click the relevant widget to pop up the help text.
353</p>
354
355<p><a name="network"><h4>4.2. Network</h4></p>
356<p>
357You may need to specify a proxy when running BNC in a protected network. You may also like to use the Transport Layer Security (TLS) and its predecessor, Secure Sockets Layer (SSL) cryptographic protocols for secure NTRIP communication over the Internet.
358</p>
359<p><a name="proxy"><h4>4.2.1 Proxy - Usage in a protected LAN</h4></p>
360<p>
361If you are running BNC within a protected Local Area Network (LAN), you might need to use a proxy server to access the Internet. Enter your proxy server IP and port number in case one is operated in front of BNC. If you don't know the IP and port of your proxy server, check the proxy server settings in your Internet browser or ask your network administrator.</p>
362<p>
363Note that IP streaming is often not allowed in a LAN. In this case you need to ask your network administrator for an appropriate modification of the local security policy or for the installation of a TCP relay to the NTRIP Broadcasters. If these are not possible, you might need to run BNC outside your LAN on a host that has unobstructed connection to the Internet.
364</p>
365
366<p><a name="ssl"><h4>4.2.2 SSL - Transport Layer Security</h4></p>
367<p>Communication with an NTRIP Broadcaster over SSL requires the exchange of client and/or server certificates. Specify the path to a directory where you save certificates on your system. You may like to check out <u>http://software.rtcm-ntrip.org/wiki/Certificates</u> for a list of known NTRIP Server certificates. Don't try communication via SSL if you are not sure whether this is supported by the involved NTRIP Broadcaster. </p>
368<p>SSL communication may involve queries coming from the NTRIP Broadcaster. Tick 'Ignore SSL authorization erros' if you don't want to be bothered with this. Note that SSL communication is usually done over port 443.</p>
369
370<p><a name="general"><h4>4.3. General</h4></p>
371<p>
372The following defines general settings for BNC's logfile, file handling, reconfiguration on-the-fly, and auto-start.
373</p>
374
375<p><a name="genlog"><h4>4.3.1 Logfile - optional</h4></p>
376<p>
377Records of BNC's activities are shown in the 'Log' tab on the bottom of the main window. These logs can be saved into a file when a valid path is specified in the 'Logfile (full path)' field. The logfile name will automatically be extended by a string '_YYMMDD' carrying the current date. This leads to series of daily logfiles when running BNC continuously for extended. Message logs cover the communication status between BNC and the NTRIP Broadcaster as well as problems that may occur in the communication link, stream availability, stream delay, stream conversion etc. All times are given in UTC. The default value for 'Logfile (full path)' is an empty option field, meaning that BNC logs will not saved into a file.
378</p>
379
380<p><a name="genapp"><h4>4.3.2 Append Files - optional</h4></p>
381<p>
382When BNC is started, new files are created by default and any existing files with the same name will be overwritten. However, users might want to append existing files following a restart of BNC, a system crash or when BNC crashed. Tick 'Append files' to continue with existing files and keep what has been recorded so far. Note that option 'Append files' affects all types of files created by BNC.
383</p>
384
385<p><a name="genconf"><h4>4.3.3 Reread Configuration - optional</h4></p>
386<p>
387When operating BNC online in 'no window' mode (command line option -nw), some configuration options can nevertheless be changed on-the-fly without interrupting the running process. For that you force the program to reread parts of its configuration in pre-defined intervals from the disk. Select '1 min', '1 hour', or '1 day' to let BNC reread on-the-fly changeable configuration options every full minute, hour, or day. This lets in between edited options become effective without interrupting uninvolved threads. See annexed section 'Configuration Examples' for a configuration file example and a list of on-the-fly changeable options.
388</p>
389
390<p><a name="genstart"><h4>4.3.4 Auto Start - optional</h4></p>
391<p>
392You may like to auto-start BNC at startup time in window mode with pre-assigned configuration options. This may be required i.e. immediately after booting your system. Tick 'Auto start' to supersede the usage of the 'Start' button. Make sure that you maintain a link to BNC for that in your Autostart directory (Windows systems) or call BNC in a script below directory /etc/init.d (Unix/Linux/Mac systems).
393</p>
394<p>
395 See BNC's command line option -nw for an auto-start of BNC in 'no window' mode.
396</p>
397
398<p><a name="rawout"><h4>4.3.5 Raw Output File - optional</h4></p>
399<p>
400BNC can save all data coming in through various streams in one daily file. The information is recorded in the specified 'Raw output file' in the received order and format. This feature allows a BNC user to run the PPP option offline with observations, Broadcast Corrections, and Broadcast Ephemeris being read from a previously saved file. It supports the offline repetition of a real-time situation for debugging purposes. It is not meant for post-processing.
401</p>
402<p>
403Data will be saved in blocks in the received format separated by ASCII time stamps like (example):
404<pre>
4052010-08-03T18:05:28 RTCM3EPH RTCM_3 67
406</pre>
407This example block header tells you that 67 bytes were saved in the data block following this time stamp. The information in this block is encoded in RTCM Version 3 format, comes from mountpoint RTCM3EPH and was received at 18:05:29 UTC on 2010-08-03. BNC adds its own time stamps in order to allow the reconstruction of a recorded real-time situation.
408</p>
409<p>
410The default value for 'Raw output file' is an empty option field, meaning that BNC will not save all raw data into one single daily file.
411</p>
412
413<p><a name="rinex"><h4>4.4. RINEX Observations</h4></p>
414<p>
415Observations will be converted to RINEX if they come in either RTCM Version 2 or RTCM Version 3 format. Depending on the RINEX version and incoming RTCM message types, the files generated by BNC may contain data from GPS, GLONASS, Galileo, SBAS, QZSS, and COMPASS. In case an observation type is listed in the RINEX header but the corresponding observation is unavailable, its value is set to zero '0.000'. Note that the 'RINEX TYPE' field in the RINEX Version 3 Observation file header is always set to 'M(MIXED)' or 'Mixed' even if the file only contains data from one system.
416</p>
417
418<p>
419The screenshot below shows an example setup of BNC when converting streams to RINEX. Streams are coming from various NTRIP Broadcasters as well as from a serial communication link. Specifying a decoder string 'ZERO' would have meant to not convert the affected stream contents but save its contents as received.
420</p>
421<p><img src="IMG/screenshot16.png"/></p>
422<p><u>Figure 6:</u> BNC translating incoming streams to 15 min RINEX Version 3 files.</p>
423
424<p><a name="rnxname"><h4>4.4.1 RINEX File Names</h4></p>
425<p>
426RINEX file names are derived by BNC from the first 4 characters of the corresponding stream's mountpoint (4Char Station ID). For example, data from mountpoints FRANKFURT and WETTZELL will have hourly RINEX Observation files named</p>
427<p>
428FRAN{ddd}{h}.{yy}O<br>
429WETT{ddd}{h}.{yy}O
430</p>
431<p>
432where 'ddd' is the day of year, 'h' is a letter which corresponds to an hour long UTC time block and 'yy' is the year.
433</p>
434<p>
435If there are more than one stream with identical 4Char Station ID (same first 4 characters for their mountpoints), the mountpoint strings are split into two sub-strings and both become part of the RINEX file name. For example, when simultaneously retrieving data from mountpoints FRANKFURT and FRANCE, their hourly RINEX Observation files are named as</p>
436<p>
437FRAN{ddd}{h}_KFURT.{yy}O<br>
438FRAN{ddd}{h}_CE.{yy}O.
439</p>
440<p>
441If several streams show exactly the same mountpoint name (example: BRUS0 from <u>www.euref-ip.net</u> and BRUS0 from <u>www.igs-ip.net</u>), BNC adds an integer number to the file name leading i.e. to hourly RINEX Observation files like</p>
442<p>
443BRUS{ddd}{h}_0.{yy}O<br>
444BRUS{ddd}{h}_1.{yy}O.
445</p>
446<p>
447Note that RINEX file names for all intervals less than 1 hour follow the file name convention for 15 minutes RINEX Observation files i.e.</p>
448<p>
449FRAN{ddd}{h}{mm}.{yy}O
450</p>
451<p>
452where 'mm' is the starting minute within the hour.
453</p>
454
455<p><a name="rnxdir"><h4>4.4.2 Directory - optional</h4></p>
456<p>
457Here you can specify the path to where the RINEX Observation files will be stored. If the specified directory does not exist, BNC will not create RINEX Observation files. Default value for 'Directory' is an empty option field, meaning that no RINEX Observation files will be written.
458</p>
459
460<p><a name="rnxinterval"><h4>4.4.3 File Interval - mandatory if 'Directory' is set</h4></p>
461<p>
462Select the length of the RINEX Observation file generated. The default value is 15 minutes.
463</p>
464
465<p><a name="rnxsample"><h4>4.4.4 Sampling - mandatory if 'Directory' is set </h4></p>
466<p>
467Select the RINEX Observation sampling interval in seconds. A value of zero '0' tells BNC to store all received epochs into RINEX. This is the default value.
468</p>
469
470<p><a name="rnxskl"><h4>4.4.5 Skeleton Extension - optional</h4></p>
471<p>
472Whenever BNC starts generating RINEX Observation files (and then once every day at midnight), it first tries to retrieve information needed for RINEX headers from so-called public RINEX header skeleton files which are derived from sitelogs. A HTTP link to a directory containing these skeleton files may be available through data field number 7 of the affected NET record in the source-table. See <u>http://www.epncb.oma.be:80/stations/log/skl/brus.skl</u> for an example of a public RINEX Version 2 header skeleton file for the Brussels EPN station.
473</p>
474<p>
475However, sometimes public RINEX header skeleton files are not available, its contents is not up to date, or you need to put additional/optional records in the RINEX header. For that BNC allows using personal skeleton files that contain the header records you would like to include. You can derive a personal RINEX header skeleton file from the information given in an up to date sitelog. A file in the RINEX Observations 'Directory' with a 'Skeleton extension' suffix is interpreted by BNC as a personal RINEX header skeleton file for the corresponding stream.
476</p>
477<p>
478Examples for personal skeleton file name convention: RINEX Observation files for mountpoints WETTZELL, FRANKFURT and FRANCE (same 4Char Station ID), BRUS0 from <u>www.euref-ip.net</u> and BRUS0 from <u>www.igs-ip.net</u> (same 4Char Station ID, identical mountpoint stings) would accept personal skeleton files named</p>
479<p>
480WETT.skl<br>
481FRAN_KFURT.skl<br>
482FRAN_CE.skl<br>
483BRUS_0.skl<br>
484BRUS_1.skl</p>
485<p>
486if 'Skeleton extension' is set to 'skl'.
487</p>
488<p>
489Note the following regulations regarding personal RINEX header skeleton files:
490<ul>
491<li>If such a file exists in the 'RINEX directory', the corresponding public RINEX header skeleton file is ignored. The RINEX header is generated solely from the contents of the personal skeleton.</li>
492<li>Personal skeletons should contain a complete first header record of type
493<br>- &nbsp; RINEX VERSION / TYPE<br>
494Note the small differences mentioned below with regards to RINEX Version 2 and RINEX Version 2 skeletons.</li>
495<li>They should then contain an empty header record of type
496<br>- &nbsp; PGM / RUN BY / DATE<br>
497BNC will complete this line and include it in the RINEX file header.</li>
498<li>They should further contain complete header records of type
499<br>- &nbsp; MARKER NAME
500<br>- &nbsp; OBSERVER / AGENCY
501<br>- &nbsp; REC # / TYPE / VERS
502<br>- &nbsp; ANT # / TYPE
503<br>- &nbsp; APPROX POSITION XYZ
504<br>- &nbsp; ANTENNA: DELTA H/E/N
505<br>- &nbsp; WAVELENGTH FACT L1/2 (RINEX Version 2)</li>
506<li>They may contain any other optional complete header record as defined in the RINEX documentation.</li>
507<li>They should then contain empty header records of type
508<br>- &nbsp; # / TYPES OF OBSERV (RINEX Version 2)
509<br>- &nbsp; SYS/ # / OBS TYPES (RINEX Version 3)
510<br>- &nbsp; TIME OF FIRST OBS
511<br>BNC will include these lines in the final RINEX file header together with an additional
512<br>- &nbsp; COMMENT
513<br>line describing the source of the stream.</li>
514<li>They should finally contain an empty header record of type
515<br>- &nbsp; END OF HEADER (last record)</li>
516</ul>
517<p>
518If neither a public nor a personal RINEX header skeleton file is available for BNC, a default header will be used.
519</p>
520
521<p><a name="rnxscript"><h4>4.4.6 Script - optional</h4></p>
522<p>
523Whenever a RINEX Observation file is saved, you might want to compress copy or upload it immediately via FTP. BNC allows you to execute a script/batch file to carry out these operations. To do that specify the full path of the script/batch file here. BNC will pass the RINEX Observation file path to the script as a command line parameter (%1 on Windows systems, $1 on Unix/Linux/Mac systems).
524</p>
525<p>
526The triggering event for calling the script or batch file is the end of a RINEX Observation file 'Interval'. If that is overridden by a stream outage, the triggering event is the stream reconnection.
527</p>
528<p>
529As an alternative to initiating file uploads through BNC, you may like to call an upload script or batch file through your crontable or Task Scheduler (independent from BNC) once every one or two minutes after the end of each RINEX file 'Interval'.
530</p>
531
532<p><a name="rnxvers"><h4>4.4.7 Version - optional</h4></p>
533<p>
534The default format for RINEX Observation files is RINEX Version 2.11. Select 'Version 3' if you would like to save observations in RINEX Version 3 format.
535</p>
536
537<p><a name="ephemeris"><h4>4.5. RINEX Ephemeris</h4></p>
538<p>
539Broadcast ephemeris can be saved as RINEX Navigation files when received via RTCM Version 3 e.g. as message types 1019 (GPS) or 1020 (GLONASS) or 1045 (Galileo). The file name convention follows the details given in section 'RINEX File Names' except that the first four characters are 'BRDC' and the last character is
540</p>
541<ul>
542<li>'N' or 'G' for GPS or GLONASS ephemeris in two separate RINEX Version 2.11 Navigation files, or</li>
543<li>'P' for GPS plus GLONASS plus Galileo ephemeris saved together in one RINEX Version 3 Navigation file.
544</ul>
545
546<p>
547Note that streams dedicated to carry Broadacst Ephemeris messages in RTCM Version 3 format in high repetition rates are listed on <u>http://igs.bkg.bund.de/ntrip/ephemeris</u>.
548</p>
549
550<p><a name="ephdir"><h4>4.5.1 Directory - optional</h4></p>
551<p>
552Specify a path for saving Broadcast Ephemeris data as RINEX Navigation files. If the specified directory does not exist, BNC will not create RINEX Navigation files. Default value for Ephemeris 'Directory' is an empty option field, meaning that no RINEX Navigation files will be created.
553</p>
554
555<p><a name="ephint"><h4>4.5.2 Interval - mandatory if 'Directory' is set</h4></p>
556<p>
557Select the length of the RINEX Navigation file generated. The default value is 1 day.
558</p>
559
560<p><a name="ephport"><h4>4.5.3 Port - optional</h4></p>
561<p>
562BNC can output Broadcast Ephemeris in RINEX Version 3 format on your local host (IP 127.0.0.1) through an IP 'Port'. Specify an IP port number to activate this function. The default is an empty option field, meaning that no ASCII ephemeris output via IP port is generated.
563</p>
564<p>
565The source code for BNC comes with an example perl script 'test_tcpip_client.pl' that allows you to read BNC's ASCII ephemeris output from the IP port.
566</p>
567
568<p><a name="ephvers"><h4>4.5.4 Version - optional</h4></p>
569<p>
570Default format for RINEX Navigation files containing Broadcast Ephemeris is RINEX Version 2.11. Select 'Version 3' if you want to save the ephemeris in RINEX Version 3 format.
571</p>
572<p>
573Note that this does not concern the Broadcast Ephemeris output through IP port which is always in RINEX Version 3 format.
574</p>
575
576<p><a name="reqc"><h4>4.6. RINEX Editing & QC</h4></p>
577<p>
578Besides stream conversion from RTCM to RINEX, BNC allows editing RINEX files or concatenate their contents. RINEX observation and navigation files can be handled. BNC can also carry out a RINEX file contents quality check. In summary this functionality in BNC covers
579<ul>
580<li>stream <u>T</u>ranslation</li>
581<li>file <u>E</u>diting and concatenation</li>
582<li>file <u>Q</b></u>uality <u>C</u>heck</li>
583</ul>
584and hence follows UNAVCO's famous 'TEQC' program. The remarkable thing about BNC in this context is that it supports RINEX Version 3 under GNU General Public License.
585
586<p><a name="reqcact"><h4>4.6.1 Action - optional</h4></p>
587<p>Select an action. Options are 'Edit/Concatenate' and 'Analyze'.
588<ul>
589<li>Select 'Edit/Concatenate' if you want to edit RINEX file contents according to options specified under 'Set Edit Options' or if you want to concatenate several RINEX files.</li>
590<li>Select 'Analyze' if you are interested in a quality check of your RINEX file contents.</li>
591</ul>
592</p>
593
594<p><a name="reqcedit"><h4>4.6.2 Set Edit Options - mandatory if 'Edit/Concatenate' is set</h4></p>
595<p>Once the 'Edit/Concatenate' action is selected, you have to 'Set Edit Options'. BNC lets you specify the RINEX version, sampling rate, begin and end of file, operator, comment lines, and marker, antenna, receiver details.
596</p>
597<p>
598When converting RINEX Version 2 to RINEX Version 3, the tracking mode or channel information in the (last character out of the three characters) observation code is left blank if unknown. When converting RINEX Version 3 to RINEX Version 2:
599<ul>
600<li>C1P in RINEX Version 3 is mapped to P1 in RINEX Version 2</li>
601<li>C2P in RINEX Version 3 is mapped to P2 in RINEX Version 2</li>
602<li>If several observations in RINEX Version 3 come with the same observation type, same band/frequency but different tracking modes, BNC uses only the one provided first for creating RINEX Version 2 while ignoring others.</li>
603</ul>
604</p>
605<p>Optionally you may specify a comment line text to be added to the emerging new RINEX file header. Any introduction of a newline through '\n' in this enforces the beginning of a further comment line. Comment line(s) will be added to the header after the 'PGM / RUN BY / DATE' record. Default is an empty option field meaning that no additional comment line is added to the RINEX header.</p>
606 <p>Specifying a 'RUN BY' string to be included in the emerging new RINEX file header is another option. Default is an empty option field meanig the operator's ID is automatically used as 'RUN BY' string.</p>
607<p>
608If you specify a 'New' but no 'Old' marker/antenna/receiver name, the corresponding data field in the emerging new RINEX file will be filled accordingly. If you in addition specify an 'Old' marker/antenna/receiver name, the corresponding data field in the emerging new RINEX file will only be filled accordingly where 'Old' specifications match existing file contents.
609</p>
610
611<p><img src="IMG/screenshot27.png"/></p>
612<p><u>Figure 7:</u> Example for 'RINEX Editing Options' window.</p>
613
614<p><a name="reqcinput"><h4>4.6.3 Input Files - mandatory if 'Action' is set</h4></p>
615<p>
616Specify full path to input RINEX observation file(s), and<br>
617specify full path to input RINEX navigation file(s).
618</p>
619<p>When specifying several input files BNC will concatenate their contents.</p>
620
621<p><a name="reqcoutput"><h4>4.6.4 Output Files - mandatory if 'Action' is set</h4></p>
622<p>
623If 'Edit/Concatenate' is selected, specifying the a path to output RINEX observation file(s) and specifying a full path to output RINEX navigation file(s) is mandatory.</p>
624
625<p>
626If if 'Analyze' is selected, specifying logfile(s) to output analysis results is mandatory.<br>
627</p>
628
629<p><img src="IMG/screenshot25.png"/></p>
630<p><u>Figure 7:</u> Example for RINEX file editing with BNC in post-processing mode.</p>
631
632<p><a name="reqccommand"><h4>4.6.5 Command Line, No Window - optional</h4></p>
633<p>
634BNC applies options from the configuration file but allows updating every one of them on the command line while the contents of the configuration file remains unchanged, see section on 'Command Line Options'. The syntax for that looks as follows
635</p>
636<p>
637--key &lt;keyName&gt; &lt;keyValue&gt;
638</p>
639<p>
640where &lt;keyName&gt; stands for the name of an option contained in the configuration file and &lt;keyValue&gt; stands for the value you want to assign to it. This functionality may be helpful in the 'RINEX Editing & QC' context when running BNC on a routine basis for maintaining a RINEX file archive.
641</p>
642The following example for a Linux platform calls BNC in 'no window' mode with a local configuration file 'rnx.conf' for concatenating four 15min RINEX files residing in the local directory to produce an hourly RINEX Version 3 file with 30 seconds sampling rate:
643</p>
644<p>
645./bnc --nw --conf rnx.conf --key reqcAction Edit/Concatenate --key reqcObsFile "tlse119b00.12o,tlse119b15.12o,tlse119b30.12o,tlse119b45.12o" --key reqcOutObsFile tlse119b.12o --key reqcRnxVersion 3 --key reqcSampling 30
646</p>
647<p>
648You may use asterisk '*' and/or question mark '?' wildcard characters as shown with the following globbing command line option to specify a selection of files in a local directory:
649</p>
650<p>
651--key reqcObsFile "tlse*"<br>
652or:<br>
653--key reqcObsFile tlse\*
654</p>
655
656<p>
657The following is a list of available keynames for '<u>R</u>INEX <u>E</u>diting & <u>QC</u>' (short: REQC, pronounced 'rek') options and their meaning, cf. section 'Configuration Examples':
658</p>
659
660<table>
661<tr></tr>
662<tr><td><b>Keyname</b></td><td><b>Meaning</b></td></tr>
663<tr><td>reqcAction</td><td>RINEX Editing & QC action</td></tr>
664<tr><td>reqcObsFile</td><td>RINEX observation input file(s)</td></tr>
665<tr><td>reqcNavFile</td><td>RINEX navigation input files(s)</td></tr>
666<tr><td>reqcOutObsFile</td><td>RINEX observation output file</td></tr>
667<tr><td>reqcOutNavFile</td><td>RINEX navigation output file</td></tr>
668<tr><td>reqcOutLogFile</td><td>Logfile</td></tr>
669<tr><td>reqcRnxVersion</td><td>RINEX version of emerging new file</td></tr>
670<tr><td>reqcSampling</td><td>Sampling rate of emerging new RINEX file</td></tr>
671<tr><td>reqcStartDateTime</td><td>Begin of emerging new RINEX file</td></tr>
672<tr><td>reqcEndDateTime</td><td>End of emerging new RINEX file</td></tr>
673<tr><td>reqcRunBy</td><td>Operator name</td></tr>
674<tr><td>reqcComment</td><td>Additional comment lines</td></tr>
675<tr><td>reqcOldMarkerName</td><td>Old marker name</td></tr>
676<tr><td>reqcNewMarkerName</td><td>New marker name</td></tr>
677<tr><td>reqcOldAntennaName</td><td>Old antenna name</td></tr>
678<tr><td>reqcNewAntennaName</td><td>New antenna name</td></tr>
679<tr><td>reqcOldReceiverName</td><td>Old receiver name</td></tr>
680<tr><td>reqcNewReceiverName</td><td>New receiver name</td></tr>
681</table>
682
683<p><a name="correct"><h4>4.7. Broadcast Corrections</h4></p>
684<p>
685Differential GNSS and RTK operation using RTCM streams is currently based on corrections and/or raw measurements from single or multiple reference stations. This approach to differential positioning is using 'observation space' information. The representation with the RTCM standard can be called 'ObservationSpace Representation' (OSR).
686</p>
687<p>
688An alternative to the observation space approach is the so called 'sate space' approach. The principle here is to provide information on individual error sources. It can be called 'State Space Representation' (SSR). For a rover position, state space information concerning precise satellite clocks, orbits, ionosphere, troposphere et cetera can be converted into observation space and used to correct the rover observables for more accurate positioning. Alternatively the state information can directly be used in the rover's processing or adjustment model.
689</p>
690<p>
691RTCM has developed Version 3 messages to transport satellite clock and orbit corrections in real-time. The current set of messages concerns:
692<ul>
693<li>Orbit corrections to Broadcast Ephemeris</li>
694<li>Clock corrections to Broadcast Ephemeris</li>
695<li>Code biases</li>
696<li>Combined orbit and clock corrections to Broadcast Ephemeris</li>
697<li>User Range Accuracy (URA)</li>
698<li>High-rate GPS clock corrections to Broadcast Ephemeris</li>
699</ul>
700<p>
701RTCM Version 3 streams carrying these messages may be used i.e. to support real-time Precise Point Positioning (PPP) applications.
702</p>
703<p>
704When using clocks from Broadcast Ephemeris (with or without applied corrections) or clocks from SP3 files, it may be important to understand that they are not corrected for the conventional periodic relativistic effect. Chapter 10 of the IERS Conventions 2003 mentions that the conventional periodic relativistic correction to the satellite clock (to be added to the broadcast clock) is computed as dt = -2 (R * V) / c^2 where R * V is the scalar product of the satellite position and velocity and c is the speed of light. This can also be found in the GPS Interface Specification, IS-GPS-200, Revision D, 7 March 2006.
705</p>
706
707<p>
708Orbit corrections are provided in along-track, cross-track and radial components. These components are defined in the Earth-centered, Earth-fixed reference frame of the broadcast ephemerides. For an observer in this frame, the along-track component is aligned in both direction and sign with the velocity vector, the cross-track component is perpendicular to the plane defined by the satellite position and velocity vectors, and the radial direction is perpendicular to the along track and cross-track ones. The three components form a right-handed orthogonal system.
709</p>
710
711<p>
712After applying corrections, the satellite position and clock is referred to the 'ionospheric free' phase center of the antenna which is compatible with the broadcast orbit reference.
713</p>
714
715<p>
716The orbit and clock corrections do not include local effects (like Ocean Loading or Solid Earth Tides) or atmospheric effects (Ionosphere and/or troposphere). Depending on the accuracy of your application you should correct for such effects by other means. There is currently no RTCM SSR message for ionospheric state parameters. Such messages are needed for accurate single frequency applications. The development of Iono messages will be the next step in the schedule of the RTCM State Space Representation Working Group.
717</p>
718
719<p>
720Broadcast Corrections can be saved by BNC in files. The file name convention for Broadcast Correction files follows the convention for RINEX files except for the last character of the file name suffix which is set to &quot;C&quot;.
721</p>
722
723<p>
724Saved files contain blocks of records in plain ASCII format where - separate for each GNSS, message type, stream, and epoch - the begin of a block is indicated by a line like (examples):
725</p>
726<p>
727! Orbits/Clocks: 30 GPS 0 Glonass CLK11<br>
728or<br>
729! Orbits/Clocks: 0 GPS 19 Glonass CLK11
730<p>
731Such line informs you about the number of records (here 30 and 19) carrying GPS or GLONASS related parameters you should receive next.
732</p>
733<p>
734The first five parameters in each Broadcast Corrections record are:
735</p>
736<p>
737<ul>
738<li>RTCM Version 3 message type number</li>
739<li>SSR message update interval indicator</li>
740<ul>
741<li>0 = 1 sec</li>
742<li>1 = 2 sec</li>
743<li>2 = 5 sec</li>
744<li>3 = 10 sec</li>
745<li>4 = 15 sec</li>
746<li>5 = 30 sec</li>
747<li>6 = 60 sec</li>
748<li>7 = 120 sec</li>
749<li>8 = 240 sec</li>
750<li>9 = 300 sec</li>
751<li>10 = 600 sec</li>
752<li>11 = 900 sec</li>
753<li>12 = 1800 sec</li>
754<li>13 = 3600 sec</li>
755<li>14 = 7200 sec</li>
756<li>15 = 10800 sec</li>
757</ul>
758<li>GPS Week</li>
759<li>Second in GPS Week</li>
760<li>GNSS Indicator and Satellite Vehicle Pseudo Random Number</li>
761</ul>
762</p>
763<p>
764In case of RTCM message types 1057 or 1063 (see Annex) these parameters are followed by
765</p>
766<p>
767<ul>
768<li>IOD referring to Broadcast Ephemeris set</li>
769<li>Radial Component of Orbit Correction to Broadcast Ephemeris [m]</li>
770<li>Along-track Component of Orbit Correction to Broadcast Ephemeris [m]</li>
771<li>Cross-track Component of Orbit Correction to Broadcast Ephemeris [m]</li>
772<li>Velocity of Radial Component of Orbit Correction to Broadcast Ephemeris [m/s]</li>
773<li>Velocity of Along-track Component of Orbit Correction to Broadcast Ephemeris [m/s]</li>
774<li>Velocity of Cross-track Component of Orbit Correction to Broadcast Ephemeris [m/s]</li>
775<p>
776</ul>
777</p>
778<p>
779Undefined parameters would be set to zero &quot;0.000&quot;.<br>Example:
780<pre>
781...
7821057 0 1686 283200.0 G02 21 1.062 -0.791 1.070 -0.00025 -0.00031 -0.00005
7831057 0 1686 283200.0 G03 25 1.765 -2.438 -0.290 -0.00009 -0.00060 0.00028
7841057 0 1686 283200.0 G04 14 1.311 -0.862 0.334 0.00005 -0.00038 -0.00015
785
786...
7871063 0 1686 283200.0 R01 39 0.347 1.976 -1.418 0.00048 -0.00091 0.00008
7881063 0 1686 283200.0 R02 39 0.624 -2.092 -0.155 0.00005 -0.00054 0.00053
7891063 0 1686 283200.0 R03 39 0.113 5.655 -1.540 0.00003 -0.00079 -0.00003
7901063 0 1686 283200.0 R05 39 0.237 1.426 -1.282 0.00054 -0.00020 0.00027
791...
792</pre>
793<p>
794In case of RTCM message types 1058 or 1064 (see Annex) the first five parameters are followed by
795</p>
796<ul>
797<li>IOD set to zero &quot;0&quot;</li>
798<li>C0 polynomial coefficient for Clock Correction to Broadcast Ephemeris [m]</li>
799<li>C1 polynomial coefficient for Clock Correction to Broadcast Ephemeris [m/s]</li>
800<li>C2 polynomial coefficient for Clock Correction to Broadcast Ephemeris [m/s**2]</li>
801</ul>
802Example:
803</p>
804<pre>
805...
8061058 0 1538 211151.0 G18 0 1.846 0.000 0.000
8071058 0 1538 211151.0 G16 0 0.376 0.000 0.000
8081058 0 1538 211151.0 G22 0 2.727 0.000 0.000
809...
8101064 0 1538 211151.0 R08 0 8.956 0.000 0.000
8111064 0 1538 211151.0 R07 0 14.457 0.000 0.000
8121064 0 1538 211151.0 R23 0 6.436 0.000 0.000
813...
814</pre>
815</p>
816<p>
817In case of RTCM message types 1060 or 1066 (see Annex) the first five parameters are followed by
818<p>
819<ul>
820<li>IOD referring to Broadcast Ephemeris set</li>
821<li>C0 polynomial coefficient for Clock Correction to Broadcast Ephemeris [m]</li>
822<li>Radial Component of Orbit Correction to Broadcast Ephemeris [m]</li>
823<li>Along-track Component of Orbit Correction to Broadcast Ephemeris [m]</li>
824<li>Cross-track Component of Orbit Correction to Broadcast Ephemeris [m]</li>
825<li>C1 polynomial coefficient for Clock Correction to Broadcast Ephemeris [m]</li>
826<li>Velocity of Radial Component of Orbit Correction to Broadcast Ephemeris [m/s]</li>
827<li>Velocity of Along-track Component of Orbit Correction to Broadcast Ephemeris [m/s]</li>
828<li>Velocity of Cross-track Component of Orbit Correction to Broadcast Ephemeris [m/s]</li>
829<li>C2 polynomial coefficient for Clock Correction to Broadcast Ephemeris [m]</li>
830</ul>
831Example:
832</p>
833<pre>
834...
8351060 0 1538 211610.0 G30 82 2.533 0.635 -0.359 -0.598 0.000 0.000 0.000 0.000 0.000
8361060 0 1538 211610.0 G31 5 -4.218 -0.208 0.022 0.002 0.000 0.000 0.000 0.000 0.000
8371060 0 1538 211610.0 G32 28 -2.326 0.977 -0.576 0.142 0.000 0.000 0.000 0.000 0.000
838...
8391066 0 1538 211610.0 R22 27 1.585 2.024 2.615 -2.080 0.000 0.000 0.000 0.000 0.000
8401066 0 1538 211610.0 R23 27 6.277 2.853 4.181 1.304 0.000 0.000 0.000 0.000 0.000
8411066 0 1538 211610.0 R24 27 0.846 1.805 13.095 6.102 0.000 0.000 0.000 0.000 0.000
842...
843</pre>
844</p>
845<p>
846In case of RTCM message types 1059 or 1065 (see Annex) the first five parameters are followed by
847<ul>
848<li>Number of Code Biases</li>
849<li>Indicator to specify the signal and tracking mode</li>
850<li>Code Bias</li>
851<li>Indicator to specify the signal and tracking mode</li>
852<li>Code Bias</li>
853<li>etc.</li>
854</ul>
855Example:
856</p>
857<pre>
858...
8591059 0 1538 211151.0 G18 2 0 -0.010 11 -0.750
8601059 0 1538 211151.0 G16 2 0 -0.040 11 -0.430
8611059 0 1538 211151.0 G22 2 0 -0.630 11 -2.400
862...
863</pre>
864
865<p><a name="corrdir"><h4>4.7.1 Directory, ASCII - optional</h4></p>
866<p>
867Specify a directory for saving Broadcast Corrections in files. If the specified directory does not exist, BNC will not create Broadcast Correction files. Default value for Broadcast Corrections 'Directory' is an empty option field, meaning that no Broadcast Correction files will be created.
868</p>
869
870<p><a name="corrint"><h4>4.7.2 Interval - mandatory if 'Directory, ASCII' is set</h4></p>
871<p>
872Select the length of the Broadcast Correction files. The default value is 1 day.
873</p>
874
875<p><a name="corrport"><h4>4.7.3 Port - optional</h4></p>
876<p>
877BNC can output epoch by epoch synchronized Broadcast Corrections in ASCII format on your local host (IP 127.0.0.1) through an IP 'Port'. Specify an IP port number to activate this function. The default is an empty option field, meaning that no Broadcast Correction output via IP port is generated.
878</p>
879<p>
880The output format equals the format used for saving Broadcast Corrections in a file with the exception that the Mountpoint is added at each line's end.
881</p>
882<p>
883The following is an example output for streams from mountpoints RTCMSSR, CLK10 and CLK11:
884<pre>
885...
8861057 0 1538 211151.0 G18 1 0.034 0.011 -0.064 0.000 0.000 0.000 RTCMSSR
8871057 0 1538 211151.0 G16 33 -0.005 0.194 -0.091 0.000 0.000 0.000 RTCMSSR
8881057 0 1538 211151.0 G22 50 0.008 -0.082 -0.001 0.000 0.000 0.000 RTCMSSR
889...
8901058 0 1538 211151.0 G18 0 1.846 0.000 RTCMSSR
8911058 0 1538 211151.0 G16 0 0.376 0.000 RTCMSSR
8921058 0 1538 211151.0 G22 0 2.727 0.000 RTCMSSR
893...
8941059 0 1538 211151.0 G18 2 0 -0.010 11 -0.750 RTCMSSR
8951059 0 1538 211151.0 G16 2 0 -0.040 11 -0.430 RTCMSSR
8961059 0 1538 211151.0 G22 2 0 -0.630 11 -2.400 RTCMSSR
897...
8981063 0 1538 211151.0 R09 111 -0.011 -0.014 0.005 0.0000 0.000 0.000 RTCMSSR
8991063 0 1538 211151.0 R10 43 0.000 -0.009 -0.002 0.0000 0.000 0.000 RTCMSSR
9001063 0 1538 211151.0 R21 75 -0.029 0.108 0.107 0.0000 0.000 0.000 RTCMSSR
901...
9021064 0 1538 211151.0 R08 0 8.956 0.000 RTCMSSR
9031064 0 1538 211151.0 R07 0 14.457 0.000 RTCMSSR
9041064 0 1538 211151.0 R23 0 6.436 0.000 RTCMSSR
905...
9061066 0 1538 211610.0 R24 27 0.846 1.805 13.095 6.102 0.000 0.000 0.000 0.000 0.000 CLK11
9071066 0 1538 211610.0 R23 27 6.277 2.853 4.181 1.304 0.000 0.000 0.000 0.000 0.000 CLK11
9081066 0 1538 211610.0 R22 27 1.585 2.024 2.615 -2.080 0.000 0.000 0.000 0.000 0.000 CLK11
909...
9101060 0 1538 211610.0 G32 28 -2.326 0.977 -0.576 0.142 0.000 0.000 0.000 0.000 0.000 CLK10
9111060 0 1538 211610.0 G31 5 -4.218 -0.208 0.022 0.002 0.000 0.000 0.000 0.000 0.000 CLK10
9121060 0 1538 211610.0 G30 82 2.533 0.635 -0.359 -0.598 0.000 0.000 0.000 0.000 0.000 CLK10
913...
914</pre>
915</p>
916<p>
917The source code for BNC comes with an example perl script 'test_tcpip_client.pl' that allows you to read BNC's Broadcast Corrections from the IP port.
918</p>
919
920<p><a name="corrwait"><h4>4.7.4 Wait for Full Epoch - mandatory if 'Port' is set</h4></p>
921<p>
922When feeding a real-time GNSS network engine waiting epoch by epoch for synchronized Broadcast Corrections, BNC drops (only concerning IP port output) whatever is received later than 'Wait for full epoch' seconds. A value of 2 to 5 seconds could be an appropriate choice for that, depending on the latency of the incoming Broadcast Corrections stream and the delay acceptable by your application. A message such as &quot;COCK1: Correction overaged by 5 sec&quot; shows up in BNC's logfile if 'Wait for full epoch' is exceeded.
923</p>
924<p>
925Specifying a value of '0' means that BNC immediately outputs all incoming Broadcast Ephemeris Corrections and does not drop any of them for latency reasons.
926</p>
927
928<p><a name="syncout"><h4>4.8. Feed Engine</h4></p>
929<p>
930BNC can generate synchronized or unsynchronized observations epoch by epoch from all stations and satellites to feed a real-time GNSS network engine. Observations can be streamed out through an IP port and/or saved in a local file. The output is always in plain ASCII format and comprises the following parameters:
931</p>
932<p>
933StationID | GPSWeek | GPSWeekSec | PRN, G=GPS, R=GLO | SlotNumber (if GLO) | Band/Frequency & trackingMode | Code | Phase | Doppler | SNR | SlipCount | ....
934</p>
935<p>
936In case an observation is not available, its value is set to zero '0.000'.
937</p>
938<p>Note on 'SlipCount':<br>
939It is the current understanding of BNC's authors that different slip counts could be referred to different phase measurements (i.e. L1C and L1P). The 'loss-of-lock' flags in RINEX are an example for making such kind of information available per phase measurement. However, it looks like we do have only one slip count in RTCM Version 3 for all phase measurements. As it could be that a receiver generates different slip counts for different phase measurements, we output one slip count per phase measurement to a listening real-time GNSS network engine.
940</p>
941
942<p>
943The following is an output example for GPS and GLONASS:
944<pre>
945...
946CUT07 1683 493688.0000000 G05 1C 24584925.242 129195234.317 3639.020 38.812 40 2P 24584927.676 100671636.233 0.0 22.812 -1 2X 24584927.336 100671611.239 0.0 39.500 -1
947CUT07 1683 493688.0000000 G04 1C 22598643.968 118756563.731 -1589.277 42.625 40 2P 22598649.391 92537559.230 0.0 29.125 -1
948CUT07 1683 493688.0000000 G02 1C 23290004.062 122389588.008 -445.992 46.375 -1 2P 23290003.567 95368508.986 0.0 29.188 -1
949
950CUT07 1683 493689.0000000 R16 -1 1C 19210052.313 102616872.230 364.063 53.375 42 1P 19210053.445 102616393.224 0.0 52.312 42 2P 19210057.785 79813218.557 0.0 50.188 -1
951CUT07 1683 493689.0000000 R15 0 1C 20665491.149 110430900.266 -2839.875 49.188 -1 1P 20665491.695 110430900.278 0.0 47.625 -1 2P 20665497.559 85890714.522 0.0 48.000 -1
952CUT07 1683 493689.0000000 R09 -2 1C 22028400.805 117630697.367 3584.840 47.625 -1 1P 22028401.586 117630607.367 0.0 45.688 -1 2P 22028406.746 91490549.182 0.0 41.625 -1
953CUT07 1683 493689.0000000 R07 5 1C 24291127.360 130032400.255 4146.149 40.125 42 1P 24291128.492 130032400.259 0.0 39.312 42 2P 24291130.602 101136710.408 0.0 35.125 -1
954CUT07 1683 493689.0000000 R05 1 1C 19740809.867 105526251.571 -921.679 54.125 42 1P 19740809.008 105526273.586 0.0 51.875 42 2P 19740814.051 82075815.588 0.0 50.812 -1
955CUT07 1683 493689.0000000 R04 6 1C 23394651.125 125277095.951 -3385.191 40.875 42 1P 23394651.906 125277095.943 0.0 39.812 42 2P 23394658.125 97437771.004 0.0 39.000 -1
956CUT07 1683 493689.0000000 G28 1C 25286905.648 132883677.970 4016.750 36.125 17 2P 25286911.715 103545663.916 0.0 14.812 11
957CUT07 1683 493689.0000000 G23 1C 23018013.274 120961034.323 -1795.551 46.375 -1 2P 23018011.781 94255379.472 0.0 31.688 -1
958CUT07 1683 493689.0000000 G20 1C 24055613.563 126413402.503 -3233.574 38.500 -1 2P 24055617.227 98504065.103 0.0 20.125 -1
959CUT07 1683 493689.0000000 G16 1C 24846810.039 130571661.274 -2140.137 38.000 41 2P 24846811.477 101744166.486 0.0 18.625 -1
960CUT07 1683 493689.0000000 G13 1C 21388182.664 112395102.592 -678.356 51.812 -1 2P 21388183.516 87580617.458 0.0 39.688 -1
961CUT07 1683 493689.0000000 G10 1C 20656684.758 108551288.049 1726.191 52.875 -1 2P 20656687.016 84585420.340 0.0 42.625 -1
962CUT07 1683 493689.0000000 G08 1C 20703057.860 108795261.566 1880.523 52.875 -1 2P 20703060.644 84775535.497 0.0 41.188 -1
963CUT07 1683 493689.0000000 G07 1C 20200125.289 106152257.500 -603.082 53.312 41 2P 20200126.961 82716251.449 0.0 46.000 -1 2X 20200126.797 82716243.452 0.0 52.625 -1
964CUT07 1683 493689.0000000 G05 1C 24584232.312 129191595.301 3639.047 38.875 41 2P 24584234.980 100668800.633 0.0 22.875 -1 2X 24584234.348 100668775.639 0.0 39.812 -1
965CUT07 1683 493689.0000000 G04 1C 22598946.500 118758153.159 -1589.461 42.500 41 2P 22598951.570 92538797.744 0.0 29.125 -1
966CUT07 1683 493689.0000000 G02 1C 23290088.758 122390034.211 -446.429 46.312 -1 2P 23290088.203 95368856.681 0.0 28.500 -1
967
968CUT07 1683 493690.0000000 R16 -1 1C 19209984.633 102616508.497 363.305 53.500 43 1P 19209985.180 102616029.506 0.0 51.812 43 2P 19209989.871 79812935.655 0.0 50.188 -1
969CUT07 1683 493690.0000000 R15 0 1C 20666023.047 110433740.264 -2840.242 49.188 -1 1P 20666023.945 110433740.275 0.0 47.500 -1 2P 20666029.574 85892923.403 0.0 47.625 -1
970CUT07 1683 493690.0000000 R09 -2 1C 22027730.398 117627112.720 3584.305 47.688 -1 1P 22027730.828 117627022.726 0.0 46.188 -1 2P 22027735.988 91487761.121 0.0 41.688 -1
971...
972</pre>
973<p>
974The source code for BNC comes with a perl script called 'test_tcpip_client.pl' that allows you to read BNC's (synchronized or unsynchronized) ASCII observation output from the IP port and print it on standard output.
975</p>
976<p>
977Note that any socket connection of an application to BNC's synchronized or unsynchronized observations ports is recorded in the 'Log' tab on the bottom of the main window together with a connection counter, resulting in log records like 'New client connection on sync/usync port: # 1'.
978</p>
979
980<p>
981The following figure shows the screenshot of a BNC configuration where a number of streams is pulled from different NTRIP Broadcasters to feed a GNSS engine via IP port output.
982</p>
983<p><img src="IMG/screenshot12.png"/></p>
984<p><u>Figure 8:</u> Synchronized BNC output via IP port to feed a GNSS real-time engine.</p>
985
986<p><a name="syncport"><h4>4.8.1 Port - optional</h4></p>
987<p>
988BNC can produce synchronized observations in ASCII format on your local host (IP 127.0.0.1) through an IP 'Port'. Synchronized means that BNC collects all data for any specific epoch which become available within a certain number of latency seconds (see 'Wait for Full Epoch' option). It then - epoch by epoch - outputs whatever has been received. Specify an IP port number here to activate this function. The default is an empty option field, meaning that no binary synchronized output is generated.</p>
989</p>
990
991<p><a name="syncwait"><h4>4.8.2 Wait for Full Epoch - mandatory if 'Port' is set</h4></p>
992<p>
993When feeding a real-time GNSS network engine waiting for synchronized input epoch by epoch, BNC drops whatever is received later than 'Wait for full epoch' seconds. A value of 3 to 5 seconds could be an appropriate choice for that, depending on the latency of the incoming streams and the delay acceptable for your real-time GNSS product. Default value for 'Wait for full epoch' is 5 seconds.
994</p>
995<p>
996Note that 'Wait for full epoch' does not affect the RINEX Observation file content. Observations received later than 'Wait for full epoch' seconds will still be included in the RINEX Observation files.
997</p>
998
999<p><a name="syncsample"><h4>4.8.3 Sampling - mandatory if 'File' or 'Port' is set</h4></p>
1000<p>
1001Select the synchronized observation output sampling interval in seconds. A value of zero '0' tells BNC to send/store all received epochs. This is the default value.
1002</p>
1003
1004<p><a name="syncfile"><h4>4.8.4 File - optional</h4></p>
1005<p>
1006Specifies the full path to a 'File' where synchronized observations are saved in plain ASCII format. The default value is an empty option field, meaning that no ASCII output file is created.
1007</p>
1008<p>
1009Beware that the size of this file can rapidly increase depending on the number of incoming streams. This option is primarily meant for testing and evaluation.
1010</p>
1011
1012<p><a name="syncuport"><h4>4.8.5 Port (unsynchronized) - optional</h4></p>
1013<p>
1014BNC can produce unsynchronized observations from all configured streams in ASCII format on your local host (IP 127.0.0.1) through an IP 'Port'. Unsynchronized means that BNC immediately forwards any received observation to the port. Specify an IP port number here to activate this function. The default is an empty option field, meaning that no binary unsynchronized output is generated.</p>
1015<p>
1016
1017<p><a name="serial"><h4>4.9. Serial Output</h4></p>
1018<p>
1019You may use BNC to feed a serial connected device like an GNSS receiver. For that an incoming streams can be forwarded to a serial port. The following figure shows the screenshot of an example situation where BNC pulls a VRS stream from an NTRIP Broadcaster to feed a serial connected rover.
1020</p>
1021<p><img src="IMG/screenshot11.png"/></p>
1022<p><u>Figure 9:</u> BNC pulling a VRS stream to feed a serial connected rover.</p>
1023
1024<p><a name="sermount"><h4>4.9.1 Mountpoint - optional</h4></p>
1025<p>
1026Enter a 'Mountpoint' to forward its corresponding stream to a serial connected GNSS receiver.
1027</p>
1028<p>
1029When selecting one of the serial communication options listed below, make sure that you pick those configured to the serial connected receiver.
1030</p>
1031
1032<p><a name="serport"><h4>4.9.2 Port Name - mandatory if 'Mountpoint' is set</h4></p>
1033<p>
1034Enter the serial 'Port name' selected on your host for communication with the serial connected receiver. Valid port names are
1035</p>
1036<pre>
1037Windows: COM1, COM2
1038Linux: /dev/ttyS0, /dev/ttyS1
1039FreeBSD: /dev/ttyd0, /dev/ttyd1
1040Digital Unix: /dev/tty01, /dev/tty02
1041HP-UX: /dev/tty1p0, /dev/tty2p0
1042SGI/IRIX: /dev/ttyf1, /dev/ttyf2
1043SunOS/Solaris: /dev/ttya, /dev/ttyb
1044</pre>
1045<p>
1046Note that you must plug a serial cable in the port defined here before you start BNC.
1047</p>
1048
1049<p><a name="serbaud"><h4>4.9.3 Baud Rate - mandatory if 'Mountpoint' is set</h4></p>
1050<p>
1051Select a 'Baud rate' for the serial output link. Note that using a high baud rate is recommended.
1052</p>
1053
1054<p><a name="serflow"><h4>4.9.4 Flow Control - mandatory if 'Mountpoint' is set</h4></p>
1055<p>
1056Select a 'Flow control' for the serial output link. Note that your selection must equal the flow control configured to the serial connected device. Select 'OFF' if you don't know better.
1057</p>
1058
1059<p><a name="serparity"><h4>4.9.5 Parity - mandatory if 'Mountpoint' is set</h4></p>
1060<p>
1061Select the 'Parity' for the serial output link. Note that parity is often set to 'NONE'.
1062</p>
1063
1064<p><a name="serdata"><h4>4.9.6 Data Bits - mandatory if 'Mountpoint' is set</h4></p>
1065<p>
1066Select the number of 'Data bits' for the serial output link. Note that often '8' data bits are used.
1067</p>
1068
1069<p><a name="serstop"><h4>4.9.7 Stop Bits - mandatory if 'Mountpoint' is set</h4></p>
1070<p>
1071Select the number of 'Stop bits' for the serial output link. Note that often '1' stop bit is used.
1072</p>
1073
1074<p><a name="serauto"><h4>4.9.8 NMEA - mandatory for VRS streams</h4></p>
1075<p>
1076Select 'Auto' to automatically forward all NMEA-GGA messages coming from your serial connected GNSS receiver to the NTRIP Broadcaster and/or save them in a file.
1077</p>
1078<p>
1079Forwarding valid NMEA-GGA messages to the NTRIP Broadcaster is required for receiving 'Virtual Reference Station' (VRS) streams. Thus, in case your serial connected receiver is not capable to provide them, the alternative for VRS streams is a 'Manual' simulation of an initial NMEA-GGA message. Its contents is based on the approximate (editable) latitude/longitude from the broadcaster's source-table and an approximate VRS height to be specified.
1080</p>
1081<p>
1082In summary: select 'Manual' only when handling a VRS stream and your serial connected GNSS receiver doesn't generate NMEA-GGA messages. Select 'Auto' otherwise.
1083</p>
1084
1085<p><a name="serfile"><h4>4.9.9 File - optional if 'Auto' NMEA is set</h4></p>
1086<p>Specify the full path to a file where NMEA messages coming from your serial connected receiver are saved.
1087</p>
1088<p><a name="serheight"><h4>4.9.10 Height - mandatory if 'Manual' NMEA is set</h4></p>
1089<p>
1090Specify an approximate 'Height' above mean sea level in meter for your VRS to simulate an initial NMEA-GGA message. Latitude and longitude for that (editable) are taken from the broadcaster's source-table.
1091</p>
1092<p>
1093This option concerns only 'Virtual Reference Stations' (VRS). Its setting is ignored in case of streams coming from physical reference stations.
1094</p>
1095
1096<p><a name="advnote"><h4>4.10. Outages</h4></p>
1097
1098<p>
1099At any time an incoming stream might become unavailable or corrupted. In such cases, it is important that the BNC operator and/or the stream providers become aware of the situation so that necessary measures can be taken to restore the stream. Furthermore, continuous attempts to decode a corrupted stream can generate unnecessary workload for BNC. Outages and corruptions are handled by BNC as follows:
1100</p>
1101<p>
1102<u>Stream outages:</u> BNC considers a connection to be broken when there are no incoming data detected for more than 20 seconds. When this occurs, BNC will attempt to reconnect at a decreasing rate. It will first try to reconnect with 1 second delay, and again in 2 seconds if the previous attempt failed. If the attempt is still unsuccessful, it will try to reconnect within 4 seconds after the previous attempt and so on. The wait time doubles each time with a maximum wait time of 256 seconds.
1103</p>
1104<p>
1105<u>Stream corruption:</u> Not all bits chunk transfers to BNC's internal decoders return valid observations. Sometimes several chunks might be needed before the next observation can be properly decoded. BNC buffers all the outputs (both valid and invalid) from the decoder for a short time span (size derived from the expected 'Observation rate') and then determines whether a stream is valid or corrupted.
1106</p>
1107<p>
1108Outage and corruption events are reported in the 'Log' tab. They can also be passed on as parameters to a shell script or batch file to generate an advisory note to BNC operator or affected stream providers. This functionality lets users utilize BNC as a real-time performance monitor and alarm system for a network of GNSS reference stations.
1109</p>
1110
1111<p><a name="obsrate"><h4>4.10.1 Observation Rate - mandatory if 'Failure threshold', 'Recovery threshold' and 'Script' is set</h4></p>
1112<p>
1113BNC can collect all returns (success or failure) coming from a decoder within a certain short time span to then decide whether a stream has an outage or its content is corrupted. This procedure needs a rough a priory estimate of the expected observation rate of the incoming streams.</p><p>An empty option field (default) means that you don't want explicit information from BNC about stream outages and incoming streams that cannot be decoded.
1114</p>
1115
1116<p><a name="advfail"><h4>4.10.2 Failure Threshold - optional</h4></p>
1117<p>
1118Event 'Begin_Failure' will be reported if no data is received continuously for longer than the 'Failure threshold' time. Similarly, event 'Begin_Corrupted' will be reported when corrupted data is detected by the decoder continuously for longer than this 'Failure threshold' time. The default value is set to 15 minutes and is recommended so not to inundate user with too many event reports.
1119</p>
1120<p>
1121Note that specifying a value of zero '0' for the 'Failure threshold' will force BNC to report any stream failure immediately. Note also that for using this function you need to specify the 'Observation rate'.
1122</p>
1123
1124<p><a name="advreco"><h4>4.10.3 Recovery Threshold - optional</h4></p>
1125<p>
1126Once a 'Begin_Failure' or 'Begin_Corrupted' event has been reported, BNC will check for when the stream again becomes available or uncorrupted. Event 'End_Failure' or 'End_Corrupted' will be reported as soon as valid observations are again detected continuously throughout the 'Recovery threshold' time span. The default value is set to 5 minutes and is recommended so not to innundate users with too many event reports.
1127</p>
1128<p>
1129Note that specifying a value of zero '0' for the 'Recovery threshold' will force BNC to report any stream recovery immediately. Note also that for using this function you need to specify the 'Observation rate'.
1130</p>
1131
1132<p><a name="advscript"><h4>4.10.4 Script - optional </h4></p>
1133<p>
1134As mentioned previously, BNC can trigger a shell script or a batch file to be executed when one of the events described are reported. This script can be used to email an advisory note to network operator or stream providers. To enable this feature, specify the full path to the script or batch file in the 'Script' field. The affected stream's mountpoint and type of event reported ('Begin_Outage', 'End_Outage', 'Begin_Corrupted' or 'End_Corrupted') will then be passed on to the script as command line parameters (%1 and %2 on Windows systems or $1 and $2 on Unix/Linux/Mac systems) together with date and time information.
1135</p>
1136<p>
1137Leave the 'Script' field empty if you do not wish to use this option. An invalid path will also disable this option.
1138</p>
1139<p>
1140Examples for command line parameter strings passed on to the advisory 'Script' are:
1141<pre>
1142FFMJ0 Begin_Outage 08-02-21 09:25:59
1143FFMJ0 End_Outage 08-02-21 11:36:02 Begin was 08-02-21 09:25:59
1144</pre>
1145Sample script for Unix/Linux/Mac systems:
1146<pre>
1147#!/bin/bash
1148sleep $((60*RANDOM/32767))
1149cat | mail -s &quot;NABU: $1&quot; email@address &lt;&lt;!
1150Advisory Note to BNC User,
1151Please note the following advisory received from BNC.
1152Stream: $*
1153Regards, BNC
1154!
1155</pre>
1156</p>
1157<p>
1158Note the sleep command in this script which causes the system to wait for a random period of up to 60 seconds before sending the email. This should avoids overloading your mail server in case of a simultaneous failure of many streams.
1159</p>
1160
1161<p><a name="misc"><h4>4.11. Miscellaneous</h4></p>
1162<p>
1163This section describes several miscellaneous options which can be applied for a single stream (mountpoint) or for all configured streams.
1164</p>
1165
1166<p>
1167The following figure shows RTCM message numbers contained in stream 'CONZ0' and the message latencies recorded every 10 seconds.
1168</p>
1169<p><img src="IMG/screenshot14.png"/></p>
1170<p><u>Figure 10:</u> RTCM message numbers and latencies.</p>
1171
1172
1173<p><a name="miscmount"><h4>4.11.1 Mountpoint - optional </h4></p>
1174<p>
1175Specify a mountpoint to apply one or several of the 'Miscellaneous' options to the corresponding stream. Enter 'ALL' if you want to apply these options to all configured streams. An empty option field (default) means that you don't want BNC to apply any of these options.
1176</p>
1177
1178<p><a name="miscperf"><h4>4.11.2 Log Latency - optional </h4></p>
1179<p>
1180 BNC can average latencies per stream over a certain period of GPS time, the 'Log latency' interval. Mean latencies are calculated from the individual latencies of at most one (first incoming) observation or correction to Broadcast Ephemeris per second. The mean latencies are then saved in BNC's logfile. Note that computing correct latencies requires the clock of the host computer to be properly synchronized. Note further that the latencies available from the 'Latency' tab on the bottom of the main window represent individual latencies and not the mean latencies for the logfile.
1181</p>
1182<p>
1183<u>Latency:</u> Latency is defined in BNC by the following equation:
1184</p>
1185<pre>
1186 UTC time provided by BNC's host
1187 - GPS time of currently processed epoch
1188 + Leap seconds between UTC and GPS time
1189 --------------
1190 = Latency
1191</pre>
1192<p>
1193<u>Statistics:</u> BNC counts the number of GPS seconds covered by at least one observation. It also estimates an observation rate (independent from the a priory specified 'Observation rate') from all observations received throughout the first full 'Log latency' interval. Based on this rate, BNC estimates the number of data gaps when appearing in subsequent intervals.
1194</p>
1195<p>
1196Latencies of observations or corrections to Broadcast Ephemeris and statistical information can be recorded in the 'Log' tab at the end of each 'Log latency' interval. A typical output from a 1 hour 'Log latency' interval would be:
1197</p>
1198<pre>
119908-03-17 15:59:47 BRUS0: Mean latency 1.47 sec, min 0.66, max 3.02, rms 0.35, 3585 epochs, 15 gaps
1200</pre>
1201<p>
1202Select a 'Log latency' interval to activate this function or select the empty option field if you do not want BNC to log latencies and statistical information.
1203</p>
1204
1205
1206<p><a name="miscscan"><h4>4.11.3 Scan RTCM - optional</h4></p>
1207<p>
1208When configuring a GNSS receiver for RTCM stream generation, the firmware's setup interface may not provide details about RTCM message types. As reliable information concerning stream contents should be available i.e. for NTRIP Broadcaster operators to maintain the broadcaster's source-table, BNC allows to scan RTCM streams for incoming message types and printout some of the contained meta-data. The idea for this option arose from 'InspectRTCM', a comprehensive stream analyzing tool written by D. Stoecker.
1209</p>
1210<p>
1211Tick 'Scan RTCM' to scan RTCM Version 2 or 3 streams and log all contained
1212</p>
1213<ul>
1214<li>Numbers of incoming message types</li>
1215<li>Antenna Reference Point (ARP) coordinates</li>
1216<li>Antenna Phase Center (APC) coordinates</li>
1217<li>Antenna height above marker</li>
1218<li>Antenna descriptor.</li>
1219</ul>
1220</p>
1221
1222<p>
1223Note that in RTCM Version 2 the message types 18 and 19 carry only the observables of one frequency. Hence it needs two type 18 and 19 messages per epoch to transport the observations from dual frequency receivers.
1224</p>
1225<p>
1226
1227<p>Logged time stamps refer to message reception time and allow understanding repetition rates. Enter 'ALL' if you want to log this information from all configured streams. Beware that the size of the logfile can rapidly increase depending on the number of incoming RTCM streams.
1228</p>
1229<p>This option is primarily meant for testing and evaluation. Use it to figure out what exactly is produced by a specific GNSS receiver's configuration. An empty option field (default) means that you don't want BNC to print the message type numbers and antenna information carried in RTCM streams.
1230</p>
1231
1232<p><a name="pppclient"><h4>4.12. PPP Client</h4></p>
1233<p>
1234BNC can derive coordinates for a rover position following the Precise Point Positioning (PPP) approach. It uses either code or code plus phase data in ionosphere free linear combinations P3 or L3. Besides pulling a stream of observations from a dual frequency receiver, this also
1235<ul>
1236<li>requires pulling in addition a stream carrying satellite orbit and clock corrections to Broadcast Ephemeris in the form of RTCM Version 3 'State Space Representation' (SSR) messages. Note that for BNC these Broadcast Corrections need to be referred to the satellite's Antenna Phase Center (APC). Streams providing such messages are listed on <u>http://igs.bkg.bund.de/ntrip/orbits</u>. Stream 'CLK11' on NTRIP Broadcaster 'products.igs-ip.net:2101' is an example.</li>
1237<li>may require pulling a stream carrying Broadcast Ephemeris available as RTCM Version 3 message types 1019, 1020, and 1045. This is a must only when the stream coming from the receiver does not contain Broadcast Ephemeris or provides them only at very low repetition rate. Streams providing such messages are listed on <u>http://igs.bkg.bund.de/ntrip/ephemeris</u>. Stream 'RTCM3EPH' on caster 'products.igs-ip.net:2101' is an example.</li>
1238</ul>
1239</p>
1240<p>
1241The following figure provides the screenshot of an example PPP session with BNC.
1242</p>
1243
1244<p><img src="IMG/screenshot03.png"/></p>
1245<p><u>Figure 11:</u> Precise Point Positioning with BNC, PPP Panel 1.</p>
1246
1247<p><img src="IMG/screenshot18.png"/></p>
1248<p><u>Figure 12:</u> Precise Point Positioning with BNC, PPP Panel 2.</p>
1249
1250<p>
1251PPP results are shown in the 'Log' tab on the bottom of BNC's main window. Depending on the processing options, the following values are shown about once per second (example):
1252<pre>
125310-09-08 09:14:06 FFMJ1 PPP 09:14:04.0 12 4053457.429 +- 2.323 617730.551 +- 1.630 4869395.266 +- 2.951
1254</pre>
1255</p>
1256<p>
1257The 'PPP' string in that is followed by the selected mounpoint, a PPP time stamp in GPS Time, the number of processed satellites, and XYZ coordinates with their formal errors as derived from the implemented filter in [m]. The implemented algorithm includes outlier and cycle slip detection. The maximum for accepted residuals is hard coded to 10 meters for code observations and 10 centimeters for phase observations.
1258</p>
1259
1260<p>
1261More detailed PPP results are saved in BNC's logfile. Depending on the selected processing options you find
1262<ul>
1263<li>code and phase residuals for GPS and GLONASS and Galileo in [m], </li>
1264<li>receiver clock errors in [m], </li>
1265<li>a-priori and correction values of tropospheric zenith delay in [m],
1266<li>time offset between GPS time and Galileo time in [m],
1267<li>L3 biases, also known as 'floated ambiguities', given per satellite.
1268</ul>
1269These parameters are saved together with their standard deviation. The following is an example extract from a log file when BNC was in 'Single Point Positioning' (SPP) mode:
1270<pre>
127110-12-06 18:10:50 Single Point Positioning of Epoch 18:10:48.0
1272--------------------------------------------------------------
127318:10:48.0 RES G04 L3 0.0165 P3 -0.1250
127418:10:48.0 RES G11 L3 0.0150 P3 0.7904
127518:10:48.0 RES G13 L3 0.0533 P3 0.4854
127618:10:48.0 RES G17 L3 -0.0277 P3 1.2920
127718:10:48.0 RES G20 L3 -0.0860 P3 -0.1186
127818:10:48.0 RES G23 L3 0.0491 P3 -0.1052
127918:10:48.0 RES G31 L3 0.0095 P3 -3.2929
128018:10:48.0 RES G32 L3 0.0183 P3 -3.8800
128118:10:48.0 RES R05 L3 -0.0077
128218:10:48.0 RES R06 L3 0.0223
128318:10:48.0 RES R15 L3 -0.0020
128418:10:48.0 RES R16 L3 0.0156
128518:10:48.0 RES R20 L3 -0.0247
128618:10:48.0 RES R21 L3 0.0014
128718:10:48.0 RES R22 L3 -0.0072
128818:10:48.0 RES E52 L3 -0.0475 P3 -0.1628
128918:10:48.0 RES G04 L3 0.0166 P3 -0.1250
129018:10:48.0 RES G11 L3 0.0154 P3 0.7910
129118:10:48.0 RES G13 L3 0.0535 P3 0.4855
129218:10:48.0 RES G17 L3 -0.0272 P3 1.2925
129318:10:48.0 RES G20 L3 -0.0861 P3 -0.1188
129418:10:48.0 RES G23 L3 0.0489 P3 -0.1055
129518:10:48.0 RES G31 L3 0.0094 P3 -3.2930
129618:10:48.0 RES G32 L3 0.0183 P3 -3.8800
129718:10:48.0 RES R05 L3 -0.0079
129818:10:48.0 RES R06 L3 0.0223
129918:10:48.0 RES R15 L3 -0.0020
130018:10:48.0 RES R16 L3 0.0160
130118:10:48.0 RES R20 L3 -0.0242
130218:10:48.0 RES R21 L3 0.0016
130318:10:48.0 RES R22 L3 -0.0072
130418:10:48.0 RES E52 L3 -0.0474 P3 0.1385
1305
1306 clk = 64394.754 +- 0.045
1307 trp = 2.185 +0.391 +- 0.001
1308 offset = -415.400 +- 0.137
1309 amb G17 = 11.942 +- 0.045
1310 amb G23 = 248.892 +- 0.044
1311 amb G31 = 254.200 +- 0.045
1312 amb G11 = -12.098 +- 0.044
1313 amb G20 = -367.765 +- 0.044
1314 amb G04 = 259.588 +- 0.044
1315 amb E52 = 6.124 +- 0.130
1316 amb G32 = 201.496 +- 0.045
1317 amb G13 = -265.658 +- 0.044
1318 amb R22 = -106.246 +- 0.044
1319 amb R21 = -119.605 +- 0.045
1320 amb R06 = 41.328 +- 0.044
1321 amb R15 = 163.453 +- 0.044
1322 amb R20 = -532.746 +- 0.045
1323 amb R05 = -106.603 +- 0.044
1324 amb R16 = -107.830 +- 0.044
1325</pre>
1326</p>
1327
1328<p>
1329Note that BNC's 'PPP Client' option can also be used offline for debugging purposes. Apply the 'File Mode' command line options for that to read a file containing synchronized observations, orbit and clock correctors, and Broadcast Ephemeris. Such a file must be generated using BNC's 'Raw output file' option. Example:
1330</p>
1331
1332<p>
1333bnc.exe --conf c:\temp\BNC.ppp --file c:\temp\FFMJ1
1334</p>
1335
1336<p>When using the PPP option, it is important to understand which effects are corrected by BNC.
1337</p>
1338<ul>
1339<li>BNC does correct for Solid Earth Tides and Phase Windup.</li>
1340<li>Satellite Antenna Phase Center Offsets are not corrected because applied orbit/clock corrections are referred to the satellite's antenna phase center.</li>
1341<li>Satellite Antenna Phase Center Variations are neglected because this is a small effect usually less than 2 centimeters.</li>
1342<li>Observations can be corrected for a Receiver Antenna Offset. Depending on whether or not this correction is applied, the estimated position is either that of the receiver's antenna phase center or that of the receiver's Antenna Reference Point.</li>
1343<li>Receiver Antenna Phase Center Variations are not included in the model. The bias caused by this neglect depends on the receiver antenna type. For most antennas it is smaller than a few centimeters.</li>
1344<li>Ocean and atmospheric loading is neglected. Atmospheric loading is pretty small. Ocean loading is usually also a small effect but may reach up to about 10 centimeters for coastal stations.</li>
1345<li>Rotational deformation due to polar motion (Polar Tides) is not corrected because this is a small effect usually less than 2 centimeters.</li>
1346</ul>
1347</p>
1348
1349<p><a name="pppmode"><h4>4.12.1 Mode & Mountpoints - optional</h4></p>
1350<p>
1351Specify the Point Positioning mode you want to apply and the mountpoints for observations and Broadcast Corrections.
1352</p>
1353
1354<p><a name="pppmodus"><h4>4.12.1.1 Mode - optional</h4></p>
1355<p>Choose between plain Single Point Positioning (SPP) and Precise Point Positioning (PPP) in 'Realtime' or 'Post-Processing' mode.</p>
1356
1357<p><a name="pppobsmount"><h4>4.12.1.2 Obs Mountpoint - optional</h4></p>
1358<p>
1359Specify an 'Observations Mountpoint' from the list of selected 'Streams' you are pulling if you want BNC to derive coordinates for the affected rover position through a Point Positioning solution.
1360</p>
1361
1362<p><a name="pppcorrmount"><h4>4.12.1.3 Corr Mountpoint - optional</h4></p>
1363<p>
1364Specify a Broadcast Ephemeris 'Corrections Mountpoint' from the list of selected 'Streams' you are pulling if you want BNC to correct your positioning solution accordingly.
1365</p>
1366
1367<p><a name="pppxyz"><h4>4.12.2 Marker Coordinates - optional</h4></p>
1368<p>
1369Enter the reference coordinate components X,Y,Z of the receiver's position in meters if known. This option makes only sense for static observations. Default are empty option fields, meaning that the antenna's XYZ position is unknown.
1370</p>
1371<p>
1372Once XYZ coordinate components are defined, the 'PPP' line in BNC's logfile is extended by Nort, East and Up displacements to (example):
1373</p>
1374<pre>
137510-08-09 06:01:56 FFMJ1 PPP 06:02:09.0 11 4053457.628 +- 2.639 617729.438 +- 1.180 4869396.447 +- 1.921 NEU -0.908 -0.571 1.629
1376</pre>
1377<p>
1378The parameters following the 'NEU' string provide Nort, East and Up components of the current coordinate displacement in meters.
1379</p>
1380
1381<p><a name="pppneu"><h4>4.12.3 Antenna Excentricity - optional</h4></p>
1382<p>
1383You may like to specify North, East and Up components of an antenna eccentricity which is the difference between a nearby marker position and the antenna phase center. If you do so BNC will produce coordinates referring to the marker position and not referring to the antenna phase center..
1384</p>
1385
1386<p><a name="pppoutput"><h4>4.12.4 NMEA & Plot Output - optional</h4></p>
1387<p>
1388BNC allows to output results from Precise Point Positioning in NMEA format. It can also plot a time series of North, East and UP displacements of coordinate components.
1389</p>
1390
1391<p><a name="pppnmeafile"><h4>4.12.4.1 NMEA File - optional</h4></p>
1392<p>
1393The NMEA sentences generated about once per second are pairs of
1394<ul>
1395<li> GPGGA sentences which mainly carry the estimated latitude, longitude, and height values, plus</li>
1396<li> GPRMC sentences which mainly carry date and time information.</li>
1397</ul>
1398</p>
1399<p>
1400Specify the full path to a file where Point Positioning results are saved as NMEA messages. The default value for 'NMEA file' is an empty option field, meaning that BNC will not saved NMEA messages into a file.
1401</p>
1402<p>
1403Note that Tomoji Takasu has written a program called RTKPlot for visualizing NMEA strings. It is available from <u>http://gpspp.sakura.ne.jp/rtklib/rtklib.htm</u> and compatible with the NMEA output of BNC's 'PPP Client' option.
1404</p>
1405
1406<p><a name="pppnmeaport"><h4>4.12.4.2 NMEA Port - optional</h4></p>
1407<p>
1408Specify the IP port number of a local port where Point Positioning results become available as NMEA messages. The default value for 'NMEA Port' is an empty option field, meaning that BNC does not provide NMEA messages vi IP port. Note that the NMEA file output and the NMEA IP port output are the same.
1409</p>
1410<p>
1411NASA's 'World Wind' software (see <u>http://worldwindcentral.com/wiki/NASA_World_Wind_Download</u>) can be used for real-time visualization of positions provided through BNC's NMEA IP output port. You need the 'GPS Tracker' plug-in available from <u>http://worldwindcentral.com/wiki/GPS_Tracker</u> for that. The 'Word Wind' is not meant for showing centimeter level details.
1412</p>
1413
1414<p><a name="pppplot"><h4>4.12.4.3 PPP Plot - optional</h4></p>
1415<p>
1416PPP time series of North (red), East(green) and Up (blue) displacements will be plotted in the 'PPP Plot' tab when this option is ticked. Values will be either referred to an XYZ reference coordinate (if specified) or referred to the first estimated XYZ coordinate. The sliding PPP time series window will cover the period of the latest 5 minutes.
1417</p>
1418<p>
1419Note that a PPP time series makes only sense for a stationary operated receiver.
1420</p>
1421
1422<p><a name="ppppost"><h4>4.12.5 Post Processing - optional</h4></p>
1423 <p>When in 'Post-Processing mode<ul><li>specifying a RINEX Observation, a RINEX Navigation and a Broadcast Corrections file leads to a PPP solution.</li><li>specifying only a RINEX Observation and a RINEX Navigation file and no Broadcast Corrections file leads to a SPP solution.</ul></p>
1424<p>BNC accepts RINEX Version 2 as well as RINEX Version 3 observation or navigation file formats. Files carrying Broadcast Corrections must have the format produced by BNC in the 'Broadcast Corrections' tab.
1425<p>
1426Post Processing PPP results can be saved in a specific output file.
1427</p>
1428
1429<p><a name="ppprecant"><h4>4.12.6 Antennas - optional</h4></p>
1430<p>
1431BNC allows to correct observations for antenna phase center offsets and variations.
1432</p>
1433
1434<p><a name="pppantex"><h4>4.12.6.1 ANTEX File - optional</h4></p>
1435<p>
1436IGS provides a file containing absolute phase center corrections for GNSS satellite and receiver antennas in ANTEX format. Entering the full path to such an ANTEX file is required for correcting observations for antenna phase center offsets and variations. It allows you to specify the name of your receiver's antenna (as contained in the ANTEX file) to apply such corrections.
1437</p>
1438<p>
1439Default is an empty option field meaning that you don't want to correct observations for antenna phase center offsets and variations.
1440</p>
1441
1442<p><a name="ppprecantenna"><h4>4.12.6.2 Receiver Antenna Name - optional if 'ANTEX File' is set</h4></p>
1443<p>
1444Specify the receiver's antenna name as defined in your ANTEX file. Observations will be corrected for the antenna phase center's offset which may result in a reduction of a few centimeters at max. Corrections for phase center variations are not yet applied by BNC. The specified name must consist of 20 characters. Add trailing blanks if the antenna name has less than 20 characters. Examples:
1445<pre>
1446'JPSREGANT_SD_E ' (no radome)
1447'LEIAT504 NONE' (no radome)
1448'LEIAR25.R3 LEIT' (radome)
1449</pre>
1450</p>
1451<p>
1452Default is an empty option field meaning that you don't want to correct observations for antenna phase center offsets.
1453</p>
1454
1455<p><a name="pppsatant"><h4>4.12.6.3 Apply Satellite Antenna Offsets - optional if 'ANTEX File' is set</h4></p>
1456<p>
1457BNC allows correcting observations for satellite antenna phase center offsets. (This option is not yet implemented.)
1458</p><p>
1459Satellite orbit and clock corrections refer to the satellite's antenna phase centers and hence observations are <u>not</u> to be corrected for satellite antenna phase center offsets. Tick 'Apply Sat. Ant. Offsets' to force BNC to correct observations for satellite antenna phase center offsets.
1460</p>
1461<p>
1462Default is to <u>not</u> correct observations for satellite antenna phase center offsets.
1463</p>
1464
1465<p><a name="pppbasics"><h4>4.12.7 Basics</h4></p>
1466<p>BNC allows using different Point Positioning processing options depending on the capability of the involved receiver and the application in mind. It also allows introducing specific sigmas for code and phase observations as well as for reference coordinates and troposphere estimates. You may also like to carry out your PPP solution in Quick-Start mode or enforce BNC to restart a solution if the length of an outage exceeds a certain threshold.
1467</p>
1468
1469<p><a name="pppphase"><h4>4.12.7.1 Use Phase Obs - optional</h4></p>
1470<p>
1471By default BNC applies a Point Positioning solution using an ionosphere free P3 linear combination of code observations. Tick 'Use phase obs' for an ionosphere free L3 linear combination of phase observations.
1472</p>
1473
1474<p><a name="ppptropo"><h4>4.12.7.2 Estimate Tropo - optional</h4></p>
1475<p>
1476BNC estimates the tropospheric delay according to equation
1477<pre>
1478T(z) = T_apr(z) + dT / cos(z)
1479</pre>
1480where T_apr is the a-priori tropospheric delay derived from Saastamoinen model.
1481</p>
1482<p>
1483By default BNC does not estimate troposphere parameters. Tick 'Estimate tropo' to estimate troposphere parameters together with the coordinates and save T_apr and dT in BNC's log file.
1484</p>
1485
1486<p><a name="pppglo"><h4>4.12.7.3 Use GLONASS - optional</h4></p>
1487<p>
1488By default BNC does not process GLONASS but only GPS observations when in Point Positioning mode. Tick 'Use GLONASS' to use GLONASS observations in addition to GPS (and Galileo if specified) for estimating coordinates in Point Positioning mode.
1489</p>
1490
1491<p><a name="pppgal"><h4>4.12.7.4 Use Galileo - optional</h4></p>
1492<p>
1493By default BNC does not process Galileo but only GPS observations when in Point Positioning mode. Tick 'Use Galileo' to use Galileo observations in addition to GPS (and GLONASS if specified) for estimating coordinates in Point Positioning mode.
1494</p>
1495
1496<p><a name="pppsync"><h4>4.12.7.5 Sync Corr - optional</h4></p>
1497<p>
1498Zero value (or empty field) means that BNC processes each epoch of data immediately after its arrival using satellite clock corrections available at that time. Non-zero value 'Sync Corr' means that the epochs of data are buffered and the processing of each epoch is postponed till the satellite clock corrections not older than 'Sync Corr' are available. Specifying a value of half the update rate of the clock corrections as 'Sync Corr' (i.e. 5 sec) may be appropriate. Note that this causes an additional delay of the PPP solutions in the amount of the update rate.
1499</p>
1500<p>
1501Using observations in sync with the corrections can avoid a possible high frequency noise of PPP solutions. Such noise could result from processing observations regardless of how late after a clock correction they were received. Note that applying the 'Sync Corr' option significantly reduces the PPP computation effort for BNC.
1502</p>
1503<p>
1504Default is an empty option field, meaning that you want BNC to process observations immediately after their arrival through applying the latest received clock correction.
1505</p>
1506
1507<p><a name="pppaverage"><h4>4.12.7.6 Averaging - optional if XYZ is set</h4></p>
1508<p>
1509Enter the length of a sliding time window in minutes. BNC will continuously output moving average values ns and their RMS as computed from those individual values obtained most recently throughout this period. RMS values presented for XYZ coordinates and tropospheric zenit path delays are bias reduced while RMS values for Nort/East/Up (NEU) displacements are not. Averaged values for XYZ coordinates and their RMS are marked with string &quot;AVE-XYZ&quot; in BNC's log file and 'Log' section while averaged values for NEU displacements and their RMS are marked with string &quot;AVE-NEU&quot; and averaged values for the tropospheric delays and their RMS are marked with string &quot;AVE-TRP&quot;. Example:
1510</p>
1511<pre>
151210-09-08 09:13:05 FFMJ1 AVE-XYZ 09:13:04.0 4053455.948 +- 0.284 617730.422 +- 0.504 4869397.692 +- 0.089
151310-09-08 09:13:05 FFMJ1 AVE-NEU 09:13:04.0 1.043 +- 0.179 0.640 +- 0.456 1.624 +- 0.331
151410-09-08 09:13:05 FFMJ1 AVE-TRP 09:13:04.0 2.336 +- 0.002
1515</pre>
1516<p>
1517Entering any positive value up to 1440 (24h mean value) is allowed. An empty option field (default) means that you don't want BNC to output moving average positions into the log file and the 'Log' section. Note that averaging positions makes only sense for a stationary receiver.
1518</p>
1519
1520<p><a name="pppquick"><h4>4.12.7.7 Quick-Start - optional if XYZ is set</h4></p>
1521<p>
1522Enter the lenght of a startup period in seconds for which you want to fix the PPP solution to a known XYZ coordinate. Constraining coordinate components is done in BNC through setting the 'XYZ White Noise' temporarily to zero.
1523</p>
1524<p>
1525This so-called Quick-Start option allows the PPP solutions to rapidly converge after startup. It requires that the antenna remains unmoved on the know position throughout the defined period. A value of 120 (default) is likely to be an appropriate choice for 'Quick-Start'
1526<p>
1527You may need to create your own reference coordinate through running BNC for an hour in normal mode before applying the Quick-Start option. Don't forget to introduce a realistic sigma 'XYZ Ini' according to the coordinate's precision.
1528</p>
1529
1530<p><img src="IMG/screenshot17.png"/></p>
1531<p><u>Figure 13:</u> BNC in 'Quick-Start' mode (PPP, Panel 1)</p>
1532
1533<p><img src="IMG/screenshot22.png"/></p>
1534<p><u>Figure 14:</u> BNC in 'Quick-Start' mode (PPP, Panel 2)</p>
1535
1536<p><a name="pppgap"><h4>4.12.7.8 Maximal Solution Gap - optional if Quick-Start is set</h4></p>
1537<p>
1538Specify a 'Maximum Solution Gap' in seconds. Should the time span between two consecutive solutions exceed this limit, the algorithm returns into the Quick-Start mode and fixes the introduced reference coordinate for the specified Quick-Start period. A value of '120' seconds could be an appropriate choice.
1539</p>
1540<p>
1541This option makes only sense for a stationary operated receiver where solution convergence can be enforced because a good approximation for the rover position is known. Default is an empty option field, meaning that you don't want BNC to return into the Quick-Start mode after failures caused i.e. by longer lasting outages.
1542</p>
1543
1544<p><a name="pppsigmas"><h4>4.12.8 Sigmas</h4></p>
1545<p>
1546You may like to introduce specific sigmas for code and phase observations and for the estimation of troposphere parameters.
1547</p>
1548
1549<p><a name="pppsigc"><h4>4.11.8.1 Code - mandatory if 'Use Phase Obs' is set</h4></p>
1550<p>
1551When 'Use phase obs' is set in BNC, the PPP solution will be carried out using both, code and phase observations. A sigma of 5.0 m for code observations and a sigma of 0.02 m for phase observations (defaults) are used to combine both types of observations. As the convergence characteristic of a PPP solution can be influenced by the ratio of the sigmas for code and phase, you may like to introduce you own sigmas for code and phase observations which differ from the default values.
1552<ul>
1553<li>Introducing a smaller sigma (higher accuracy) for code observations or a larger sigma for phase observations leads to better results shortly after program start. However, it may take more time till you finally get the best possible solutions.</li>
1554<li>Introducing a larger sigma (lower accuracy) for code observations or a smaller sigma for phase observations may lead to less accurate results shortly after program start and thus a prolonged period of convergence but could provide better positions in the long run.</li>
1555</ul>
1556</p>
1557<p>
1558Specify a sigma for code observations. Default is 5.0 m.
1559</p>
1560
1561<p><a name="pppsigp"><h4>4.12.8.2 Phase - mandatory if 'Use Phase Obs' is set</h4></p>
1562<p>
1563Specify a sigma for phase observations. Default is 0.02 m.
1564</p>
1565
1566<p><a name="pppsigxyzi"><h4>4.12.8.3 XYZ Init - mandatory</h4></p>
1567<p>
1568Enter a sigma in meters for the initial XYZ coordinate components. A value of 100.0 (default) may be an appropriate choice. However, this value may be significantly smaller (i.e. 0.01) when starting for example from a station with known XZY position in Quick-Start mode.
1569</p>
1570
1571<p><a name="pppsigxyzn"><h4>4.12.8.4 XYZ White Noise - mandatory</h4></p>
1572<p>
1573Enter a sigma in meters for the 'White Noise' of estimated XYZ coordinate components. A value of 100.0 (default) may be appropriate considering the potential movement of a rover.
1574</p>
1575
1576<p><a name="pppsigtrpi"><h4>4.12.8.5 Tropo Init - mandatory if 'Estimate tropo' is set</h4></p>
1577<p>
1578Enter a sigma in meters for the a-priory model based tropospheric delay estimation. A value of 0.1 (default) may be an appropriate choice.
1579</p>
1580
1581<p><a name="pppsigtrpn"><h4>4.12.8.6 Tropo White Noise - mandatory if 'Estimate tropo' is set</h4></p>
1582<p>
1583Enter a sigma in meters per second to describe the expected variation of the tropospheric effect. Supposing 1Hz observation data, a value of 3e-6 (default) would mean that the tropospheric effect may vary for 3600 * 3e-6 = 0.01 meters per hour.
1584</p>
1585
1586<p><a name="combi"><h4>4.13. Combination</h4></p>
1587<p>
1588BNC allows to process several orbit and clock corrections streams in real-time to produce, encode, upload and save a combination of Broadcast Corrections from various providers. It is so far only the satellite clock corrections which are combined while orbit corrections in the combination product as well as the product update rates are just taken over from one of the incoming Broadcast Correction streams. Combining only clock corrections using a fixed orbit reference has the possibility to introduce some analysis inconsistencies. We may therefore eventually consider improvements on this approach. The clock combination can be based either on a plain 'Single-Epoch' or on a 'Kalman' Filter approach.
1589</p>
1590<p>
1591In the Kalman Filter approach satellite clocks estimated by individual Analyses Centers (ACs) are used as pseudo observations within the adjustment process. Each observation is modeled as a linear function (actually a simple sum) of three estimated parameters: AC specific offset, satellite specific offset common to all ACs, and the actual satellite clock correction which represents the result of the combination. These three parameter types differ in their statistical properties. The satellite clock offsets are assumed to be static parameters while AC specific and satellite specific offsets are stochastic parameters with appropriate white noise.
1592 The solution is regularized by a set of minimal constraints.
1593</p>
1594<p>
1595Removing the AC-dependent biases as well as possible is a major issue with clock combinations. Since they vary in time, it can be tricky to do this. Otherwise, there will be artificial jumps in the combined clock stream if one or more AC contributions drop out for certain epochs. Here the Kalman Filter approach is expected to do better than the Single-Epoch approach.
1596</p>
1597<p>
1598In view of IGS real-time products, the 'Combination' functionality has been integrated in BNC because
1599<ul>
1600<li>the software with its Graphic User Interface and wide range of supported Operation Systems represents a perfect platform to process many Broadcast Correction streams in parallel;</li>
1601<li>outages of single AC product streams can be mitigated through merging several incoming streams into a combined product;</li>
1602<li>generating a combination product from several AC products allows detecting and rejecting outliers;</li>
1603<li>a Combination Center (CC) can operate BNC to globally disseminate a combination product via NTRIP broadcast;</li>
1604<li>an individual AC could prefer to disseminate a stream combined from primary and backup IT resources to reduce outages;</li>
1605<li>it enables a BNC PPP user to follow his own preference in combining streams from individual ACs for Precise Point Positioning;</li>
1606<li>it allows an instantaneous quality control of the combination process not only in the time domain but also in the space domain; this can be done through direct application of the combination stream in a PPP solution even without prior stream upload to an NTRIP Broadcaster;</li>
1607<li>it provides the means to output SP3 files containing precise orbit and clock information for further processing using other tools than BNC.</li>
1608</ul>
1609</p>
1610<p>
1611Note that the combination process requires real-time access to Broadcast Ephemeris. So, in addition to the orbit and clock corrections streams BNC must pull a stream carrying Broadcast Ephemeris in the form of RTCM Version 3 messages. Stream 'RTCM3EPH' on caster <u>products.igs-ip.net</u> is an example for that.
1612</p>
1613<p>
1614A combination is carried out every 5 seconds. If incoming streams have different rates, only epochs that correspond to the 5 seconds update rate are used.
1615</p>
1616<p>
1617Note further that you need to tick the 'Use GLONASS' option which is part ot the 'PPP (2)' panel in case you want to produce an GPS plus GLONASS combination.
1618</p>
1619<p>
1620With respect to IGS, it is important to understand that a major effect in the combination of GNSS orbit and clock corrections streams is the selection of ACs to include. It is likely that a combination product could be improved in accuracy by using only the best two or three ACs. However, with only a few ACs to depend on, the reliability of the combination product could suffer and the risk of total failures increases. So there is an important tradeoff here that must be considered when selecting streams for a combination. The major strength of a combination product is its reliability and stable median performance which can be much better than that of any single AC product.
1621</p>
1622<p>
1623This comment applies in situations where we have a limited number of solutions to combine and their quality varies significantly. The situation may be different when the total number of ACs is larger and the range of AC variation is smaller. In that case, a standard full combination is probably the best.
1624</p>
1625<p>
1626The following recursive algorithm is used to detect orbit outliers in the Kalman Filter combination when corrections are provided by several ACs:
1627<br>
1628Step 1: We don't produce a combination for a certain satellite if only one AC provides corrections for it.
1629<br>
1630Step 2: A mean satellite position is calculated as the average of positions from all ACs.
1631<br>
1632Step 3: For each AC and satellite the 3D distance between individual and mean satellite position is calculated.
1633<br>
1634Step 4: We find the greatest difference between AC specific and mean satellite positions.
1635<br>
1636Step 5: If that is less than 0.2 m the conclusion is that we don't have an outlier and can proceed to the next epoch.
1637<br>
1638Step 6: If that is greater 0.2 m then corrections of the affiliated AC are ignored for the affected epoch and the outlier detection restarts with step 1.
1639</p>
1640<p>
1641Note that BNC can produce an internal PPP solution from combined Broadcast Corrections. For that you have to specify the keyword 'INTERNAL' as 'Corrections Mounpoint' in the PPP (1) panel.
1642</p>
1643<p>
1644Note further that the combination procedure in BNC also - formally - works with only one Broadcast Corrections stream specified for combination.
1645</p>
1646<p>
1647The part of BNC which enables the combination of orbit and clock corrections streams is not intended for publication under GNU General Public License (GPL). However, pre-compiled BNC binaries which support the 'Combination' option will be available for personal usage.
1648</p>
1649
1650<p><a name="combimounttab"><h4>4.13.1 Combination Table - optional</h4></p>
1651<p>
1652Hit the 'Add Row' button, double click on the 'Mountpoint' field, enter a Broadcast Corrections mountpoint from the 'Streams' section and hit Enter. Then double click on the 'AC Name' field to enter your choice of an abbreviation for the Analysis Center (AC) providing the stream. Finally, double click on the 'Weight' field to enter a weight to be applied to this stream in the combination. The stream processing can already be started with only one corrections stream configured for combination.
1653</p>
1654<p>
1655Note that an appropriate 'Wait for full epoch' value needs to be specified for the combination under the 'Broadcast Corrections' tab. To give an example: a value of '15' sec would make sense if the update rate of incoming clock corrections is 10 sec.
1656</p>
1657<p>
1658The sequence of entries in the 'Combination Table' is not of importance. Note that the orbit information in the final combination stream is just copied from one of the incoming streams. The stream used for providing the orbits may vary over time: if the orbit providing stream has an outage then BNC switches to the next remaining stream for getting hold of the orbit information.</p>
1659<p>
1660Default is an empty 'Combination Table' meaning that you don't want BNC to combine orbit and clock corrections streams.
1661</p>
1662<p>
1663It is possible to specify only one Broadcast Ephemeris corrections stream in the 'Combination Table'. Instead of combining corrections from several sources BNC will then merge the single corrections stream with Broadcast Ephemeris to save results in SP3 and/or Clock RINEX format when specified accordingly under the 'Upload (clk)' tab.
1664</p>
1665
1666<p><a name="combiadd"><h4>4.13.1.1 Add Row, Delete - optional</h4></p>
1667<p>
1668Hit 'Add Row' button to add another row to the 'Combination Table' or hit the 'Delete' button to delete the highlighted row(s).
1669</p>
1670
1671<p>
1672The following screenshots describe an example setup of BNC when combining Broadcast Correction streams and upload them to an NTRIP Broadcaster. Note that it requires specifying options under tabs 'Combination' and 'Upload (clk)'. The example uses the combination product to simultaneously carry out an 'INTERNAL' PPP solution in Quickstart mode which allows monitoring the quality of the combination product in the space domain.
1673</p>
1674
1675<br>
1676<p><img src="IMG/screenshot20.png"/></p>
1677<p><u>Figure 15:</u> BNC combining Broadcast Correction streams.</p>
1678<p></p>
1679<p><img src="IMG/screenshot21.png"/></p>
1680<p><u>Figure 16:</u> BNC uploading the combined Broadcast Corrections stream.</p>
1681<p></p>
1682<p><img src="IMG/screenshot23.png"/></p>
1683<p><u>Figure 17:</u> 'INTERNAL' PPP with BNC using combined Broadcast Corrections stream.</p>
1684
1685<p><a name="combimethod"><h4>4.13.1.2 Method - mandatory if 'Combination Table' is populated</h4></p>
1686<p>
1687Select a clock combination method. Available options are Kalman 'Filter' and 'Single-Epoch. It is suggested to use the Kalman Filter approach in case the combined stream of Broadcast Corrections is intended for Precise Point Positioning support.
1688</p>
1689
1690<p><a name="combimax"><h4>4.13.1.3 Maximal Residuum- mandatory if 'Combination Table' is populated</h4></p>
1691
1692<p>BNC combines all incoming clocks according to specified weights. Individual clock estimates that differ by more than 'Maximal Residuum' meters from the average of all clocks will be ignored.<p>
1693</p>It is suggested to specify a value of about 0.2 m for the Kalman filter combination approach and a value of about 3.0 meters for the Single-Epoch combination approach.</p>
1694<p>Default is a 'Maximal Residuum' of 999.0 meters</p>
1695
1696<p><a name="upclk"><h4>4.14. Upload (clk)</h4></p>
1697<p>
1698BNC can upload streams carrying orbit and clock corrections to Broadcast Ephemeris in radial, along-track and cross-track components if they are<ol type=a>
1699<li>
1700either generated by BNC as a combination of several individual Broadcast Correction streams coming from an number of real-time Analysis Centers (ACs), see section 'Combination',</li>
1701<li>
1702or generated by BNC because the program receives an ASCII stream of precise satellite orbits and clocks via IP port from a connected real-time GNSS engine. Such a stream would be expected in a plain ASCII format and the associated 'decoder' string would have to be 'RTNET'. </li>
1703</ol>
1704The procedure taken by BNC to generate the clock and orbit corrections to Broadcast Ephemeris and upload them to an NTRIP Broadcaster is as follow:
1705<ul>
1706<li>Continuously receive up-to-date Broadcast Ephemeris carrying approximate orbits and clocks for all satellites. Read new Broadcast Ephemeris immediately whenever they become available. This information may come via a stream of RTCM messages generated from a BNC instance.</li>
1707</ul>
1708Then, epoch by epoch:
1709<ul>
1710<li>Continuously receive the best available clock and orbit estimates for all satellites in X,Y,Z Earth-Centered-Earth-Fixed IGS08 reference system. Receive them every epoch in plain ASCII format as provided by a real-time GNSS engine such as RTNet or generate them following a 'Combination' approach. </li>
1711<li>Calculate X,Y,Z coordinates from Broadcast Ephemeris orbits. </li>
1712<li>Calculate differences dX,dY,dZ between Broadcast Ephemeris and IGS08 orbits. </li>
1713<li>Transform these differences into radial, along-track and cross-track corrections to Broadcast Ephemeris orbits. </li>
1714<li>Calculate corrections to Broadcast Ephemeris clocks as differences between Broadcast Ephemeris and IGS08 clocks. </li>
1715<li>Encode Broadcast Ephemeris clock and orbit corrections in RTCM Version 3 format. </li>
1716<li>Upload corrections stream to NTRIP Broadcaster. </li>
1717</ul>
1718<p>
1719The orbit and clock corrections to Broadcast Ephemeris are usually refered to the latest set of broadcast messages, which are generally also received in real-time by a GNSS rover. However, the use of the latest broadcast message is delayed for a period of 60 seconds, measured from the time of complete reception of ephemeris and clock parameters, in order to accommodate rover applications to obtain the same set of broadcast orbital and clock parameters. This procedure is recommended in the RTCM SSR standard.
1720</p>
1721</p>
1722Because the encoding process may put a significant load on the communication link between BNC and the real-time GNSS engine, it is recommended to run both programs on the same host. However, doing so is not compulsory.
1723</p>
1724<p>
1725The usual handling of BNC when uploading a stream with Broadcast Corrections is that you first specify Broadcast Ephemeris and Broadcast Correction streams. You then specify an NTRIP Broadcaster for stream upload before you start the program.
1726</p>
1727<p>
1728BNC requires GNSS clocks and orbits in the IGS Earth-Centered-Earth-Fixed (ECEF) reference system and in a specific ASCII format. The clocks and orbits must be referred to satellite Center of Mass (CoM) and must not contain the conventional periodic relativistic effect. They may be provided by a real-time GNSS engine such as RTNet. The sampling rate for data transmission should not exceed 15 sec. Note that otherwise tools involved in IP streaming such as NTRIP Broadcasters or NTRIP Clients may respond with a timeout.
1729</p>
1730
1731<p>
1732Below you find an example of precise clocks and orbits coming in ASCII format (named 'RTNET' in this document) from a real-time GNSS engine. Each epoch starts with an asterisk character followed by the time as year, month, day of month, hour, minute and second. Subsequent records provide the following set of parameters for each satellite:
1733</p>
1734
1735<p>
1736<ul>
1737<li>GNSS Indicator and Satellite Vehicle Pseudo Random Number</li>
1738<li>X,Y,Z coordinates in Earth-Centered-Earth-Fixed system [km] at epoch T</li>
1739<li>Satellite clock error [microsecond]</li>
1740<li>Conventional periodic relativistic effect [microsecond]</li>
1741<li>DX,DY,DZ [m] in Earth-Centered-Earth-Fixed system for translation CoM-&gt;APC</li>
1742<li>Differential Code Bias P1C1 [m]</li>
1743<li>Differential Code Bias P1P2 [m]</li>
1744<li>Time increment dT [second]</li>
1745<li>X,Y,Z coordinates in Earth-Centered-Earth-Fixed system [km] at epoch T+dT</li>
1746</ul>
1747</p>
1748Example for 'RTNET' stream format:
1749</p>
1750<p>
1751<pre>
1752...
1753PR22 24695.278546 4939.628474 -3498.468864 41.074663 0.000301 -2.458 0.059 0.259 0.000 0.369 60.0 24724.926665 4937.395818 -3285.525249
1754PR23 16644.528151 -4673.966731 -18755.727311 -381.408485 -0.000069 -1.484 0.958 1.597 0.000 -1.041 60.0 16794.540110 -4640.370673 -18629.931406
1755PR24 -835.564016 -11361.061950 -22837.329550 -67.978344 -0.000027 0.088 1.593 1.979 0.000 0.628 60.0 -654.746874 -11311.272410 -22867.926411
1756EOE
1757* 2012 4 13 18 5 20.00000000
1758PG01 -17662.477581 -4690.968816 19273.403670 247.562657 -0.001403 1.173 -0.094 -1.222 -0.081 -3.222 60.0 -17723.637492 -4824.411250 19184.308406
1759PG02 13499.913230 23158.540481 -1230.022763 386.539840 -0.009664 -0.392 -0.672 0.036 -0.007 1.778 60.0 13488.200264 23175.574718 -1044.681214
1760PG03 -16691.614702 -11720.144912 -17619.363518 35.472262 -0.007906 1.785 0.965 1.939 -0.171 -0.769 60.0 -16563.914187 -11742.834794 -17725.636699
1761...
1762PG32 -16198.232316 -3364.836652 20899.169198 -432.258718 -0.025811 1.728 0.075 -2.191 -0.370 -1.040 60.0 -16107.271625 -3493.294042 20951.654447
1763PR01 18574.288277 -17410.663026 -1754.600023 -178.990271 -0.000082 -1.469 2.095 0.024 0.000 0.188 60.0 18556.963974 -17406.362476 -1967.750384
1764PR02 8030.345235 -18665.480490 15430.035833 -298.816088 -0.000568 -0.516 2.171 -1.184 0.000 0.221 60.0 8114.572636 -18759.449343 15271.294411
1765PR03 -6108.423573 -9263.873363 23002.679850 -129.074986 0.000627 0.523 1.396 -2.019 0.000 1.568 60.0 -5976.535477 -9398.317054 22982.703956
1766...
1767PR24 -820.514575 -11356.881507 -22839.954618 -67.978328 -0.000026 0.087 1.593 1.979 0.000 0.628 60.0 -639.657024 -11307.160404 -22870.387083
1768EOE
1769* 2012 4 13 18 5 25.00000000
1770PG01 -17667.568396 -4702.119849 19266.035352 247.562677 -0.001403 1.173 -0.094 -1.222 -0.081 -3.222 60.0 -17728.740899 -4835.494883 19176.817383
1771PG02 13498.959815 23160.004885 -1214.580934 386.539856 -0.009647 -0.392 -0.672 0.035 -0.007 1.778 60.0 13487.197253 23176.941260 -1029.232392
1772PG03 -16680.999851 -11722.017340 -17628.269050 35.472285 -0.007882 1.783 0.966 1.940 -0.171 -0.769 60.0 -16553.240904 -11744.747432 -17734.434260
1773...
1774</pre>
1775</p>
1776<p>
1777Note that each end of an epoch in the incoming stream is indicated by an ASCII string 'EOE' (for End Of Epoch).
1778</p>
1779<p>
1780When using clocks from Broadcast Ephemeris (with or without applied corrections) or clocks from SP3 files, it may be important to understand that they are not corrected for the conventional periodic relativistic effect. Chapter 10 of the IERS Conventions 2003 mentions that the conventional periodic relativistic correction to the satellite clock (to be added to the broadcast clock) is computed as dt = -2 (R * V) / c^2 where R *V is the scalar product of the satellite position and velocity and c is the speed of light. This can also be found in the GPS Interface Specification, IS-GPS-200, Revision D, 7 March 2006.
1781</p>
1782
1783<p><a name="upadd"><h4>4.14.1 Add, Delete Row - optional</h4></p>
1784<p>Hit 'Add Row' button to add another row to the stream 'Upload Table' or hit the 'Delete' button to delete the highlighted row(s).
1785</p>
1786<p>
1787Having an empty 'Upload Table' is default and means that you don't want BNC to upload orbit and clock correction streams to any NTRIP Broadcaster.
1788</p>
1789
1790<p><a name="uphost"><h4>4.14.2 Host, Port, Mountpoint, Password - mandatory if 'Upload Table' entries specified</h4></p>
1791
1792<p>Specify the domain name or IP number of an NTRIP Broadcaster for uploading the stream. Furthermore, specify the caster's listening IP port, an upload mountpoint and an upload password. Note that NTRIP Broadcasters are often configured to provide access on more than one port, usually port 80 and 2101. If you experience communication problems on port 80, you should try to use the alternative port(s).
1793</p>
1794<p>
1795BNC uploads a stream to the Caster by referring to a dedicated mountpoint that has been set by the Caster operator. Specify here the mountpoint based on the details you received for your stream from the operator. It is often a four character ID (capital letters) plus an integer number.</p>
1796<p>The stream upload may be protected through an upload 'Password'. Enter the password you received from the Caster operator along with the mountpoint(s).</p>
1797<p>
1798If 'Host', 'Port', 'Mountpoint' and 'Password' are set, the stream will be encoded in RTCM's 'State Space Representation' (SSR) messages and uploaded to the specified broadcaster following the NTRIP Version 1 transport protocol.
1799</p>
1800
1801<p><a name="upsystem"><h4>4.14.3 System - mandatory if 'Host' is set</h4></p>
1802<p>
1803BNC allows to configure several Broadcast Correction streams for upload so that they refer to different reference systems and different NTRIP Broadcasters. You may use this functionality for parallel support of a backup NTRIP Broadcaster or for simultaneous support of several reference systems. Available options for referring clock and orbit corrections to specific target reference systems are
1804<p>
1805<ul>
1806<li>IGS08 which stands for the GNSS-based IGS realization of the International Terrestrial Reference Frame 2008 (ITRF2008), and</li>
1807<li>ETRF2000 which stands for the European Terrestrial Reference Frame 2000 adopted by EUREF, and</li>
1808<li>NAD83 which stands for the North American Datum 1983 as adopted for the U.S.A., and</li>
1809<li>GDA94 which stands for the Geodetic Datum Australia 1994 as adopted for Australia, and</li>
1810<li>SIRGAS2000 which stands for the Geodetic Datum adopted for Brazil, and</li>
1811<li>SIRGAS95 which stands for the Geodetic Datum adopted i.e. for Venezuela, and</li>
1812<li>'Custom' which allows a transformation of Broadcast Corrections from the IGS08 system to any other system through specifying up to 14 Helmert Transformation Parameters.</li>
1813</ul>
1814</p>
1815
1816<p>
1817BNC only transforms the original IGS08 <u>orbits</u> in the Broadcast Corrections stream to a target reference system while leaving the clocks unchanged. From a theoretical point of view this leads to inconsistencies between orbits and clocks and is therefore not allowed. However, it has been shown by Huisman et al. 2012 that as long as involved scale parameters are small enough, this way of transforming corrections stream contents only leads to height biases less than about one centimeter. With regards to the systems listed above, the approach has therefore been implemented in BNC for practical reasons.
1818</p>
1819<p>
1820The transformation to GDA94 is an exception in this because it involves a ten times higher scale parameter compared to the other transformation implementations. Note that hence the resulting height biases for a BNC-transformed GDA94 corrections stream can increase up to about 10 centimeters.
1821</p>
1822
1823<p>
1824<u>IGS08:</u> As the clocks and orbits coming from real-time GNSS engine are expected to be in the IGS08 system, no transformation is carried out if this option is selected.
1825</p>
1826
1827<p>
1828<u>ETRF2000:</u> The formulas for the transformation 'ITRF2005-&gt;ETRF2000' are taken from 'Claude Boucher and Zuheir Altamimi 2008: Specifications for reference frame fixing in the analysis of EUREF GPS campaign', see <u>http://etrs89.ensg.ign.fr/memo-V8.pdf</u>. The following 14 Helmert Transformation Parameters were introduced:
1829</p>
1830<p>
1831<pre>
1832Translation in X at epoch To: 0.0521 m
1833Translation in Y at epoch To: 0.0493 m
1834Translation in Z at epoch To: -0.0585 m
1835Translation rate in X: 0.0001 m/y
1836Translation rate in Y: 0.0001 m/y
1837Translation rate in Z: -0.0018 m/y
1838Rotation in X at epoch To: 0.891 mas
1839Rotation in Y at epoch To: 5.390 mas
1840Rotation in Z at epoch To: -8.712 mas
1841Rotation rate in X: 0.081 mas/y
1842Rotation rate in Y: 0.490 mas/y
1843Rotation rate in Z: -0.792 mas/y
1844Scale at epoch To : 0.00000000134
1845Scale rate: 0.00000000008 /y
1846To: 2000.0
1847</pre>
1848</p>
1849
1850<p>
1851<u>NAD83:</u> Formulas for the transformation 'ITRF2005-&gt;NAD83' are taken from 'Chris Pearson, Robert McCaffrey, Julie L. Elliott, Richard Snay 2010: HTDP 3.0: Software for Coping with the Coordinate Changes Associated with Crustal Motion, Journal of Surveying Engineering'.
1852</p>
1853<p>
1854<pre>
1855Translation in X at epoch To: 0.9963 m
1856Translation in Y at epoch To: -1.9024 m
1857Translation in Z at epoch To: -0.5219 m
1858Translation rate in X: 0.0005 m/y
1859Translation rate in Y: -0.0006 m/y
1860Translation rate in Z: -0.0013 m/y
1861Rotation in X at epoch To: 25.915 mas
1862Rotation in Y at epoch To: 9.426 mas
1863Rotation in Z at epoch To: 11.599 mas
1864Rotation rate in X: 0.067 mas/y
1865Rotation rate in Y: -0.757 mas/y
1866Rotation rate in Z: -0.051 mas/y
1867Scale at epoch To : 0.00000000078
1868Scale rate: -0.00000000010 /y
1869To: 1997.0
1870</pre>
1871</p>
1872
1873<p>
1874<u>GDA94:</u> The formulas for the transformation 'ITRF2000-&gt;GDA94' are taken from 'John Dawson, Alex Woods 2010: ITRF to GDA94 coordinate transformations', Journal of Applied Geodesy, 4 (2010), 189¿199, de Gruyter 2010. DOI 10.1515/JAG.2010.019'.
1875</p>
1876<p>
1877<pre>
1878Translation in X at epoch To: -0.07973 m
1879Translation in Y at epoch To: -0.00686 m
1880Translation in Z at epoch To: 0.03803 m
1881Translation rate in X: 0.00225 m/y
1882Translation rate in Y: -0.00062 m/y
1883Translation rate in Z: -0.00056 m/y
1884Rotation in X at epoch To: 0.0351 mas
1885Rotation in Y at epoch To: -2.1211 mas
1886Rotation in Z at epoch To: -2.1411 mas
1887Rotation rate in X: -1.4707 mas/y
1888Rotation rate in Y: -1.1443 mas/y
1889Rotation rate in Z: -1.1701 mas/y
1890Scale at epoch To : 0.000000006636
1891Scale rate: 0.000000000294 /y
1892To: 1994.0
1893</pre>
1894</p>
1895
1896<p>
1897<u>SIRGAS2000:</u> The formulas for the transformation 'ITRF2005-&gt;SIRGAS2000' were provided via personal communication from CGED-Coordenacao de Geodesia, IBGE/DGC - Diretoria de Geociencias, Brazil.</u>.
1898</p>
1899<p>
1900<pre>
1901Translation in X at epoch To: -0.0051 m
1902Translation in Y at epoch To: -0.0065 m
1903Translation in Z at epoch To: -0.0099 m
1904Translation rate in X: 0.0000 m/y
1905Translation rate in Y: 0.0000 m/y
1906Translation rate in Z: 0.0000 m/y
1907Rotation in X at epoch To: 0.150 mas
1908Rotation in Y at epoch To: 0.020 mas
1909Rotation in Z at epoch To: 0.021 mas
1910Rotation rate in X: 0.000 mas/y
1911Rotation rate in Y: 0.000 mas/y
1912Rotation rate in Z: 0.000 mas/y
1913Scale at epoch To : 0.000000000000
1914Scale rate: -0.000000000000 /y
1915To: 2000.0
1916</pre>
1917</p>
1918
1919<p>
1920<u>SIRGAS95:</u> The formulas for the transformation 'ITRF2005-&gt;SIRGAS95' were provided via personal communication from Gustavo Acuha, Laboratorio de Geodesia Fisica y Satelital at Zulia University (LGFS-LUZ), parameters based on values from Table 4.1 of "Terrestrial Reference Frames (April 10, 2009), Chapter 4" in http://tai.bipm.org/iers/convupdt/convupdt_c4.html.</u>.
1921</p>
1922<p>
1923<pre>
1924Translation in X at epoch To: 0.0077 m
1925Translation in Y at epoch To: 0.0058 m
1926Translation in Z at epoch To: -0.0138 m
1927Translation rate in X: 0.0000 m/y
1928Translation rate in Y: 0.0000 m/y
1929Translation rate in Z: 0.0000 m/y
1930Rotation in X at epoch To: 0.000 mas
1931Rotation in Y at epoch To: 0.000 mas
1932Rotation in Z at epoch To: -0.003 mas
1933Rotation rate in X: 0.000 mas/y
1934Rotation rate in Y: 0.000 mas/y
1935Rotation rate in Z: 0.000 mas/y
1936Scale at epoch To : 0.00000000157
1937Scale rate: -0.000000000000 /y
1938To: 1995.4
1939</pre>
1940</p>
1941
1942<p>
1943<u>Custom:</u> The default numbers shown as examples are those for a transformation from ITRF2005 to ETRF2000'.
1944</p>
1945
1946<p><a name="upcom"><h4>4.14.4 Center of Mass - optional</h4></p>
1947<p>
1948BNC allows to either refer Broadcast Corrections to the satellite's Center of Mass (CoM) or to the satellite's Antenna Phase Center (APC). By default corrections refer to APC. Tick 'Center of Mass' to refer uploaded corrections to CoM.
1949</p>
1950
1951<p><a name="upsp3"><h4>4.14.5 SP3 File - optional</h4></p>
1952<p>Specify a path for saving the generated orbit corrections as SP3 orbit files. If the specified directory does not exist, BNC will not create SP3 orbit files. The following is a path example for a Linux system:<br>/home/user/BNC${GPSWD}.sp3<br>Note that '${GPSWD}' produces the GPS Week and Day number in the file name.</p>
1953<p>
1954Default is an empty option field meaning that you don't want BNC to save the uploaded stream contents in daily SP3 files.
1955</p>
1956<p>
1957As an SP3 file contents should be referred to the satellites Center of Mass (CoM) while Broadcast Corrections are referred to the satellites Antenna Phase Center (APC), an offset has to be applied which is available from an IGS ANTEX file (see section 'ANTEX File'). You should therefore specify the 'ANTEX File' path under tab 'PPP (2)' if you want to save the stream contents in SP3 format. If you don't specify an 'ANTEX File' path there, the SP3 file contents will be referred to the satellites APCs.
1958</p>
1959<p>
1960The file names for the daily SP3 files follow the convention for SP3 file names. The first three characters of each file name are set to 'BNC'. Note that clocks in the SP3 orbit files are not corrected for the conventional periodic relativistic effect.
1961</p>
1962<p>
1963In case the 'Combination Table' contains only one Broadcast Corrections stream, BNC will merge that stream with Broadcast Ephemeris to save results in files specified here through SP3 and/or Clock RINEX file path. In such a case you have to define only the SP3 and Clock RINEX file path and no further options in the 'Upload (clk)' table.
1964</p>
1965
1966<p><a name="uprinex"><h4>4.14.6 RNX File - optional</h4></p>
1967<p>
1968The clock corrections generated by BNC for upload can be logged in Clock RINEX format. The file naming follows the RINEX convention.
1969</p>
1970<p>
1971Specify a path for saving the generated clock corrections as Clock RINEX files. If the specified directory does not exist, BNC will not create Clock RINEX files. The following is a path example for a Linux system:<br>/home/user/BNC${GPSWD}.clk<br>Note that '${GPSWD}' produces the GPS Week and Day number in the file name.
1972</p>
1973<p>
1974Note further that clocks in the Clock RINEX files are not corrected for the conventional periodic relativistic effect.
1975</p>
1976
1977<p><a name="upinter"><h4>4.14.7 Interval - mandatory if 'Upload Table' entries specified</h4></p>
1978<p>
1979Select the length of Clock RINEX files and SP3 Orbit files. The default value is 1 day.
1980</p>
1981
1982<p><a name="upclksmpl"><h4>4.14.8 Sampling (Clk) - mandatory if 'Upload Table' entries specified</h4></p>
1983<p>Select the Clock RINEX file sampling interval in seconds. A value of zero '0' tells BNC to store all available samples into Clock RINEX files.</p>
1984
1985<p><a name="uporbsmpl"><h4>4.14.9 Sampling (Orb) - mandatory if 'Upload Table' entries specified</h4></p>
1986<p>Select the SP3 Orbit file sampling interval in seconds. A value of zero '0' tells BNC to store all available samples into SP3 Orbit files.</p>
1987
1988<p><a name="upcustom"><h4>4.14.10 Custom Trafo - optional if 'Upload Table' entries specified</h4></p>
1989<p>Hit 'Custom Trafo' to specify your own 14 parameter Helmert Transformation instead of selecting a predefined transformation through 'System' button.</p>
1990
1991<p>
1992The following screenshot shows the encoding and uploading of a stream of precise orbits and clocks coming from a real-time engine in 'RTNET' ASCII format. The stream is uploaded to NTRIP Broadcaster 'products.igs-ip.net'. It is referred to APC and IGS08. Uploaded data are locally saved in SP3 and Clock RINEX format. The SSR Provider ID is set to 3. The SSR Solution ID is and the Issue of Data SSR are set to 1. Required Broadcast Ephemeris are received via stream 'RTCM3EPH'.
1993</p>
1994<p><img src="IMG/screenshot26.png"/></p>
1995<p><u>Figure 18:</u> Producing Broadcast Corrections from incoming precise orbits and clocks and uploading them to an NTRIP Broadcaster.</p>
1996
1997<p><a name="upeph"><h4>4.15. Upload (eph) </h4></p>
1998<p>
1999BNC can upload a stream carrying Broadcast Ephemeris in RTCM Version 3 format to an NTRIP Broadcaster.
2000</p>
2001
2002<p><a name="brdcserver"><h4>4.15.1 Host &amp; Port - optional</h4></p>
2003<p>
2004Specify the 'Host' IP name or number of an NTRIP Broadcaster to upload the stream. An empty option field means that you don't want to upload Broadcast Ephemeris.
2005</p>
2006<p>
2007Enter the NTRIP Broadcaster's IP 'Port' number for stream upload. Note that NTRIP Broadcasters are often configured to provide access on more than one port, usually
2008port 80 and 2101. If you experience communication problems on port 80, you should try to use the alternative port(s).
2009</p>
2010
2011<p><a name="brdcmount"><h4>4.15.2 Mountpoint &amp; Password - mandatory if 'Host' is set</h4></p>
2012<p>
2013BNC uploads a stream to the Caster by referring to a dedicated mountpoint that has been set by the Caster operator. Specify the mountpoint based on the details you received for your stream from the operator. It is often a four character ID (capital letters) plus an integer number.</p>
2014<p>The stream upload may be protected through an upload 'Password'. Enter the password you received from the Caster operator along with the mountpoint(s).</p>
2015</p>
2016
2017<p><a name="brdcsmpl"><h4>4.15.3 Sampling - mandatory if 'Host' is set</h4></p>
2018Select the Broadcast Ephemeris repetition interval in seconds. Defaut is '5' meaning that a complete set of Broadcast Ephemeris is uploaded every 5 seconds.
2019</p>
2020
2021<p><img src="IMG/screenshot28.png"/></p>
2022<p><u>Figure 28:</u> Producting a Broadcast Ephemeris stream from navigation messages of globally distributed RTCM streams and uploading them in RTCM Version 3 format to an NTRIP Broadcaster.</p>
2023
2024<p><a name="streams"><h4>4.16. Streams</h4></p>
2025<p>
2026Each stream on an NTRIP Broadcaster (and consequently on BNC) is defined using a unique source ID called mountpoint. An NTRIP Client like BNC access the desired data stream by referring to its mountpoint. Information about streams and their mountpoints is available through the source-table maintained by the NTRIP Broadcaster. Note that mountpoints could show up in BNC more than once when retrieving streams from several NTRIP Broadcasters.
2027</p>
2028
2029<p>
2030Streams selected for retrieval are listed under the 'Streams' canvas section on BNC's main window. The list provides the following information either extracted from source-table(s) produced by the NTRIP Broadcasters or introduced by BNC's user:
2031</p>
2032<p>
2033<table>
2034<tr><td>'resource loader'&nbsp; </td><td>NTRIP Broadcaster URL and port, or<br>TCP/IP host and port, or<br>UDP port, or<br>Serial input port specification.</td></tr>
2035<tr><td>'mountpoint' &nbsp;</td><td>Mountpoint introduced by NTRIP Broadcaster, or<br>Mountpoint introduced by BNC's user.</td></tr>
2036<tr><td>'decoder' &nbsp;</td><td>Name of decoder used to handle the incoming stream content according to its format; editable.</td></tr>
2037<tr><td>'lat' &nbsp;</td><td>Approximate latitude of reference station, in degrees, north; editable if 'nmea' = 'yes'.</td></tr>
2038<tr><td>'long' &nbsp;</td><td>Approximate longitude of reference station, in degrees, east; editable if 'nmea' = 'yes'.</td></tr>
2039<tr><td>'nmea' &nbsp;</td><td>Indicates whether or not streaming needs to be initiated by BNC through sending NMEA-GGA message carrying position coordinates in 'lat' and 'long'.</td></tr>
2040<tr><td>'ntrip' &nbsp;</td><td>Selected NTRIP transport protocol version (1, 2, 2s, R, or U), or<br>'N' for TCP/IP streams without NTRIP, or<br>'UN' for UDP streams without NTRIP, or<br>'S' for serial input streams without NTRIP.</td></tr>
2041<tr><td>'bytes' &nbsp;</td><td>Number of bytes received.
2042</table>
2043</p>
2044
2045<p><a name="streamedit"><h4>4.16.1 Edit Streams</h4></p>
2046<ul>
2047<li>
2048BNC automatically allocates one of its internal decoders to a stream based on the stream's 'format' and 'format-details' as given in the source-table. However, there might be cases where you need to override the automatic selection due to incorrect source-table for example. BNC allows users to manually select the required decoder by editing the decoder string. Double click on the 'decoder' field, enter your preferred decoder and then hit Enter. The accepted decoder strings are 'RTCM_2.x', 'RTCM_3.x' and 'RTNET'.
2049</li>
2050<li>
2051In case you need to log the raw data as is, BNC allows users to by-pass its decoders and directly save the input in daily log files. To do this specify the decoder string as 'ZERO'. The generated file names are created from the characters of the streams mountpoints plus two-digit numbers each for year, month, and day. Example: Setting the 'decoder' string for mountpoint WTZZ0 to 'ZERO' and running BNC on March 29, 2007 would save the raw data in a file named WTZZ0_070329.
2052</li>
2053<li>
2054BNC can also retrieve streams from virtual reference stations (VRS). To initiate these streams, an approximate rover position needs to be sent in NMEA format to the NTRIP Broadcaster. In return, a user-specific data stream is generated, typically by Network-RTK software. VRS streams are indicated by a 'yes' in the source-table as well as in the 'nmea' column on the 'Streams' canvas in BNC's main window. They are customized exactly to the latitude and longitude transmitted to the NTRIP Broadcaster via NMEA-GGA messages.
2055<br>If NMEA-GGA messages are not coming from a serial connected GNSS rover, BNC simulates them from the default latitude and longitude of the source-table as shown in the 'lat' and 'long' columns on the 'Streams' canvas. However, in most cases you would probably want to change these defaults according to your requirement. Double-click on 'lat' and 'long' fields, enter the values you wish to send and then hit Enter. The format is in positive north latitude degrees (e.g. for northern hemisphere: 52.436, for southern hemisphere: -24.567) and eastern longitude degrees (example: 358.872 or -1.128). Only streams with a 'yes' in their 'nmea' column can be edited. The position must preferably be a point within the VRS service area of the network. RINEX files generated from these streams will contain an additional COMMENT line in the header beginning with 'NMEA' showing the 'lat' and 'long' used.
2056<br>Note that when running BNC in a Local Area Network (LAN), NMEA strings may be blocked by a proxy server, firewall or virus scanner when not using the NTRIP Version 2 transport protocol..
2057</li>
2058</ul>
2059
2060<p><a name="streamdelete"><h4>4.16.2 Delete Stream</h4></p>
2061<p>
2062To remove a stream from the 'Streams' canvas in the main window, highlight it by clicking on it and hit the 'Delete Stream' button. You can also remove multiple streams simultaneously by highlighting them using +Shift and +Ctrl.</p>
2063
2064<p><a name="streamconf"><h4>4.16.3 Reconfigure Streams On-the-fly</h4></p>
2065<p>
2066The streams selection can be changed on-the-fly without interrupting uninvolved threads in the running BNC process.
2067</p>
2068<p>
2069<u>Window mode:</u> Hit 'Save &amp; Reread Configuration' while BNC is in window mode and already processing data to let changes of your streams selection immediately become effective.
2070<p>
2071<u>No window mode:</u> When operating BNC online in 'no window' mode (command line option -nw), you force BNC to reread its 'mountPoints' configuration option from disk at pre-defined intervals. Select '1 min', '1 hour', or '1 day' as 'Reread configuration' option to reread the 'mountPoints' option every full minute, hour, or day. This lets a 'mountPoints' option edited in between in the configuration file become effective without terminating uninvolved threads. See annexed section 'Configuration Examples' for a configuration file example and a list of other on-the-fly changeable options.
2072</p>
2073
2074<p><a name="logs"><h4>4.17. Logging</h4></p>
2075<p>
2076A tabs section on the bottom of the main window provides online control of BNC's activities. Tabs are available to show the records saved in a logfile, for a plot to control the bandwidth consumption, for a plot showing stream latencies, and for time series plots of PPP results.
2077</p>
2078<p><a name="logfile"><h4>4.17.1 Log</h4></p>
2079<p>
2080Records of BNC's activities are shown in the 'Log' tab. They can be saved into a file when a valid path is specified in the 'Logfile (full path)' field.
2081</p>
2082
2083<p><a name="throughput"><h4>4.17.2 Throughput</h4></p>
2084<p>
2085The bandwidth consumption per stream is shown in the 'Throughput' tab in bits per second (bps) or kilo bits per second (kbps). The following figure shows the bandwidth comsumption of incoming streams.
2086</p>
2087
2088<p><img src="IMG/screenshot08.png"/></p>
2089<p><u>Figure 19:</u> Bandwidth consumption of incoming streams.</p>
2090
2091<p><a name="latency"><h4>4.17.3 Latency</h4></p>
2092<p>
2093The latency of observations in each incoming stream is shown in the 'Latency' tab in milliseconds or seconds. Streams not carrying observations (i.e. those providing only Broadcast Ephemeris messages) or having an outage are not considered here and shown in red color. Note that the calculation of correct latencies requires the clock of the host computer to be properly synchronized. The next figure shows the latency of incoming streams.
2094</p>
2095
2096<p><img src="IMG/screenshot07.png"/></p>
2097<p><u>Figure 20:</u> Latency of incoming streams.</p>
2098
2099<p><a name="ppptab"><h4>4.17.4 PPP Plot</h4></p>
2100<p>
2101Precise Point Positioning time series of North (red), East (green) and Up (blue) coordinate components are shown in the 'PPP Plot' tab when a 'Origin' option is defined. Values are either referred to reference coordinates (if specified) or referred to the first estimated set of coordinate components. The time as given in format [hh:mm] refers to GPS Time. The sliding PPP time series window covers a period of 5 minutes. Note that it may take up to 30 seconds or more till the first PPP solutions becomes available. The following figure shows the screenshot of a PPP time series plot of North, East and Up coordinate components.
2102</p>
2103
2104<p><img src="IMG/screenshot13.png"/></p>
2105<p><u>Figure 21:</u> Time series plot of PPP session.</p>
2106
2107<p><a name="bottom"><h4>4.18. Bottom Menu Bar</h4></p>
2108<p>
2109The bottom menu bar allows to add or delete streams to BNC's configuration and to start or stop it. It also provides access to BNC's online help function. The 'Add Stream' button opens a window that allows user to select one of several input communication links, see figure below.
2110</p>
2111
2112<p><img src="IMG/screenshot06.png"/></p>
2113<p><u>Figure 22:</u> Steam input communication links.</p>
2114
2115<p><a name="streamadd"><h4>4.18.1 Add Stream - Coming from Caster</h4></p>
2116
2117<p>
2118Button 'Add Stream' &gt; 'Coming from Caster' then opens a window that allows user to select data streams from an NTRIP Broadcaster according to their mountpoints and show a distribution map of offered streams.
2119</p>
2120
2121<p><a name="streamhost"><h4>4.18.1.1 Caster Host and Port - mandatory</h4></p>
2122<p>
2123Enter the NTRIP Broadcaster host IP and port number. Note that EUREF and IGS operate NTRIP Broadcasters at <u>http://www.euref-ip.net/home</u> and <u>http://www.igs-ip.net/home</u> and <u>http://www.products.igs-ip.net/home</u>.
2124</p>
2125
2126<p><a name="streamtable"><h4>4.18.1.2 Casters Table - optional</h4></p>
2127<p>
2128It may be that your are not sure about your NTRIP Broadcasters host and port number or you are interested in other broadcaster installations operated elsewhere. Hit 'Show' for a table of known broadcasters maintained at <u>www.rtcm-ntrip.org/home</u>. A window opens which allows to select a broadcaster for stream retrieval, see figure below.
2129</p>
2130</p>
2131<p><img src="IMG/screenshot04.png"/></p>
2132
2133<p><u>Figure 23:</u> Casters table.</p>
2134
2135<p><a name="streamuser"><h4>4.18.1.3 User and Password - mandatory for protected streams</h4></p>
2136<p>
2137Some streams on NTRIP Broadcasters may be restricted. Enter a valid 'User' ID and 'Password' for access to protected streams. Accounts are usually provided per NTRIP Broadcaster through a registration procedure. Register through <u>http://igs.bkg.bund.de/ntrip/registeruser</u> for access to protected streams on <u>www.euref-ip.net</u> or <u>www.igs-ip.net</u> or <u>products.igs-ip.net</u>.
2138</p>
2139
2140<p><a name="gettable"><h4>4.18.1.4 Get Table</h4></p>
2141<p>
2142Use the 'Get Table' button to download the source-table from the NTRIP Broadcaster. Pay attention to data fields 'format' and 'format-details'. Keep in mind that BNC can only decode and convert streams that come in RTCM Version 2, RTCM Version 3, or RTNET format. For access to observations, ephemeris or ephemeris corrections, an RTCM Version 2 streams must contain message types 18 and 19 or 20 and 21 while an RTCM Version 3 streams must contain
2143<ul>
2144<li>GPS or SBAS message types 1002 or 1004, or</li>
2145<li>GLONASS message types 1010 or 1012, or</li>
2146<li>proposed State Space Representation messages for GPS and GLONASS, types 1057-1068, or</li>
2147<li>proposed 'Multiple Signal Messages' (MSM) for GPS, GLONASS, or Galileo, types 1071-1077, 1081-1087, or 1091-1097.</li>
2148</ul>
2149see data field 'format-details' for available message types and their repetition rates in brackets. Note that in order to produce RINEX Navigation files RTCM Version 3 streams containing message types 1019 (GPS) and 1020 (GLONASS) and 1045 (Galileo) are required. Select your streams line by line, use +Shift and +Ctrl when necessary. The figure below provides an example source-table.
2150</p>
2151<p>
2152The contents of data field 'nmea' tells you whether a stream retrieval needs to be initiated by BNC through sending an NMEA-GGA message carrying approximate position coordinates (virtual reference station).
2153</p>
2154<p>
2155Hit 'OK' to return to the main window. If you wish you can click on 'Add Stream' and repeat the process again to retrieve streams from different casters.
2156</p>
2157<p><img src="IMG/screenshot05.png"/></p>
2158<p><u>Figure 24:</u> Broadcaster source-table.</p>
2159
2160<p>Button 'Map' leads to the presentation of a map showing the distribution of streams offered through the downloaded source-table.</p>
2161
2162<p><a name="ntripv"><h4>4.18.1.5 NTRIP Version - mandatory</h4></p>
2163<p>
2164Some limitations and deficiencies of the NTRIP Version 1 stream transport protocol are solved in NTRIP Version 2. Improvements mainly concern a full HTTP compatibility in view of requirements coming from proxy servers. Version 2 is backwards compatible to Version 1. Options implemented in BNC are:
2165</p>
2166<p>
2167&nbsp; 1:&nbsp; NTRIP Version 1, TCP/IP.<br>
2168&nbsp; 2:&nbsp; NTRIP Version 2 in TCP/IP mode.<br>
2169&nbsp; 2s:&nbsp; NTRIP Version 2 in TCP/IP mode via SSL.<br>
2170&nbsp; R:&nbsp; NTRIP Version 2 in RTSP/RTP mode.<br>
2171&nbsp; U:&nbsp; NTRIP Version 2 in UDP mode.
2172</p>
2173<p>
2174If NTRIP Version 2 is supported by the broadcaster:
2175</p>
2176<ul>
2177<li>Try using option '2' if your streams are otherwise blocked by a proxy server operated in front of BNC.</li>
2178<li>Option 'R' or 'U' may be selected if latency is more important than completeness for your application. Note that the latency reduction is likely to be in the order of 0.5 sec or less. Note further that options 'R' (RTSP/RTP mode) and 'U' (UDP mode) are not accepted by proxy servers and a mobile Internet Service Provider may not support it.</li>
2179</ul>
2180<p>
2181Select option '1' if you are not sure whether the broadcaster supports NTRIP Version 2.</li>
2182</p>
2183
2184<p><a name="map"><h4>4.18.1.6 Map - optional</h4></p>
2185<p>
2186Button 'Map' opens a window to show a distribution map of the casters' streams. You may like to zoom in or out using option 'Zoom +' or 'Zoom -'. You may also like to 'Clean' or 'Reset' a map or let it 'Fit' exactly to the current size of the window. Option 'Close' shuts the window.
2187</p>
2188<p><img src="IMG/screenshot24.png"/></p>
2189<p><u>Figure 25:</u> Stream distribution map derived from NTRIP Broadcaster source-table.</p>
2190
2191<p><a name="streamip"><h4>4.18.2 Add Stream - Coming from TCP/IP Port</h4></p>
2192<p>
2193Button 'Add Stream' &gt; 'Coming from TCP/IP Port' allows to retrieve streams via TCP directly from an IP address without using the NTRIP transport protocol. For that you:
2194<ul>
2195<li>Enter the IP address of the stream providing host.</li>
2196<li>Enter the IP port number of the stream providing host.</li>
2197<li>Specify a mountpoint. Recommended is a 4-character station ID. Example: FFMJ</li>
2198<li>Specify the stream format. Available options are 'RTCM_2', 'RTCM_3', 'RTNET', and 'ZERO'.</li>
2199<li>Enter the approximate latitude of the stream providing rover in degrees. Example: 45.32.</li>
2200<li>Enter the approximate longitude of the stream providing rover in degrees. Example: -15.20.</li>
2201</ul>
2202</p>
2203<p>
2204Streams directly received from a TCP/IP port show up with an 'N' for 'No NTRIP' in the 'Streams' canvas section on BNC's main window. Latitude and longitude are to be entered just for informal reasons.
2205<p>
2206</p>
2207Note that this option works only if no proxy server is involved in the communication link.
2208</p>
2209
2210<p><a name="streamudp"><h4>4.18.3 Add Stream - Coming from UDP Port</h4></p>
2211<p>
2212Button 'Add Stream' &gt; 'Coming from UDP Port' allows to pick up streams arriving directly at one of the local host's UDP ports without using the NTRIP transport protocol. For that you:
2213<ul>
2214<li>Enter the local port number where the UDP stream arrives.</li>
2215<li>Specify a mountpoint. Recommended is a 4-character station ID. Example: FFMJ</li>
2216<li>Specify the stream format. Available options are 'RTCM_2', 'RTCM_3', 'RTNET', and 'ZERO'.</li>
2217<li>Enter the approximate latitude of the stream providing rover in degrees. Example: 45.32.</li>
2218<li>Enter the approximate longitude of the stream providing rover in degrees. Example: -15.20.</li>
2219</ul>
2220</p>
2221<p>
2222Streams directly received at a UDP port show up with a 'UN' for 'UDP, No NTRIP' in the 'Streams' canvas section on BNC's main window. Latitude and longitude are to be entered just for informal reasons.
2223<p>
2224
2225<p><a name="streamser"><h4>4.18.4 Add Stream - Coming from Serial Port</h4></p>
2226<p>
2227Button 'Add Stream' &gt; 'Coming from Serial Port' allows to retrieve streams from a GNSS receiver via serial port without using the NTRIP transport protocol. For that you:
2228<ul>
2229<li>Specify a mountpoint. Recommended is a 4-character station ID. Example: FFMJ</li>
2230<li>Specify the stream format. Available options are 'RTCM_2', 'RTCM_3', 'RTNET', and 'ZERO'.</li>
2231<li>Enter the approximate latitude of the stream providing receiver in degrees. Example: 45.32.</li>
2232<li>Enter the approximate longitude of the stream providing receiver in degrees. Example: -15.20.</li>
2233<li>Enter the serial 'Port name' selected on your host for communication with the receiver. Valid port names are
2234<pre>
2235Windows: COM1, COM2
2236Linux: /dev/ttyS0, /dev/ttyS1
2237FreeBSD: /dev/ttyd0, /dev/ttyd1
2238Digital Unix: /dev/tty01, /dev/tty02
2239HP-UX: /dev/tty1p0, /dev/tty2p0
2240SGI/IRIX: /dev/ttyf1, /dev/ttyf2
2241SunOS/Solaris: /dev/ttya, /dev/ttyb
2242</pre>
2243</li>
2244<li>Select a 'Baud rate' for the serial input. Note that using a high baud rate is recommended.</li>
2245<li>Select the number of 'Data bits' for the serial input. Note that often '8' data bits are used.</li>
2246<li>Select the 'Parity' for the serial input. Note that parity is often set to 'NONE'.</li>
2247<li>Select the number of 'Stop bits' for the serial input. Note that often '1' stop bit is used.</li>
2248<li>Select a 'Flow control' for the serial link. Select 'OFF' if you don't know better.</li>
2249</ul>
2250</p>
2251<p>
2252When selecting one of the serial communication options listed above, make sure that you pick those configured to the serial connected GNSS receiver.
2253</p>
2254
2255<p>
2256Streams received from a serial connected GNSS receiver show up with an 'S' (for <u>S</u>erial Port, no NTRIP) in the 'Streams' canvas section on BNC's main window . Latitude and longitude are to be entered just for informal reasons.
2257<p>
2258
2259<p>
2260The following figure shows a BNC example setup for pulling a stream via serial port on a Linux operating system.
2261</p>
2262<p><img src="IMG/screenshot15.png"/></p>
2263<p><u>Figure 26:</u> BNC setup for pulling a stream via serial port.</p>
2264
2265<p><a name="start"><h4>4.18.5 Start</h4></p>
2266<p>
2267Hit 'Start' to start retrieving, decoding, and converting GNSS data streams in real-time. Note that 'Start' generally forces BNC to begin with fresh RINEX which might overwrite existing files when necessary unless the option 'Append files' is ticked.
2268</p>
2269
2270<p><a name="stop"><h4>4.18.6 Stop</h4></p>
2271<p>
2272Hit the 'Stop' button in order to stop BNC.
2273</p>
2274
2275<p><a name="cmd"><h4>4.19. Command Line Options</h4></p>
2276<p>
2277Command line options are available to run BNC in 'no window' mode or let it read data offline from one file or several files for debugging or post processing purposes. BNC will then use processing options from the configuration file. Note that the self-explaining contents of the configuration file can easily be edited. It is possible to introduce a specific configuration file name instead of using the default name 'BNC.ini'.
2278</p>
2279
2280<p><a name="nw"><h4>4.19.1 No Window Mode - optional</h4></p>
2281<p>
2282Apart from its regular windows mode, BNC can be started on all systems as a background/batch job with command line option '-nw'. BNC will then run in 'no window' mode, using processing options from its configuration file on disk. Terminate BNC using Windows Task Manager when running it in 'no window' mode on Windows systems.
2283</p>
2284<p>
2285Example:<br><br>
2286bnc.exe -nw
2287</p>
2288
2289<p><a name="post"><h4>4.19.2 File Mode - optional</h4></p>
2290<p>
2291Although BNC is primarily a real-time online tool, for debugging purposes it can be run offline to read data from a file previously saved through option 'Raw output file'. Enter the following command line option for that
2292</p>
2293<p>
2294--file &lt;<u>inputFileName</u>&gt;
2295</p>
2296
2297and specify the full path to an input file containing previously saved data. Example:<br><br>
2298./bnc --file /home/user/raw.output_110301
2299</p>
2300<p>
2301Note that when running BNC offline, it will use options for file saving, interval, sampling, PPP etc. from its configuration file.
2302</p>
2303<p>Note further that option '--file' forces BNC to appy the '-nw' option for running in 'no window' mode.
2304</p>
2305
2306<p><a name="conffile"><h4>4.19.3 Configuration File - optional</h4></p>
2307The default configuration file name is 'BNC.ini'. You may change this name at startup time using the command line option '--conf &lt;<u>confFileName</u>&gt;'. This allows running several BNC jobs in parallel on the same host using different sets of configuration options. <u>confFileName</u> stands either for the full path to a configuration file or just for a file name. If you introduce only a filename, the corresponding file will be saved in the current working directory from where BNC is started.
2308</p>
2309<p>
2310Example:<br><br>
2311./bnc --conf MyConfig.ini
2312</p>
2313<p>
2314This leads to a BNC job using configuration file 'MyConfig.ini'. The configuration file will be saved in the current working directory.
2315</p>
2316<p>
2317On a Mac-OS X v10.6 (or higher) system the command line would be
2318<br><br>
2319open -a /Applications/bnc.app --args -conf /Users/tsyan/MyConfig.ini
2320<br><br>
2321if the program is in /Applications and the configuration file 'MyConfig.ini' in /Users/tsyan.
2322</p>
2323
2324<p><a name="confopt"><h4>4.19.4 Configuration Options - optional</h4></p>
2325<p>
2326BNC applies options from the configuration file but allows updating every one of them on the command line while the contents of the configuration file remains unchanged. The command line syntax for that looks as follows
2327</p>
2328<p>
2329--key &lt;keyName&gt; &lt;keyValue&gt;
2330</p>
2331<p>
2332where &lt;keyName&gt; stands for the name of an option contained in the configuration file and &lt;keyValue&gt; stands for the value you want to assign to it. The following is a syntax example for a complete command line:
2333</p>
2334<p>
2335bnc --nw --conf &lt;confFileName&gt --key &lt;keyName1&gt; &lt;keyValue1&gt; --key &lt;keyName2&gt; &lt;keyValue2&gt; ...
2336</p>
2337<p>
2338Example:
2339</p>
2340<p>
2341./bnc --conf CONFIG.bnc --key proxyPort 8001 --key rnxIntr "1 day"
2342</p>
2343
2344<p><a name="limits"><h3>5. Limitations &amp; Known Bugs</h3></p>
2345<ul>
2346<li>
2347In Qt-based desktop environments (like KDE) on Unix/Linux platforms it may happen that you experience a crash of BNC at startup even when running the program in the background using the '-nw' option. This is a known bug most likely resulting from an incompatibility of Qt libraries in the environment and in BNC. Entering the command 'unset SESSION_MANAGER' before running BNC may help as a work-around.
2348</li>
2349
2350<li>BNC has some limits with regards to handling data from new GNSS like COMPAS and QZSS.
2351Which observables become available on a particular stream also depends on the setup of source receiver and the data format used.
2352</li>
2353<li>
2354Using RTCM Version 3 to produce RINEX files, BNC will properly handle most message types. However, when handling message types 1001, 1003, 1009 and 1011 where the ambiguity field is not set, the output will be no valid RINEX. All values will be stored modulo 299792.458 (speed of light).
2355</li>
2356<li>
2357Using RTCM Version 2, BNC will only handle message types 18 and 19 or 20 and 21 together with position and the antenna offset information carried in types 3 and 22. Note that processing carrier phase corrections and pseudo-range corrections contained in message types 20 and 21 needs access to Broadcast Ephemeris. Hence, whenever dealing with message types 20 and 21, make sure that Broadcast Ephemeris become available for BNC through also retrieving at least one RTCM Version 3 stream carrying message types 1019 (GPS ephemeris) and 1020 (GLONASS ephemeris).
2358</li>
2359<li>
2360BNC's 'Get Table' function only shows the STR records of a source-table. You can use an Internet browser to download the full source-table contents of any NTRIP Broadcaster by simply entering its URL in the form of <u>http://host:port</u>. Data field number 8 in the NET records may provide information about where to register for an NTRIP Broadcaster account.
2361</li>
2362<li>
2363EUREF as well as IGS adhere to an open data policy. Streams are made available through NTRIP Broadcasters at <u>www.euref-ip.net</u>, <u>www.igs-ip.net</u> and <u>products.igs-ip.net</u> free of charge to anyone for any purpose. There is no indication up until now how many users will need to be supported simultaneously. The given situation may develop in such a way that it might become difficult to serve all registered users at the same times. In cases where limited resources on the NTRIP Broadcaster side (software restrictions, bandwidth limitation etc.) dictates, first priority in stream provision will be given to stream providers followed by re-broadcasting activities and real-time analysis centers while access to others might be temporarily denied.
2364</li>
2365<li>
2366Once BNC has been started, many of its configuration options cannot be changed as long as it is stopped. See chapter 'Reread Configuration' for on-the-fly configuration exceptions.
2367</li>
2368</ul>
2369
2370<p><a name="annex"><h3>6. Annex</h3></p>
2371<p>
23726.1. <a href=#history>Revision History</a><br>
23736.2. <a href=#rtcm>RTCM</a><br>
2374&nbsp; &nbsp; &nbsp; 6.2.1 NTRIP <a href=#ntrip1>Version 1</a><br>
2375&nbsp; &nbsp; &nbsp; 6.2.2 NTRIP <a href=#ntrip2>Version 2</a><br>
2376&nbsp; &nbsp; &nbsp; 6.2.3 RTCM <a href=#rtcm2>Version 2</a><br>
2377&nbsp; &nbsp; &nbsp; 6.2.4 RTCM <a href=#rtcm3>Version 3</a><br>
23786.3. <a href=#config>Configuration Examples</a><br>
23796.4. <a href=#links>Links</a>
2380</p>
2381
2382<p><a name=history><h4>6.1 Revision History</h3></p>
2383<table>
2384<tr></tr>
2385
2386<tr>
2387<td>Dec 2006 &nbsp;</td><td>Version 1.0b &nbsp;</td>
2388<td>[Add] First Beta Binaries published based on Qt 4.2.3.</td>
2389</tr>
2390
2391<tr>
2392<td>Jan 2007 &nbsp;</td><td>Version 1.1b &nbsp;</td>
2393<td>[Add] Observables C2, S1, and S2<br>[Add] Virtual reference station access<br>[Bug] RTCM2 decoder time tag fixed<br>[Mod] Small letters for public RINEX skeleton files<br>[Add] Online help through Shift+F1</td>
2394</tr>
2395
2396<tr>
2397<td>Apr 2007 &nbsp;</td><td>Version 1.2b &nbsp;</td>
2398<td>[Bug] Output only through IP port<br>[Bug] Method 'reconnecting' now thread-save<br> [Add] ZERO decoder added<br> [Mod] Download public RINEX skeletons once per day<br> [Mod] Upgrade to Qt Version 4.2.3<br> [Mod] Replace 'system' call for RINEX script by 'QProcess'<br> [Add] HTTP Host directive for skeleton file download<br> [Add] Percent encoding for user IDs and passwords<br> [Bug] Exit execution of calling thread for RTCM3 streams<br> [Bug] Signal-slot mechanism for threads</td>
2399</tr>
2400
2401<tr>
2402<td>May 2007 &nbsp;</td><td>Version 1.3 &nbsp;</td>
2403<td>[Add] Source code published.</td>
2404</tr>
2405
2406<tr>
2407<td>Jul 2007 &nbsp;</td><td>Version 1.4 &nbsp;</td>
2408<td>[Bug] Skip messages from proxy server<br> [Bug] Call RINEX script through 'nohup'</td>
2409</tr>
2410
2411<tr>
2412<td>Apr 2008 &nbsp;</td><td>Version 1.5 &nbsp;</td>
2413<td>[Add] Handle ephemeris from RTCM Version 3 streams<br> [Add] Upgrade to Qt Version 4.3.2<br> [Add] Optional RINEX v3 output<br> [Add] SBAS support<br> [Bug] RINEX skeleton download following stream outage<br> [Add] Handle ephemeris from RTIGS streams<br> [Add] Monitor stream failure/recovery and latency<br> [Mod] Redesign of main window<br> [Bug] Freezing of About window on Mac systems<br> [Bug] Fixed problem with PRN 32 in RTCMv2 decoder<br> [Bug] Fix for Trimble 4000SSI receivers in RTCMv2 decoder<br> [Mod] Major revision of input buffer in RTCMv2 decoder</td>
2414</tr>
2415
2416<tr>
2417<td>Dec 2008 &nbsp;</td><td>Version 1.6 &nbsp;</td>
2418<td>[Mod] Fill blanc columns in RINEXv3 with 0.000<br> [Add] RTCMv3 decoder for clock and orbit corrections<br>[Add] Check RTCMv3 streams for incoming message types<br> [Add] Decode RTCMv2 message types 3, 20, 21, and 22<br> [Add] Loss of lock and lock time indicator<br> [Bug] Rounding error in RTCMv3 decoder concerning GLONASS height<br> [Mod] Accept GLONASS in RTCMv3 when transmitted first<br> [Add] Leap second 1 January 2009<br> [Add] Offline mode, read data from file<br> [Add] Output antenna descriptor, coordinates and eccentricities from RTCMv3<br> [Add] Reconfiguration on-the-fly<br> [Mod] Binary output of synchronized observations<br> [Add] Binary output of unsynchronized observations<br> [Bug] Fixed problem with joined RTCMv3 blocks</td>
2419</tr>
2420
2421<tr>
2422<td>Dec 2008 &nbsp;</td><td>Version 1.6.1 &nbsp;</td>
2423<td>[Mod] HTTP GET when no proxy in front</td>
2424</tr>
2425
2426<tr>
2427<td>Nov 2009 &nbsp;</td><td>Version 1.7 &nbsp;</td>
2428<td>[Bug] RINEX navigation file format<br> [Add] Upgrade to Qt Version 4.5.2<br> [Add] Support of NTRIP v2<br> [Add] Rover support via serial port<br> [Add] Show broadcaster table from www.rtcm-ntrip.org<br> [Add] Enable/disable tab widgets<br> [Add] User defined configuration file name<br> [Mod] Switch to configuration files in ini-Format<br> [Add] Daily logfile rotation<br> [Add] Read from TCP/IP port, by-pass NTRIP transport protocol<br> [Add] Save NMEA messages coming from rover<br> [Add] Auto start<br> [Add] Drag and drop ini files<br> [Add] Read from serial port, by-pass NTRIP transport protocol<br> [Mod] Update of SSR messages following RTCM 091-2009-SC104-542<br> [Add] Read from UPD port, by-pass NTRIP transport protocol<br> [Mod] Output format of Broadcast Corrections<br> [Add] Throughput plot<br> [Add] Latency plot</td>
2429</tr>
2430
2431<tr>
2432<td>Nov 2009 &nbsp;</td><td>Version 1.8 &nbsp;</td>
2433<td>[Mod] On-the-fly reconfiguration of latency and throughput plots</td>
2434</tr>
2435
2436<tr>
2437<td>Feb 2010 &nbsp;</td><td>Version 2.0 &nbsp;</td>
2438<td>[Mod] Change sign of Broadcast Corrections<br> [Add] Real-time PPP option</td>
2439</tr>
2440
2441<tr>
2442<td>Jun 2010 &nbsp;</td><td>Version 2.1 &nbsp;</td>
2443<td>[Bug] SSR GLONASS message generation<br> [Add] PPP in post-processing mode<br> [Mod] Update of SSR messages following draft dated 2010-04-12<br> [Mod] Generating error message when observation epoch is wrong</td>
2444</tr>
2445
2446<tr>
2447<td>Jul 2010 &nbsp;</td><td>Version 2.2 &nbsp;</td>
2448<td>[Bug] GLONASS ephemeris time</td>
2449</tr>
2450
2451<tr>
2452<td>Aug 2010 &nbsp;</td><td>Version 2.3 &nbsp;</td>
2453<td>[Mod] Internal format for saving raw streams<br> [Bug] Outlier detection in GLONASS ambiguity resolution<br> [Mod] Format of PPP logs in logfile<br> [Bug] Complete acceleration terms for GLONASS ephemeris<br> [Bug] Handling ephemeris IOD's in PPP mode</td>
2454</tr>
2455
2456<tr>
2457<td>Dec 2010 &nbsp;</td><td>Version 2.4 &nbsp;</td>
2458<td>[Add] Output of averaged positions when in PPP mode<br> [Mod] Use always the latest received set of Broadcast Ephemeris<br> [Add] QuickStart PPP option<br> [Mod] Improvement of data sharing efficiency among different threads<br> [Mod] Design of PPP tab section<br> [Add] Sigmas for observations and parameters<br> [Add] Stream distribution map<br> [Bug] GPS Ephemeris in RINEX v3 format</td>
2459</tr>
2460
2461<tr>
2462<td>Feb 2011 &nbsp;</td><td>Version 2.5 &nbsp;</td>
2463<td>[Add] PPP option for sync of clock observations and corrections<br> [Add] Drafted RTCMv3 Galileo ephemeris messages 1045<br> [Add] Drafted RTCMv3 Multiple Signal Messages<br> [Add] Optional specification of sigmas for coordinates and troposphere in PPP<br> [Add] Include Galileo in SPP<br> [Add] Include Galileo observations in output via IP port<br> [Add] Include Galileo observations in output via RINEXv3 files<br> [Mod] Interface format for feeding a real-time engine with observations<br> [Add] Correct observations for antenna phase center offsets<br> [Add] Combine orbit/clock correction streams<br> [Add] Specify corrections mountpoint in PPP tab</td>
2464</tr>
2465
2466<tr>
2467<td>Apr 2011 &nbsp;</td><td>Version 2.6 &nbsp;</td>
2468<td>[Add] Complete integration of BNS in BNC<br> [Add] SP3 and Clock RINEX output<br> [Add] PPP in Post Processing Mode<br> [Add] Some RINEX editing & QC functionality<br> [Add] Threshold for orbit outliers in combination solution<br> [Add] Real-time engine becomes orbit/clock server instead of client<br> [Mod] 'EOE' added to orbit/clock stream from engine<br> [Add] Correction for antenna eccentricities<br> [Add] Quick start mode for PPP<br> [Mod] Design of format for feeding engine changed to follow RINEX v3<br> [Mod] Implementation of SSR message encoding modified according to standard<br> [Add] SSL/TLS Support of NTRIP Version 2<br> [Mod] Switch to Qt version 4.7.3<br> [Add] RINEX editing, concatenation and quality check<br> [Add] Reading all configuration options from command line<br> [Mod] RTCMv3 Galileo Broadcast Ephemeris message 1045</td>
2469</tr>
2470
2471<tr>
2472<td>May 2012 &nbsp;</td><td>Version 2.6 &nbsp;</td>
2473<td>[ADD] Version 2.6 published</td>
2474</tr>
2475
2476</table>
2477</p>
2478
2479<p><a name="rtcm"><h4>6.2. RTCM</h4></p>
2480
2481<p>
2482The Radio Technical Commission for Maritime Services (RTCM) is an international non-profit scientific, professional and educational organization. Special Committees provide a forum in which governmental and non-governmental members work together to develop technical standards and consensus recommendations in regard to issues of particular concern. RTCM is engaged in the development of international standards for maritime radionavigation and radiocommunication systems. The output documents and reports prepared by RTCM Committees are published as RTCM Recommended Standards. Topics concerning Differential Global Navigation Satellite Systems (DGNSS) are handled by the Special Committee SC 104.
2483<p>
2484Personal copies of RTCM Recommended Standards can be ordered through <u>http://www.rtcm.org/orderinfo.php</u>.
2485</p>
2486
2487<p><a name="ntrip1"><h4>6.2.1 NTRIP Version 1</h4></p>
2488
2489<p>
2490'Networked Transport of RTCM via Internet Protocol' Version 1.0 (NTRIP) stands for an application-level protocol streaming Global Navigation Satellite System (GNSS) data over the Internet. NTRIP is a generic, stateless protocol based on the Hypertext Transfer Protocol HTTP/1.1. The HTTP objects are enhanced to GNSS data streams.
2491</p>
2492
2493<p>
2494NTRIP Version 1 is an RTCM standard designed for disseminating differential correction data (e.g. in the RTCM-104 format) or other kinds of GNSS streaming data to stationary or mobile users over the Internet, allowing simultaneous PC, Laptop, PDA, or receiver connections to a broadcasting host. NTRIP supports wireless Internet access through Mobile IP Networks like GSM, GPRS, EDGE, or UMTS.
2495</p>
2496
2497<p>
2498NTRIP is implemented in three system software components: NTRIP Clients, NTRIP Servers and NTRIP Broadcasters. The NTRIP Broadcaster is the actual HTTP server program whereas NTRIP Client and NTRIP Server are acting as HTTP clients.
2499</p>
2500
2501<p>
2502NTRIP is an open none-proprietary protocol. Major characteristics of NTRIP's dissemination technique are:
2503<ul>
2504<li>Based on the popular HTTP streaming standard; comparatively easy to implement when having limited client and server platform resources available.</li>
2505<li>Application not limited to one particular plain or coded stream content; ability to distribute any kind of GNSS data.</li>
2506<li>Potential to support mass usage; disseminating hundreds of streams simultaneously for thousands of users possible when applying modified Internet Radio broadcasting software.</li>
2507<li>Considering security needs; stream providers and users don't necessarily get into contact, streams often not blocked by firewalls or proxy servers protecting Local Area Networks.</li>
2508<li>Enables streaming over mobile IP networks because of using TCP/IP.</li>
2509</ul>
2510</p>
2511
2512<p>
2513The NTRIP Broadcaster maintains a source-table containing information on available NTRIP streams, networks of NTRIP streams and NTRIP Broadcasters. The source-table is sent to an NTRIP Client on request. Source-table records are dedicated to one of the following: Data Streams (record type STR), Casters (record type CAS), or Networks of streams (record type NET).
2514</p>
2515
2516<p>
2517Source-table records of type STR contain the following data fields: 'mountpoint', 'identifier', 'format', 'format-details', 'carrier', 'nav-system', 'network', 'country', 'latitude', 'longitude', 'nmea', 'solution', 'generator', 'compr-encryp', 'authentication', 'fee', 'bitrate', 'misc'.
2518</p>
2519<p>
2520Source-table records of type NET contain the following data fields: 'identifiey', 'operator', 'authentication', 'fee', 'web-net', 'web-str', 'web-reg', 'misc'.
2521</p>
2522<p>
2523Source-table records of type CAS contain the following data fields: 'host', 'port', 'identifier', 'operator', 'nmea', 'country', 'latitude', 'longitude', 'misc'.
2524</p>
2525
2526<p><a name="ntrip2"><h4>6.2.2 NTRIP Version 2</h4></p>
2527
2528<p>
2529The major changes of NTRIP Version 2 compared to Version 1.0 are:
2530</p>
2531
2532<ul>
2533<li>cleared and fixed design problems and HTTP protocol violations;</li>
2534<li>replaced non standard directives;</li>
2535<li>chunked transfer encoding;</li>
2536<li>improvements in header records;</li>
2537<li>source-table filtering; and</li>
2538<li>RTSP communication.</li>
2539</ul>
2540
2541<p>NTRIP Version 2 allows to either communicate in TCP/IP mode or in RTSP/RTP mode or in UDP mode whereas Version 1 is limited to TCP/IP only. It furthermore allows using the Transport Layer Security (TLS) and its predecessor, Secure Sockets Layer (SSL) cryptographic protocols for secure NTRIP communication over the Internet.
2542</p>
2543
2544<p><a name="rtcm2"><h4>6.2.3 RTCM Version 2</h4></p>
2545<p>
2546Transmitting GNSS carrier phase data can be done through RTCM Version 2 messages. Please note that only RTCM Version 2.2 and 2.3 streams may include GLONASS data. Messages that may be of some interest here are:
2547</p>
2548
2549<ul>
2550<li>
2551Type 1 message is the range correction message and is the primary message in code-phase differential positioning (DGPS). It is computed in the base receiver by computing the error in the range measurement for each tracked SV.
2552</li>
2553<li>
2554Type 2 message is automatically generated when a new set of satellite ephemeris is downloaded to the base receiver. It is the computed difference between the old ephemeris and the new ephemeris. Type 2 messages are used when the base station is transmitting Type 1 messages.
2555</li>
2556<li>
2557Type 3 and 22 messages are the base station position and the antenna offset. Type 3 and 22 are used in RTK processing to perform antenna reduction.
2558</li>
2559<li>
2560Type 6 message is a null frame filler message that is provided for data links that require continuous transmission of data, even if there are no corrections to send. As many Type 6 messages are sent as required to fill in the gap between two correction messages (type 1). Message 6 is not sent in burst mode.
2561</li>
2562<li>
2563Type 9 message serves the same purpose as Type 1, but does not require a complete satellite set. As a result, Type 9 messages require a more stable clock than a station transmitting Type 1 's, because the satellite corrections have different time references.
2564</li>
2565<li>
2566Type 16 message is simply a text message entered by the user that is transmitted from the base station to the rover. It is used with code-phase differential.
2567</li>
2568<li>
2569Type 18 and 20 messages are RTK uncorrected carrier phase data and carrier phase corrections.
2570</li>
2571<li>
2572Type 19 and 21 messages are the uncorrected pseudo-range measurements and pseudo-range corrections used in RTK.
2573</li>
2574<li>
2575Type 23 message provides the information on the antenna type used on the reference station.
2576</li>
2577<li>
2578Type 24 message carries the coordinates of the installed antenna's ARP in the GNSS coordinate system coordinates.
2579</li>
2580</ul>
2581
2582<p><a name="rtcm3"><h4>6.2.4 RTCM Version 3</h4></p>
2583<p>
2584RTCM Version 3 has been developed as a more efficient alternative to RTCM Version 2. Service providers and vendors have asked for a standard that would be more efficient, easy to use, and more easily adaptable to new situations. The main complaint was that the Version 2 parity scheme was wasteful of bandwidth. Another complaint was that the parity is not independent from word to word. Still another was that even with so many bits devoted to parity, the actual integrity of the message was not as high as it should be. Plus, 30-bit words are awkward to handle. The Version 3 standard is intended to correct these weaknesses.
2585</p>
2586<p>
2587RTCM Version 3 defines a number of message types. Messages that may be of interest here are:
2588<ul>
2589<li>Type 1001, GPS L1 code and phase.</li>
2590<li>Type 1002, GPS L1 code and phase and ambiguities and carrier to noise ratio.</li>
2591<li>Type 1003, GPS L1 and L2 code and phase.</li>
2592<li>Type 1004, GPS L1 and L2 code and phase and ambiguities and carrier to noise ratio.</li>
2593<li>Type 1005, Station coordinates XYZ for antenna reference point.</li>
2594<li>Type 1006, Station coordinates XYZ for antenna reference point and antenna height.</li>
2595<li>Type 1007, Antenna descriptor and ID.</li>
2596<li>Type 1008, Antenna serial number.</li>
2597<li>Type 1009, GLONASS L1 code and phase.</li>
2598<li>Type 1010, GLONASS L1 code and phase and ambiguities and carrier to noise ratio.</li>
2599<li>Type 1011, GLONASS L1 and L2 code and phase.</li>
2600<li>Type 1012, GLONASS L1 and L2 code and phase and ambiguities and carrier to noise ratio.</li>
2601<li>Type 1013, Modified julian date, leap second, configured message types and interval.</li>
2602<li>Type 1014 and 1017, Network RTK (MAK) messages (under development).</li>
2603<li>Type 1019, GPS ephemeris.</li>
2604<li>Type 1020, GLONASS ephemeris.</li>
2605<li>Type 4088 and 4095, Proprietary messages (under development).
2606</li>
2607</ul>
2608</p>
2609
2610<p>
2611The following are proposed 'Multiple Signal Messages' (MSM) under discussion for standardization:
2612<ul>
2613<li>Type 1045, Galileo ephemeris.</li>
2614<li>Type 1071, Compact GPS pseudo-ranges</li>
2615<li>Type 1072, Compact GPS carrier phases</li>
2616<li>Type 1073, Compact GPS pseudo-ranges and carrier phases</li>
2617<li>Type 1074, Full GPS pseudo-ranges and carrier phases plus signal strength</li>
2618<li>Type 1075, Full GPS pseudo-ranges, carrier phases, Doppler and signal strength</li>
2619<li>Type 1076, Full GPS pseudo-ranges and carrier phases plus signal strength (high resolution)</li>
2620<li>Type 1077, Full GPS pseudo-ranges, carrier phases, Doppler and signal strength (high resolution)<br></li>
2621<li>Type 1081, Compact GLONASS pseudo-ranges</li>
2622<li>Type 1082, Compact GLONASS carrier phases</li>
2623<li>Type 1083, Compact GLONASS pseudo-ranges and carrier phases</li>
2624<li>Type 1084, Full GLONASS pseudo-ranges and carrier phases plus signal strength</li>
2625<li>Type 1085, Full GLONASS pseudo-ranges, carrier phases, Doppler and signal strength</li>
2626<li>Type 1086, Full GLONASS pseudo-ranges and carrier phases plus signal strength (high resolution)</li>
2627<li>Type 1087, Full GLONASS pseudo-ranges, carrier phases, Doppler and signal strength (high resolution)<br></li>
2628<li>Type 1091, Compact Galileo pseudo-ranges</li>
2629<li>Type 1092, Compact Galileo carrier phases</li>
2630<li>Type 1093, Compact Galileo pseudo-ranges and carrier phases</li>
2631<li>Type 1094, Full Galileo pseudo-ranges and carrier phases plus signal strength</li>
2632<li>Type 1095, Full Galileo pseudo-ranges, carrier phases, Doppler and signal strength</li>
2633<li>Type 1096, Full Galileo pseudo-ranges and carrier phases plus signal strength (high resolution)</li>
2634<li>Type 1097, Full Galileo pseudo-ranges, carrier phases, Doppler and signal strength (high resolution)<br></li>
2635</ul>
2636</p>
2637
2638<p>
2639The following are so-called 'State Space Representation' (SSR) messages:
2640<ul>
2641<li>Type 1057, GPS orbit corrections to Broadcast Ephemeris</li>
2642<li>Type 1058, GPS clock corrections to Broadcast Ephemeris</li>
2643<li>Type 1059, GPS code biases</li>
2644<li>Type 1060, Combined orbit and clock corrections to GPS Broadcast Ephemeris</li>
2645<li>Type 1061, GPS User Range Accuracy (URA)</li>
2646<li>Type 1062, High-rate GPS clock corrections to Broadcast Ephemeris</li>
2647<li>Type 1063, GLONASS orbit corrections to Broadcast Ephemeris</li>
2648<li>Type 1064, GLONASS clock corrections to Broadcast Ephemeris</li>
2649<li>Type 1065, GLONASS code biases</li>
2650<li>Type 1066, Combined orbit and clock corrections to GLONASS Broadcast Ephemeris</li>
2651<li>Type 1067, GLONASS User Range Accuracy (URA)</li>
2652<li>Type 1068, High-rate GLONASS clock corrections to Broadcast Ephemeris</li>
2653</ul>
2654</p>
2655
2656<p><a name="config"><h4>6.3. Configuration Examples</h4></p>
2657
2658<p>BNC comes with a number of configuration examples which can be used on all operating systems. There are two ways to start BNC using one of these files:
2659<ul>
2660<li> On graphical systems you may use the computer mouse to "drag" a configuration file icon and "drop" it on top of BNC's program icon.
2661</li>
2662<li> On non-graphical systems you may start BNC using a command line with the following option for a configuration file (example for Windows systems):<br>bnc.exe --conf <configFileName>
2663</li>
2664</ul>
2665Presented example configuration files contain a user ID 'user' and a password 'pass' for accessing streams from various Ntrip broadcasters. Replace these account details by a the personal user ID and password you receive following an online registration through http://register.rtcm-ntrip.org.
2666</p>
2667<p>
2668Note that the account for an Ntrip broadcaster is usually limited to pulling a certain maximum number of streams at the same time. As running some of the example configurations requires pulling several streams, it is suggested to make sure that you don't exceed your account's limits.
2669</p>
2670<p>
2671Make also sure that directories which are part of the example configurations exist on your system or adjust the affected configuration according to your needs.
2672</p>
2673<p>
2674Some BNC options require Antenna Phase Center variations as made available from IGS through so-called ANTEX files in directory 'ftp://igs.org/pub/station/general'. An example ANTEX file is also part of the BNC package for convenience.
2675</p>
2676<p>
2677The example configurations assume that no proxy protects your host. Should a proxy be operated in front of BNC then you need to introduce its IP and port in the 'Network' tab.
2678</p>
2679
2680<ol type=b>
2681<li>File 'RinexObs.bnc'<br>
2682The purpose of this configuration is to convert RTCM streams to RINEX observation files. The configuration pulls streams from several Ntrip broadcasters using differen Ntrip versions and generate 1sec/15min RINEX version 3 observation files. See http://igs.bkg.bund.de/ntrip/observations for observation stream resources.
2683</li>
2684<br>
2685<li>File 'RinexEpn.bnc'<br>
2686The purpose of this configuration if to convert RTCM streams to RINEX navigation files. The configuration pulls an RTCMv3 stream carrying broadcast ephemeris coming from the real-time EUREF and IGS network. It saves hourly RINEX version 3 navigation files. See http://igs.bkg.bund.de/ntrip/ephemeris for further real-time broadcast ephemeris resources.
2687</li>
2688<br>
2689<li>File 'SSR.bnc'<br>
2690The purpose of this configuration is to save broadcast ephemeris corrections from RTCM SSR messages in a plain ASCII format as hourl files. See <u>http://igs.bkg.bund.de/ntrip/orbits</u> for further real-time IGS or EUREF orbit/clock products.
2691</li>
2692<br>
2693<li>File 'RinexConcat.bnc'<br>
2694The purpose of this configuration is to concatenate RINEX version 3 files to produce a concatenated file and edit the marker name in the file header. The sampling rate is set to 30 seconds. See section 'RINEX Editing & QC' in the documentation for examples on how to call BNC from command line in 'no window' mode for RINEX file editing, concatenation and quality checks.
2695</li>
2696<br>
2697<li>File 'RTK.bnc'<br>
2698The purpose of this configuration is to feed a serial connected receiver with observations from a reference station for conventional RTK. The stream is scanned for RTCM messages. Message type numbers and latencies of incoming observation are reported in BNC's logfile.
2699</li>
2700<br>
2701<li>File 'FeedEngine.bnc'<br>
2702The purpose of this configuration is to feed a real-time GNSS engine with observations from a number of remote reference stations. The configuration pulls streams provided in various formats from different Ntrip broadcasters. Incoming observations are decoded, synchronized and output through a local IP port and saved into a file. Failure and recovery thresholds are specified to inform about outages.
2703</li>
2704<br>
2705<li>File 'PPP.bnc'<br>
2706The purpose of this configuration is Precise Point Positioning from observations of a rover receiver. The configuration reads RTCMv3 observations, a stream of orbit and clock correctors and a broadcast ephemeris stream. Positions are saved in the logfile.
2707</li>
2708<br>
2709<li>File 'QuickStartPPP.bnc'<br>
2710The purpose of this configuration is Precise Point Positioning in QuickStart mode from observations of a static receiver with precisely known position. The configuration reads RTCMv3 observations, orbit and clock correctors and a broadcast ephemeris stream. Positions are saved in NMEA format on disc and output through IP port for real-time visualization with tools like RTKNAVI.
2711</li>
2712<br>
2713<li>File 'PPPPostProc.bnc<br>
2714The purpose of this configuration is Precise Point Positioning in Post Processing mode. BNC reads a RINEX observation and a RINEX v3 navigation files and a broadcast corrections files. PPP processing otions are set in support of the QuickStart mode. The output is saved in a specific post processing logfile and contains the coordinates derived over time following the implemented PPP filter algorithm.
2715</li>
2716<br>
2717<li>File 'Sp3PPP.bnc'<br>
2718The purpose of this configuration is to produce SP3 files from a broadcast broadcast ephemeris stream and a stream carrying broadcast corrections. The single broadcast corrections stream is formally introduced in BNC's combination option for the reason of producing the SP3 file. Pulling in addition observations from a reference station with precisely know coordinates allows a continuous quality check of the broadcast corrections through observing coordinate displacements from an 'INTERNAL' PPP solution.
2719</li>
2720<br>
2721<li>File 'Sp3ETRF2000PPP.bnc'<br>
2722This configuration equals the 'SP3PPP.bnc' configuration. However, it pulls the broadcast corrections stream 'EUREF01' which is refered to ETRF2000. Hence the SP3 file contains orbits refering to ETRF2000 and the 'INTERNAL' PPP solutions is compared to ETRF2000 coordinates.
2723</li>
2724<br>
2725<li>File 'Upload.bnc'<br>
2726The purpose of this configuration is to upload orbits and clocks coming from a real-time GNSS engine to an Ntrip broadcaster. For that the configuration reads precise orbits and clocks in RTNET format. It also reads a stream carrying broadcast ephemeris. BNC converts the orbits and clocks into broadcast corrections and encodes them in RTCMv3 SSR messages messages to uploads them to an Ntrip broadcaster. The broadcast corrections stream is refered to satellite Center of Mass (CoM) and IGS08. Orbits are saved on disk in SP3 format and clocks in clock RINEX format.
2727</li>
2728<br>
2729<li>File 'UploadPPP.bnc'<br>
2730This configuration equals the 'Upload.bnc' configuration. However, the broadcast ephemeris corrections are in addition used for an 'INTERNAL' PPP soltution based on observations from a static reference station with known precise coordinates. This allows a continuous quality ckeck of the broadcast ephemeris corrections through observing coordinate displacements.
2731</li>
2732<br>
2733<li>File 'Combi.bnc'<br>
2734The purpose of this configuration is to pulls several streams carrying broadcast corrections and a broadcast ephemeris stream from an Ntrip broadcaster to produce a combined broadcast corrections stream. BNC encodes the combination product in RTCMv3 SSR messages and uploads it to an Ntrip broadcaster. The broadcast corrections stream is not refered to satellite Center of Mass (CoM). It is refered to IGS08. Orbits are saved in SP3 format and clocks in clock RINEX format.
2735</li>
2736<br>
2737<li>File 'CombiPPP.bnc'<br>
2738This configuration equals the 'Combi.bnc' configuration. However, the combined broadcast ephemeris corrections are in addition used for an 'INTERNAL' PPP solutions based on observations from a static reference station with known precise coordinates. This allows a continuous quality check of the combination product through observing coordinate displacements.
2739</li>
2740<br>
2741<li>File 'UploadEph.bnc'<br>
2742The purpose of this configuration is to pull a number of streams from reference stations to take out contained broadcast ephemeris messages. These are encoded then in a specific RTCMv3 stream which only provides broadcast ephemeris with an update rate of 5 seconds.
2743</li>
2744</ol>
2745</p>
2746
2747<p>
2748The following table's left column is an example for the contents of a configuration file 'BNC.ini'. It enables the retrieval of an observations stream via NTRIP for the generation of 15 min RINEX files:
2749</p>
2750<table>
2751<tr></tr>
2752<tr><td><b>Option</b></td><td><b>Affiliation</b></td></tr>
2753<tr><td>[General]</td><td>Settings: Group</td></tr>
2754<tr><td>startTab=0</td><td>Internal: Top tab index</td></tr>
2755<tr><td>statusTab=0</td><td>Internal: Bottom tab index</td></tr>
2756<tr><td>font=</td><td>Internal: Used font</td></tr>
2757<tr><td>casterUrlList=http://user:pass@euref-ip:2101</td><td>Internal: Visited URLs</td></tr>
2758<tr><td>mountPoints=//user:pass@www.euref-ip.net:2101<br>/ACOR0 RTCM_2.3 43.36 351.60 no 1</td><td>Add Streams: broadcaster:port/mountpoint</td></tr>
2759<tr><td>ntripVersion=1</td><td>Add Stream: NTRIP Version</td></tr>
2760
2761<tr><td>proxyHost=</td><td>Network: Proxy host</td></tr>
2762<tr><td>proxyPort=</td><td>Network: Proxy port</td></tr>
2763<tr><td>sslCaCertPath=</td><td>Network: Path to SSL certificates</td></tr>
2764<tr><td>ignoreSslErrors=0</td><td>Network: Ignore ssl authorization errors</td></tr>
2765
2766<tr><td>logFile=/home/weber/bnc.log</td><td>General: Logfile (full path)</td></tr>
2767<tr><td>rnxAppend=2</td><td>General: Append files</td></tr>
2768<tr><td>onTheFlyInterval=1 day</td><td>General: Reread configuration</td></tr>
2769<tr><td>autoStart=0</td><td>General: Auto start</td></tr>
2770<tr><td>rawOutFile=</td><td>General: Raw output file (full path)</td></tr>
2771
2772<tr><td>rnxPath=/home/user/rinex</td><td>RINEX Observations: Directory</td></tr>
2773<tr><td>rnxIntr=15 min</td><td>RINEX Observations: Interval</td></tr>
2774<tr><td>rnxSample=0</td><td>RINEX Observations: Sampling</td></tr>
2775<tr><td>rnxSkel=</td><td>RINEX Observations: Skeleton extension</td></tr>
2776<tr><td>rnxScript=</td><td>RINEX Observations: Uplod script</td></tr>
2777<tr><td>rnxV3=0</td><td>RINEX Observation: Version 3</td></tr>
2778
2779<tr><td>ephPath=</td><td>RINEX Ephemeris: Directory</td></tr>
2780<tr><td>ephIntr=15 min</td><td>RINEX Ephemeris: Interval</td></tr>
2781<tr><td>outEphPort=</td><td>RINEX Ephemeris: Port</td></tr>
2782<tr><td>ephV3=0</td><td>RINEX Ephemeris: Version 3</td></tr>
2783
2784<tr><td>corrPath=</td><td>Broadcast Corrections: Directory, ASCII </td></tr>
2785<tr><td>corrIntr=1 day</td><td>Broadcast Corrections: Interval</td></tr>
2786<tr><td>corrPort=</td><td>Broadcast Corrections: Port</td></tr>
2787<tr><td>corrTime=5</td><td>Broadcast Corrections: Wait for full epoch</td></tr>
2788
2789<tr><td>outPort=</td><td>Feed Engine: Port</td></tr>
2790<tr><td>waitTime=5</td><td>Feed Engine: Wait for full epoch</td></tr>
2791<tr><td>binSampl=0</td><td>Feed Engine: Sampling</td></tr>
2792<tr><td>outFile=</td><td>Feed Engine: File (full path)</td></tr>
2793<tr><td>outUPort=</td><td>Feed Engine: Port (unsynchronized)</td></tr>
2794
2795<tr><td>serialMountPoint=</td><td>Serial Output: Mountpoint</td></tr>
2796<tr><td>serialPortName=</td><td>Serial Output: Port name</td></tr>
2797<tr><td>serialBaudRate=9600</td><td>Serial Output: Baud rate</td></tr>
2798<tr><td>serialFlowControl=</td><td>Serial Output: Flow control</td></tr>
2799<tr><td>serialDataBits=8</td><td>Serial Output: Data bits</td></tr>
2800<tr><td>serialParity=NONE</td><td>Serial Output: Parity</td></tr>
2801<tr><td>serialStopBits=1</td><td>Serial Output: Stop bits</td></tr>
2802<tr><td>serialAutoNMEA=Auto</td><td>Serial Output: NMEA</td></tr>
2803<tr><td>serialFileNMEA=</td><td>Serial Output: NMEA file name</td></tr>
2804<tr><td>serialHeightNMEA=</td><td>Serial Output: Height</td></tr>
2805
2806<tr><td>obsRate=</td><td>Outages: Observation rate</td></tr>
2807<tr><td>adviseFail=15</td><td>Outages: Failure threshold</td></tr>
2808<tr><td>adviseReco=5</td><td>Outages: Recovery threshold</td></tr>
2809<tr><td>adviseScript=</td><td>Outages: Script (full path)</td></tr>
2810
2811<tr><td>miscMount=</td><td>Miscellaneous: Mountpoint</td></tr>
2812<tr><td>perfIntr=</td><td>Miscellaneous: Log latency</td></tr>
2813<tr><td>scanRTCM=0</td><td>Miscellaneous: Scan RTCM</td></tr>
2814
2815<tr><td>pppSPP=PPP</td><td>PPP Client: PPP/SPP</td></tr>
2816<tr><td>pppMount=</td><td>PPP Client: Observations Mountpoint</td></tr>
2817<tr><td>pppCorrMount=</td><td>PPP Client: Corrections Mountpoint</td></tr>
2818<tr><td>pppRefCrdX=</td><td>PPP Client: X coordinate of plot origin</td></tr>
2819<tr><td>pppRefCrdY=</td><td>PPP Client: Y coordinate of plot origin</td></tr>
2820<tr><td>pppRefCrdZ=</td><td>PPP Client: Z coordinate of plot origin</td></tr>
2821<tr><td>pppRefdN=</td><td>PPP Client: North eccentricity</td></tr>
2822<tr><td>pppRefdE=</td><td>PPP Client: East eccentricity</td></tr>
2823<tr><td>pppRefdU=</td><td>PPP Client: Up eccentricity</td></tr>
2824<tr><td>nmeaFile=</td><td>PPP Client: NMEA outputfile</td></tr>
2825<tr><td>nmeaPort=</td><td>PPP Client: NMEA IP output port</td></tr>
2826<tr><td>pppPlotCoordinates=0</td><td>PPP Client: Plot NEU time series</td></tr>
2827<tr><td>postObsFile=</td><td>PPP Client: Observations file</td></tr>
2828<tr><td>postNavFile=</td><td>PPP Client: Navigation file</td></tr>
2829<tr><td>postCorrFile=</td><td>PPP Client: Corrections file</td></tr>
2830<tr><td>postOutFile=</td><td>PPP Client: Output file</td></tr>
2831<tr><td>pppAntenna=</td><td>PPP Client: Antenna name</td></tr>
2832<tr><td>pppAntex=</td><td>PPP Client: Path to ANTEX file</td></tr>
2833<tr><td>pppApplySatAnt=</td><td>PPP Client: Apply sat antenna phase center Offset</td></tr>
2834<tr><td>pppUsePhase=0</td><td>PPP Client: Use phase data </td></tr>
2835<tr><td>pppEstTropo=0</td><td>PPP Client: Estimate troposphere</td></tr>
2836<tr><td>pppGLONASS=0</td><td>PPP Client: Use GLONASS</td></tr>
2837<tr><td>pppGalileo=0</td><td>PPP Client: Use Galileo</td></tr>
2838<tr><td>pppSync=</td><td>PPP Client: Sync observations and corrections</td></tr>
2839<tr><td>pppAverage=</td><td>PPP Client: Lenght of time window for moving average</td></tr>
2840<tr><td>pppQuickStart=200</td><td>PPP Client: Quick-Start period</td></tr>
2841<tr><td>pppMaxSolGap=</td><td>PPP Client: Maximal Solution Gap</td></tr>
2842<tr><td>pppSigmaCode=5.0</td><td>PPP Client: Sigma for Code observations</td></tr>
2843<tr><td>pppSigmaPhase=0.02</td><td>PPP Client: Sigma for Phase observations</td></tr>
2844<tr><td>pppSigmaCrd0=100.0</td><td>PPP Client: Sigma for initial XYZ coordinate</td></tr>
2845<tr><td>pppSigmaCrdP=100.0</td><td>PPP Client: White noise for XYZ</td></tr>
2846<tr><td>pppSigmaTrp0=0.1</td><td>PPP Client: Sigma for initial tropospheric delay</td></tr>
2847<tr><td>pppSigmaTrpP=1e-6</td><td>PPP Client: White noise for tropospheric delay</td></tr>
2848
2849<tr><td>reqcAction=</td><td>Reqc: Action</td></tr>
2850<tr><td>reqcObsFile=</td><td>Reqc: Observations file</td></tr>
2851<tr><td>reqcNavFile=</td><td>Reqc: Navigation file</td></tr>
2852<tr><td>reqcOutObsFile=</td><td>Reqc: Output observations file</td></tr>
2853<tr><td>reqcOutNavFile=</td><td>Reqc: Output navigation file</td></tr>
2854<tr><td>reqcOutLogFile=</td><td>Reqc: Output logfile</td></tr>
2855<tr><td>reqcRnxVersion=</td><td>Reqc: RINEX version</td></tr>
2856<tr><td>reqcSampling=</td><td>Reqc: RINEX sampling</td></tr>
2857<tr><td>reqcStartDateTime=</td><td>Reqc: Start time</td></tr>
2858<tr><td>reqcEndDateTime=</td><td>Reqc: Stop time</td></tr>
2859<tr><td>reqcRunBy=</td><td>Reqc: Operators name</td></tr>
2860<tr><td>reqcComment=</td><td>Reqc: Additional comments</td></tr>
2861<tr><td>reqcOldMarkerName=</td><td>Reqc: Old marker</td></tr>
2862<tr><td>reqcNewMarkerName=</td><td>Reqc: New marker</td></tr>
2863<tr><td>reqcOldAntennaName=</td><td>Reqc: Old antenna</td></tr>
2864<tr><td>reqcNewAntennaName=</td><td>Reqc: New antenna</td></tr>
2865<tr><td>reqcOldReceiverName=</td><td>Reqc: Old receiver</td></tr>
2866<tr><td>reqcNewReceiverName=</td><td>Reqc: New receiver</td></tr>
2867
2868<tr><td>combineStreams=</td><td>Combination: List of correction streams</td></tr>
2869<tr><td>cmbMethod=Filter</td><td>Combination: Approach</td></tr>
2870<tr><td>cmbMaxres=</td><td>Combination: Clock outlier threshold</td></tr>
2871
2872<tr><td>uploadMountpointsOut=</td><td>Upload(clk): Upload streams</td></tr>
2873<tr><td>uploadIntr=1 day</td><td>Upload(clk): File interval</td></tr>
2874<tr><td>uploadSampl=5</td><td>Upload(clk): Clock sampling</td></tr>
2875<tr><td>uploadSamplOrb=0</td><td>Upload(clk): Orbit sampling</td></tr>
2876<tr><td>trafo_dx=</td><td>Upload(clk): Translation X</td></tr>
2877<tr><td>trafo_dy=</td><td>Upload(clk): Translation Y</td></tr>
2878<tr><td>trafo_dz=</td><td>Upload(clk): Translation Z</td></tr>
2879<tr><td>trafo_dxr=</td><td>Upload(clk): Translation change X</td></tr>
2880<tr><td>trafo_dyr=</td><td>Upload(clk): Translation change Y</td></tr>
2881<tr><td>trafo_dzr=</td><td>Upload(clk): Translation change Z</td></tr>
2882<tr><td>trafo_ox=</td><td>Upload(clk): Rotation X</td></tr>
2883<tr><td>trafo_oy=</td><td>Upload(clk): Rotation Y</td></tr>
2884<tr><td>trafo_oz=</td><td>Upload(clk): Rotation Z</td></tr>
2885<tr><td>trafo_oxr=</td><td>Upload(clk): Rotation change X</td></tr>
2886<tr><td>trafo_oyr=</td><td>Upload(clk): Rotation change Y</td></tr>
2887<tr><td>trafo_ozr=</td><td>Upload(clk): Rotation change Z</td></tr>
2888<tr><td>trafo_sc=</td><td>Upload(clk): Scale</td></tr>
2889<tr><td>trafo_scr=</td><td>Upload(clk): Scale change</td></tr>
2890<tr><td>trafo_t0=</td><td>Upload(clk): Reference year</td></tr>
2891<tr><td>uploadEphHost=</td><td>Upload(eph): Host</td></tr>
2892<tr><td>uploadEphPort=</td><td>Upload(eph): Port</td></tr>
2893<tr><td>uploadEphMountpoint=</td><td>Upload(eph): Moutpoint</td></tr>
2894<tr><td>uploadEphPassword=</td><td>Upload(eph): Password</td></tr>
2895<tr><td>uploadEphSample=5</td><td>Upload(eph): Samplig</td></tr>
2896</table>
2897</p>
2898<p>
2899Note that the following configuration options saved on disk can be changed/edited on-the-fly while BNC is already processing data:
2900</p>
2901<p>
2902<ul>
2903<li>'mountPoints' to change the selection of streams to be processed, see section 'Streams',</li>
2904<li>'waitTime' to change the 'Wait for full epoch' option, see section 'Feed Engine', and</li>
2905<li>'binSampl' to change the 'Sampling' option, see section 'Feed Engine'.</li>
2906</ul>
2907</p>
2908
2909<p><a name="links"><h4>6.4 Links</h3></p>
2910<table>
2911<tr></tr>
2912<tr><td>NTRIP &nbsp;</td><td><u>http://igs.bkg.bund.de/ntrip/index</u></td></tr>
2913<tr><td>EUREF-IP NTRIP Broadcaster &nbsp;</td><td><u>http://www.euref-ip.net/home</u></td></tr>
2914<tr><td>IGS-IP NTRIP Broadcaster &nbsp;</td><td><u>http://www.igs-ip.net/home</u></td></tr>
2915<tr><td>IGS products NTRIP Broadcaster &nbsp;</td><td><u>http://products.igs-ip.net/home</u></td></tr>
2916<tr><td>IGS M-GEX NTRIP Broadcaster &nbsp;</td><td><u>http://mgex.igs-ip.net/home</u></td></tr>
2917<tr><td>Distribution of IGS-IP streams &nbsp;</td><td><u>http://www.igs.oma.be/real_time/</u></td></tr>
2918<tr><td>Completeness and latency of IGS-IP data &nbsp;</td><td><u>http://www.igs.oma.be/highrate/</u></td></tr>
2919<tr><td>NTRIP Broadcaster overview &nbsp;</td><td><u>http://www.rtcm-ntrip.org/home</u></td></tr>
2920<tr><td>NTRIP Open Source software code &nbsp;</td><td><u>http://software.rtcm-ntrip.org</u></td></tr>
2921<tr><td>EUREF-IP Project &nbsp;</td><td><u>http://www.epncb.oma.be/euref_IP</u></td></tr>
2922<tr><td>Real-time IGS Pilot Project &nbsp;</td><td><u>http://www.rtigs.net/pilot</u></td></tr>
2923<tr><td>Radio Technical Commission<br>for Maritime Services &nbsp;</td><td><u>http://www.rtcm.org</u>
2924</table>
2925
Note: See TracBrowser for help on using the repository browser.