Changeset 2119 in ntrip for trunk/BNC/bnchelp.html


Ignore:
Timestamp:
Dec 16, 2009, 12:38:29 AM (14 years ago)
Author:
weber
Message:

* empty log message *

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/BNC/bnchelp.html

    r2106 r2119  
     1<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
    12<h3>BKG Ntrip Client (BNC) Version 2.0</h3>
    23
     
    2122<h4>
    2223<a href=#purpose>1. Purpose</a><br>
    23 <a href=#resources>2. Modes & Resources</a><br>
     24<a href=#resources>2. Modes &amp; Resources</a><br>
    2425<a href=#options>3. Options</a><br>
    2526<a href=#limits>4. Limitations</a><br>
     
    5859BNC allows to by-pass its decoding and conversion algorithms, leave whatever is received untouched and save it in files.
    5960</p>
    60 <p><a name="resources"><h3>2. Modes & Resources</h3></p>
     61<p><a name="resources"><h3>2. Modes &amp; Resources</h3></p>
    6162<p>
    6263Although BNC is a real-time tool to be operated in online mode, it can be run offline for post processing of data made availabe from a file. Furthermore, apart from its regular window mode, BNC can be run as a batch/background job in a 'no window' mode using processing options from previously saved configuration.
     
    8283As 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>
    8384<p>
    84 The 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 & Drop a configuration file icon to start BNC. Some configuration options can be changed on-the-fly. See annexed 'Configuration Example' for a complete set of configuration options.
     85The 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. Some configuration options can be changed on-the-fly. See annexed 'Configuration Example' for a complete set of configuration options.
    8586</p>
    8687<p>
     
    183184</li>
    184185<li> save selected options in configuration file.<br>
    185 When using 'Save & 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 Example' for a list of on-the-fly changeable configuration options.
     186When 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 Example' for a list of on-the-fly changeable configuration options.
    186187</li>
    187188<li> quit the BNC program.
     
    209210</p>
    210211<p>
    211 BNC 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 "?" button that users can click; they then click the relevant widget to pop up the help text.
     212BNC 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.
    212213</p>
    213214
     
    436437
    437438<p>
    438 Broadcast Corrrections 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 "C".
     439Broadcast Corrrections 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;.
    439440</p>
    440441
     
    488489</p>
    489490<p>
    490 Undefined parameters are set to zero "0.000".<br>Example:
     491Undefined parameters are set to zero &quot;0.000&quot;.<br>Example:
    491492<pre>
    492493...
     
    504505</p>
    505506<ul>
    506 <li>IOD set to zero "0"</li>
     507<li>IOD set to zero &quot;0&quot;</li>
    507508<li>C0 polynomial coefficient for Clock Correction to Broadcast Ephemeris [m]</li>
    508509<li>C1 polynomial coefficient for Clock Correction to Broadcast Ephemeris [m/s]</li>
     
    626627<p><a name="corrwait"><h4>3.6.4 Wait for Full Epoch - mandatory if 'Port' is set</h4></p>
    627628<p>
    628 When feeding a real-time GNSS network engine waiting epoch by epoch for synchronized Broadcast Corrections, BNC drops (only concering 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 "COCK1: Correction overaged by 5 sec" shows up in BNC's logfile if 'Wait for full epoch' is exceeded.
     629When feeding a real-time GNSS network engine waiting epoch by epoch for synchronized Broadcast Corrections, BNC drops (only concering 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.
    629630</p>
    630631
     
    654655<p>The corresponding structures are defined as follow:</p>
    655656<pre>
    656   const char begEpoch[] = "BEGEPOCH";
    657   const char endEpoch[] = "ENDEPOCH";
     657  const char begEpoch[] = &quot;BEGEPOCH&quot;;
     658  const char endEpoch[] = &quot;ENDEPOCH&quot;;
    658659...
    659660...
     
    853854#!/bin/bash
    854855sleep $((60*RANDOM/32767))
    855 cat | mail -s "NABU: $1" email@address &lt;&lt;!
     856cat | mail -s &quot;NABU: $1&quot; email@address &lt;&lt;!
    856857Advisory Note to BNC User,
    857858Please note the following advisory received from BNC.
     
    939940
    940941<p>
    941 PPP results are saved in BNC's logfile. Depending on processing options, the following values are recorded every second (example):
     942PPP results are saved in BNC's logfile. Depending on the processing options, the following values are recorded every second (example):
    942943</p>
    943944<pre>
    944 09-12-07 11:01:50     PPP ZIM20 11:02:03.0 8    4331302.284      567537.941     4633134.936    -5.669    -0.155
     94509-12-15 22:30:39     PPP CAS10 22:30:44.0 9    -901775.887 +-  0.058    2409382.427 +-  0.046   -5816746.721 +-  0.087     0.014 +-  0.005
    945946</pre>
    946947<p>
    947 The 'PPP' string in that is followed by the selected mounpoint, a PPP time stamp, the number of processed satellites, XYZ coordinates in [m], receiver clock correction in [m], and the estimated troposphere correction in [m].
     948The 'PPP' string in that is followed by the selected mounpoint, a PPP time stamp, the number of processed satellites, XYZ coordinates and their formal errors as derived from the implemented filter in [m], and the estimated troposphere correction with its formal error in [m]. The implemented algorithm includes an outlier detection to handle clock jumps. The maximum for accepted residuals is hard coded to 10 meters for code observations and 10 centimeters for phase observations.
    948949</p>
    949950
     
    10131014</p>
    10141015<p>
    1015 <u>Window mode:</u> Hit 'Save & Reread Configuration' while BNC is in window mode and already processing data to let changes of your streams selection immediately become effective.
     1016<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.
    10161017<p>
    10171018<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 Example' for a configuration file example and a list of other on-the-fly changeable options.
     
    10441045<p><a name="streamadd"><h4>3.14.1 Add Stream - Coming from Caster</h4></p>
    10451046<p>
    1046 Button 'Add Stream' > 'Coming from Caster' opens a window that allows user to select data streams from an NTRIP broadcaster according to their mountpoints.
     1047Button 'Add Stream' &gt; 'Coming from Caster' opens a window that allows user to select data streams from an NTRIP broadcaster according to their mountpoints.
    10471048</p>
    10481049
     
    10961097<p><a name="streamip"><h4>3.14.2 Add Stream - Coming from TCP/IP Port</h4></p>
    10971098<p>
    1098 Button 'Add Stream' > '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:
     1099Button '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:
    10991100<ul>
    11001101<li>Enter the IP address of the stream providing host.</li>
     
    11151116<p><a name="streamudp"><h4>3.14.3 Add Stream - Coming from UDP Port</h4></p>
    11161117<p>
    1117 Button 'Add Stream' > '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:
     1118Button '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:
    11181119<ul>
    11191120<li>Enter the local port number where the UDP stream arrives.</li>
     
    11301131<p><a name="streamser"><h4>3.14.4 Add Stream - Coming from Serial Port</h4></p>
    11311132<p>
    1132 Button 'Add Stream' > 'Coming from Serial Port' allows to retrieve streams from a GNSS receiver via serial port without using the NTRIP transport protocol. For that you:
     1133Button '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:
    11331134<ul>
    11341135<li>Specify a mountpoint. Recommended is a 4-character station ID. Example: FFMJ</li>
     
    12301231Using RTCM Version 3.x, BNC will properly handle message types 1002, 1004, 1010, and 1012. Note that 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).
    12311232</li>
    1232 Concerning the RTCM Version 3.x premature message types 1057-1068 (see RTCM document 091-2009-SC104-542 'Version 3 Proposed Messages Set 10'), a final decision is not yet made. Note the what's implemented in BNC is just a temporary solutions.
     1233Concerning the RTCM Version 3.x premature message types 1057-1068 (see RTCM document 091-2009-SC104-542 'Version 3 Proposed Messages â&#8364;&#8220; Set 10'), a final decision is not yet made. Note the what's implemented in BNC is just a temporary solutions.
    12331234<li>
    12341235Using RTCM Version 2.x, 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.x stream carrying message types 1019 (GPS ephemeris) and 1020 (GLONASS ephemeris).
Note: See TracChangeset for help on using the changeset viewer.