Changeset 429 in ntrip


Ignore:
Timestamp:
Mar 29, 2007, 2:39:29 PM (15 years ago)
Author:
weber
Message:

* empty log message *

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/BNC/bnchelp.html

    r415 r429  
    88</p>
    99<p>
    10 BNC has been written under GNU General Public License (GPL). Binaries for BNC are available for Windows, Linux, and Solaris systems. It is likely that BNC can be compiled on other systems where a GNU compiler and Qt Version 4.0.1 are installed.
     10BNC has been written under GNU General Public License (GPL). Binaries for BNC are available for Windows, Linux, and Solaris systems. It is likely that BNC can be compiled on other systems where a GNU compiler and Qt Version 4.2.3 are installed.
    1111<table>
    1212<tr></tr>
    1313<tr><td><b>History</b></td></tr>
    14 <tr><td>Dec 1, 2006 &nbsp;</td><td>Version 1.0b &nbsp;</td><td>Binaries of first beta version published.</td></tr>
    15 <tr><td>Jan 20, 2007 &nbsp;</td><td>Version 1.1b &nbsp;</td><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></tr>
    16 <tr><td>Feb 1, 2007 &nbsp;</td><td>Version 1.2b &nbsp;</td><td>[Bug] Output only through IP port<br>[Bug] Method 'reconnecting' now thread-save
     14<tr><td>Dec 2006 &nbsp;</td><td>Version 1.0b &nbsp;</td><td>Binaries of first beta version published.</td></tr>
     15<tr><td>Jan 2007 &nbsp;</td><td>Version 1.1b &nbsp;</td><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></tr>
     16<tr><td>Apr 2007 &nbsp;</td><td>Version 1.2b &nbsp;</td><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'
    1717</table>
    1818</p>
     
    2828</h4>
    2929</p>
    30 <br>
    3130
    3231<p><a name="purpose"><h3>A - Purpose</h3></p>
     
    3938<li>output synchronize observations epoch by epoch through an IP port to support real-time GNSS engines.</li>
    4039</ul>
     40</p>
    4141<p>
    4242BNC decodes and converts GNSS data streams carrying code and phase data coming in
    4343</p>
     44<p>
    4445<ul>
    4546<li>RTCM Version 2.x format containing message types 18 and 19 (GPS and GLONASS), </li>
    4647<li>RTCM Version 3 format containing message types 1002 or 1004 (GPS), and 1010 or 1012 (GLONASS),</li>
    47 <li>RTIGS format (only GPS).</li>
    48 </ul>
     48<li>RTIGS format (only GPS).</li>
     49</ul>
     50Furthermore, BNC allows to by-pass its decoding and conversion algorithms, leave whatever is received untouched and save it in files.
    4951</p>
    5052<p><b>Warning</b><br>
     
    6163&nbsp; &nbsp; &nbsp; B - 4.3. <a href=#binary>Port for Binary Output</a><br>
    6264B - 5. <a href=#rinex>RINEX</a><br>
    63 &nbsp; &nbsp; &nbsp; B - 5.1. <a href=#rnxpath>RINEX Directory</a><br>
    64 &nbsp; &nbsp; &nbsp; B - 5.2. <a href=#rnxscript>RINEX Script</a><br>
    65 &nbsp; &nbsp; &nbsp; B - 5.3. <a href=#rnxinterval>RINEX File Interval</a><br>
    66 &nbsp; &nbsp; &nbsp; B - 5.4. <a href=#rnxsample>RINEX Sampling</a><br>
    67 &nbsp; &nbsp; &nbsp; B - 5.5. <a href=#rnxskeleton>RINEX Skeleton Extension</a><br>
    68 &nbsp; &nbsp; &nbsp; B - 5.6. <a href=#rnxappend>Append Files</a><br>
     65&nbsp; &nbsp; &nbsp; B - 5.1. <a href=#rnxname>RINEX File Names</a><br>
     66&nbsp; &nbsp; &nbsp; B - 5.2. <a href=#rnxpath>RINEX Directory</a><br>
     67&nbsp; &nbsp; &nbsp; B - 5.3. <a href=#rnxscript>RINEX Script</a><br>
     68&nbsp; &nbsp; &nbsp; B - 5.4. <a href=#rnxinterval>RINEX File Interval</a><br>
     69&nbsp; &nbsp; &nbsp; B - 5.5. <a href=#rnxsample>RINEX Sampling</a><br>
     70&nbsp; &nbsp; &nbsp; B - 5.6. <a href=#rnxskeleton>RINEX Skeleton Extension</a><br>
     71&nbsp; &nbsp; &nbsp; B - 5.7. <a href=#rnxappend>Append Files</a><br>
    6972B - 6. <a href=#mountpoints>Mountpoints</a><br>
    7073&nbsp; &nbsp; &nbsp; B - 6.1. <a href=#AddMounts>Add Mountpoints</a><br>
     
    195198<p><a name="rinex"><h4>B - 5. RINEX</h4></p>
    196199<p>
    197 Observations are converted to RINEX Version 2.11. RINEX file names are derived by BNC from the first 4 characters of the corresponding mountpoint (4Char Station ID) while omitting the residual part of the mountpoint string. Thus, retrieving data from mountpoints FRANKFURT and WETTZELL leads to hourly RINEX observation files named</p>
     200Observations will be converted to RINEX Version 2.11 if they come in either RTCM Version 2.x, RTCM Version 3, or RTIGS format. BNC's RINEX observation files generally contain C1, C2, P1, P2, L1, L2, S1, and S2 observations. In case an observation is unavailable, its value is set to zero '0.000'. Note that even if a RINEX file does not contain GLONASS data, the 'RINEX TYPE' field in the RINEX file header may be set to 'M (MIXED)'.
     201</p>
     202<p><a name="rnxname"><h4>B - 5.1 RINEX File Names</h4></p>
     203<p>
     204RINEX file names are derived by BNC from the first 4 characters of the corresponding mountpoint (4Char Station ID) while omitting the residual part of the mountpoint string. Thus, retrieving data from mountpoints FRANKFURT and WETTZELL leads to hourly RINEX observation files named</p>
    198205<p>
    199206FRAN{ddd}{h}.{yy}O<br>
     
    223230where 'mm' is the starting minute within the hour.
    224231</p>
    225 <p>
    226 BNC's RINEX observation files generally contain C1, C2, P1, P2, L1, L2, S1, and S2 observations. In case an observation is unavailable, its value is set to zero '0.000'. Note that even if a RINEX file does not contain GLONASS data, the 'RINEX TYPE' field in the RINEX file header may be set to 'M (MIXED)'.
    227 </p>
    228 
    229 <p><a name="rnxpath"><h4>B - 5.1 RINEX Directory - optional</h4></p>
     232
     233<p><a name="rnxpath"><h4>B - 5.2 RINEX Directory - optional</h4></p>
    230234<p>
    231235Enter a path for saving the RINEX files in a directory. If this directory does not exist, BNC will not create RINEX files. Default value for 'RINEX directory' is an empty option field, meaning that streams are not converted to RINEX.
    232236</p>
    233237
    234 <p><a name="rnxscript"><h4>B - 5.2 RINEX Script - optional</h4></p>
     238<p><a name="rnxscript"><h4>B - 5.3 RINEX Script - optional</h4></p>
    235239<p>
    236240Whenever a RINEX file is saved, you may like to compress, copy or upload it immediately via FTP. For that you enter the full path of a script or batch file which is then called to carry out these operations. The RINEX file path will be passed to the script as a command line parameter (%1 on Windows systems, $1 on Unix/Linux systems).
     
    240244</p>
    241245
    242 <p><a name="rnxinterval"><h4>B - 5.3 RINEX File Interval - mandatory if 'RINEX directory' set</h4></p>
     246<p><a name="rnxinterval"><h4>B - 5.4 RINEX File Interval - mandatory if 'RINEX directory' set</h4></p>
    243247<p>
    244248Select the interval for the RINEX file generation. Default for 'RINEX file interval' is 15 minutes.
    245249</p>
    246250
    247 <p><a name="rnxsample"><h4>B - 5.4 RINEX Sampling - mandatory if 'RINEX directory' set </h4></p>
     251<p><a name="rnxsample"><h4>B - 5.5 RINEX Sampling - mandatory if 'RINEX directory' set </h4></p>
    248252<p>
    249253Select the RINEX sample interval in seconds. Zero '0' stands for converting all incoming epochs to RINEX. Default for RINEX 'Sampling' is '0'.
    250254</p>
    251255
    252 <p><a name="rnxskeleton"><h4>B - 5.5 RINEX Skeleton Extension - optional</h4></p>
    253 <p>
    254 Whenever BNC generates a new RINEX file, it first tries to retrieve information needed for RINEX headers from so-called public RINEX header skeleton files which are derived from sitelogs. An 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 for a public RINEX header skeleton file concerning the EPN station Brussels.
     256<p><a name="rnxskeleton"><h4>B - 5.6 RINEX Skeleton Extension - optional</h4></p>
     257<p>
     258Whenever BNC starts generating RINEX 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. An 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 for a public RINEX header skeleton file concerning the EPN station Brussels.
    255259</p>
    256260<p>
     
    301305<p>
    302306
    303 <p><a name="rnxappend"><h4>B - 5.6 Append Files</h4></p>
     307<p><a name="rnxappend"><h4>B - 5.7 Append Files</h4></p>
    304308<p>
    305309When starting BNC, new RINEX files are created by default. Probably existing files will be overwritten. However, it may be desirable to append observations to already existing RINEX files following a restart of BNC after an intentional 'Stop', a system crash or a crash of BNC. Hit 'Append files' to continue with already existing files and thus save what has been recorded so far. Note that option 'Append files' also concerns the 'ASCII output file' and the 'Log' file.
     
    339343<p><a name="GetTable"><h4>B - 6.4 Get Table</h4></p>
    340344<p>
    341 Hit button 'Get Table' 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 2.x, RTCM 3, or RTIGS formats. RTCM 2.x streams must contain message types 18 and 19 while RTCM 3 streams must contain GPS message types 1002 or 1004 and may contain GLONASS message types 1010 or 1012, see data field 'format-details' for available message types and their repetition rates in brackets. Select your streams line by line, use +Shift and +Ctrl when necessary.
     345Hit button 'Get Table' 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 2.x, RTCM 3, or RTIGS format. RTCM 2.x streams must contain message types 18 and 19 while RTCM 3 streams must contain GPS message types 1002 or 1004 and may contain GLONASS message types 1010 or 1012, see data field 'format-details' for available message types and their repetition rates in brackets. Select your streams line by line, use +Shift and +Ctrl when necessary.
    342346</p>
    343347<p>
     
    355359<ul>
    356360<li>
    357 BNC automatically selects one out of several internal decoders for a stream based on its 'format' and 'format-details' as given in the source-table. It may happen that you need to overrule the automated decoder selection because of source-table setup deficiencies. Therefore BNC allows to edit the decoder string (first double-click, then edit field 'decoder', then hit Enter) for the streams shown under 'Mountpoints'. Accepted decoder strings allowed to be introduced are 'RTCM_2.x', 'RTCM_3', and 'RTIGS'.
     361BNC automatically selects one out of several internal decoders for a stream based on its 'format' and 'format-details' as given in the source-table. It may happen that you need to overrule the automated decoder selection because of source-table setup deficiencies. Therefore BNC allows to edit the decoder string (first double-click, then edit field 'decoder', then hit Enter) for the streams shown under 'Mountpoints'. Accepted decoder strings allowed to be introduced for stream decoding and conversion are 'RTCM_2.x', 'RTCM_3', and 'RTIGS'.
     362</li>
     363<li>
     364BNC allows to by-pass its stream decoding and conversion algorithms, leave whatever is received untouched and save it in daily named files. To activate this functionality you need to enter the decoder string 'ZERO'. The generated file names are build from the characters of the affected mountpoints plus the two-digit numbers for year, month, and day. Example: Setting the 'decoder' string for mountpoint WTZZ0 to 'ZERO' and runnign BNC on March 29, 2007 to save incoming data untouched in a file would lead to a file name WTZZ0_070329.
    358365</li>
    359366<li>
     
    386393Note that the self-explaining contents of the configuration file or the Windows register can easily be edited. Terminate BNC using the Windows Task Manager when running it in 'no window' mode on Windows systems.
    387394</p>
    388 <br>
    389395<p><a name="limits"><h3>C - Limitations</h3></p>
    390396<ul>
     
    431437Federal Agency for Cartography and Geodesy (BKG)<br>
    432438Frankfurt, Germany<br>
    433 euref-ip@bkg.bund.de
    434 </p>
    435 <br>
     439euref-ip@bkg.bund.de
     440</p>
    436441
    437442<p><a name="links"><h3>E - Links</h3></p>
     
    445450<tr><td>Radio Technical Commission<br>for Maritime Services &nbsp;</td><td><u>http://www.rtcm.org</u>
    446451</table>
    447 <br>
    448452
    449453<p><a name="annex"><h3>F - Annex</h3></p>
     
    458462F - 4. <a href=#config>Config File</a>
    459463</p>
    460 <br>
    461464
    462465<p><a name="ntrip"><h4>F - 1. NTRIP</h4></p>
     
    508511Copies of RTCM Recommended Standards can be ordered through <u>http://www.rtcm.org/orderinfo.php</u>.
    509512</p>
    510 <br>
    511513
    512514<p><a name="rtcm2"><h4>F - 2.1 RTCM Version 2.x</h4></p>
Note: See TracChangeset for help on using the changeset viewer.