Changeset 3061 in ntrip for trunk/BNC/bnchelp.html
- Timestamp:
- Mar 1, 2011, 4:23:54 PM (14 years ago)
- File:
-
- 1 edited
-
trunk/BNC/bnchelp.html (modified) (20 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/BNC/bnchelp.html
r2998 r3061 203 203 3.11.9 <a href=#pppoptcont2>Options cont'd</a><br> 204 204 3.11.9.1 <a href=#pppsync>Sync Corr</a><br> 205 3.11.9.2 <a href=#pppaverage>Averaging</a><br><br> 206 3.12. <a href=#streams>Streams</a><br> 207 3.12.1 <a href=#streamedit>Edit Streams</a><br> 208 3.12.2 <a href=#streamdelete>Delete Stream</a><br> 209 3.12.3 <a href=#streamconf>Reconfigure Streams On-the-fly</a><br><br> 210 3.13. <a href=#logs>Logging</a><br><br> 211 3.13.1 <a href=#logfile>Log</a><br> 212 3.13.2 <a href=#throughput>Throughput</a><br> 213 3.13.3 <a href=#latency>Latency</a><br> 214 3.13.4 <a href=#ppptab>PPP Plot</a><br><br> 215 3.14. <a href=#bottom>Bottom Menu Bar</a><br> 216 3.14.1. <a href=#streamadd>Add Stream - Coming from Caster</a><br> 217 3.14.1.1 <a href=#streamhost>Caster Host and Port</a><br> 218 3.14.1.2 <a href=#streamtable>Casters Table</a><br> 219 3.14.1.3 <a href=#streamuser>User and Password</a><br> 220 3.14.1.4 <a href=#gettable>Get Table</a><br> 221 3.14.1.5 <a href=#ntripv>NTRIP Version</a><br> 222 3.14.1.6 <a href=#map>Map</a><br> 223 3.14.2 <a href=#streamip>Add Stream - Coming from TCP/IP Port</a><br> 224 3.14.3 <a href=#streamudp>Add Stream - Coming from UDP Port</a><br> 225 3.14.4 <a href=#streamser>Add Stream - Coming from Serial Port</a><br> 226 3.14.5 <a href=#start>Start</a><br> 227 3.14.6 <a href=#stop>Stop</a><br><br> 228 3.15. <a href=#cmd>Command Line Options</a><br> 229 3.15.1. <a href=#nw>No Window Mode</a><br> 230 3.15.2. <a href=#post>Offline Mode</a><br> 231 3.15.3. <a href=#conffile>Configuration File</a><br> 205 3.11.9.2 <a href=#pppaverage>Averaging</a><br> 206 3.12. <a href=#combi>Combination</a><br> 207 3.12.1 <a href=#combimounttab>Mountpoints Table</a><br> 208 3.12.1.1 <a href=#combiadd>Add Row</a><br> 209 3.12.1.2 <a href=#combidel>Delete</a><br> 210 3.12.2 <a href=#combimountpnt>Mountpoint</a><br> 211 3.12.2.1 <a href=#combihost>Host</a><br> 212 3.12.2.2 <a href=#combiport>Port</a><br> 213 3.12.2.3 <a href=#combipass>Password</a><br> 214 3.12.2.4 <a href=#combioutdir>Directory, Output</a><br> 215 3.12.2.5 <a href=#combisp3dir>Directory, SP3</a><br><br> 216 3.13. <a href=#streams>Streams</a><br> 217 3.13.1 <a href=#streamedit>Edit Streams</a><br> 218 3.13.2 <a href=#streamdelete>Delete Stream</a><br> 219 3.13.3 <a href=#streamconf>Reconfigure Streams On-the-fly</a><br><br> 220 3.14. <a href=#logs>Logging</a><br> 221 3.14.1 <a href=#logfile>Log</a><br> 222 3.14.2 <a href=#throughput>Throughput</a><br> 223 3.14.3 <a href=#latency>Latency</a><br> 224 3.14.4 <a href=#ppptab>PPP Plot</a><br><br> 225 3.15. <a href=#bottom>Bottom Menu Bar</a><br> 226 3.15.1. <a href=#streamadd>Add Stream - Coming from Caster</a><br> 227 3.15.1.1 <a href=#streamhost>Caster Host and Port</a><br> 228 3.15.1.2 <a href=#streamtable>Casters Table</a><br> 229 3.15.1.3 <a href=#streamuser>User and Password</a><br> 230 3.15.1.4 <a href=#gettable>Get Table</a><br> 231 3.15.1.5 <a href=#ntripv>NTRIP Version</a><br> 232 3.15.1.6 <a href=#map>Map</a><br> 233 3.15.2 <a href=#streamip>Add Stream - Coming from TCP/IP Port</a><br> 234 3.15.3 <a href=#streamudp>Add Stream - Coming from UDP Port</a><br> 235 3.15.4 <a href=#streamser>Add Stream - Coming from Serial Port</a><br> 236 3.15.5 <a href=#start>Start</a><br> 237 3.15.6 <a href=#stop>Stop</a><br><br> 238 3.16. <a href=#cmd>Command Line Options</a><br> 239 3.16.1. <a href=#nw>No Window Mode</a><br> 240 3.16.2. <a href=#post>Offline Mode</a><br> 241 3.16.3. <a href=#conffile>Configuration File</a><br> 232 242 </p> 233 243 … … 1368 1378 </p> 1369 1379 1370 <p><a name="streams"><h4>3.12. Streams</h4></p> 1380 <p><a name="combi"><h4>3.12. Combination</h4></p> 1381 <p> 1382 Combination. 1383 </p> 1384 1385 <p><a name="combimounttab"><h4>3.12.1 Mountpoints Table</h4></p> 1386 <p> 1387 Mountpoints table. 1388 </p> 1389 1390 <p><a name="combiadd"><h4>3.12.1.1 Add Row - optional if 'Mountpoint is set</h4></p> 1391 <p> 1392 Add. 1393 </p> 1394 1395 <p><a name="combidel"><h4>3.12.1.2 Delete - optional if 'Mountpoint is set</h4></p> 1396 <p> 1397 Delete. 1398 </p> 1399 1400 <p><a name="combimountpnt"><h4>3.12.2 Mountpoint - optional</h4></p> 1401 <p> 1402 Mountpoint. 1403 </p> 1404 1405 <p><a name="combihost"><h4>3.12.2.1 Host - optional if 'Mountpoint' is set</h4></p> 1406 <p> 1407 Host. 1408 </p> 1409 1410 <p><a name="combiport"><h4>3.12.2.2 Port - mandatory if 'Host' is set</h4></p> 1411 <p> 1412 Port. 1413 </p> 1414 1415 <p><a name="combipass"><h4>3.12.2.3 Password - mandatory if 'Host' is set</h4></p> 1416 <p> 1417 Pass. 1418 </p> 1419 1420 <p><a name="combioutdir"><h4>3.12.2.4 Directory, Output - optional if 'Mountpoint' is set</h4></p> 1421 <p> 1422 OutDir. 1423 </p> 1424 1425 <p><a name="combioutsp3"><h4>3.12.2.5 Directory, SP3 - optional if 'Mountpoint' is set</h4></p> 1426 <p> 1427 SP3Dir. 1428 </p> 1429 1430 <p><a name="streams"><h4>3.13. Streams</h4></p> 1371 1431 <p> 1372 1432 Each 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. … … 1389 1449 </p> 1390 1450 1391 <p><a name="streamedit"><h4>3.1 2.1 Edit Streams</h4></p>1451 <p><a name="streamedit"><h4>3.13.1 Edit Streams</h4></p> 1392 1452 <ul> 1393 1453 <li> … … 1404 1464 </ul> 1405 1465 1406 <p><a name="streamdelete"><h4>3.1 2.2 Delete Stream</h4></p>1466 <p><a name="streamdelete"><h4>3.13.2 Delete Stream</h4></p> 1407 1467 <p> 1408 1468 To 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> 1409 1469 1410 <p><a name="streamconf"><h4>3.1 2.3 Reconfigure Streams On-the-fly</h4></p>1470 <p><a name="streamconf"><h4>3.13.3 Reconfigure Streams On-the-fly</h4></p> 1411 1471 <p> 1412 1472 The streams selection can be changed on-the-fly without interrupting uninvolved threads in the running BNC process. … … 1418 1478 </p> 1419 1479 1420 <p><a name="logs"><h4>3.1 3. Logging</h4></p>1480 <p><a name="logs"><h4>3.14. Logging</h4></p> 1421 1481 <p> 1422 1482 A 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 consumtion, for a plot showing stream latencies, and for time series plots of PPP results. 1423 1483 </p> 1424 <p><a name="logfile"><h4>3.1 3.1 Log</h4></p>1484 <p><a name="logfile"><h4>3.14.1 Log</h4></p> 1425 1485 <p> 1426 1486 Records 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. 1427 1487 </p> 1428 1488 1429 <p><a name="throughput"><h4>3.1 3.2 Throughput</h4></p>1489 <p><a name="throughput"><h4>3.14.2 Throughput</h4></p> 1430 1490 <p> 1431 1491 The 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. … … 1437 1497 <p><u>Figure:</u> Bandwidth consumption of incoming streams.</p> 1438 1498 1439 <p><a name="latency"><h4>3.1 3.3 Latency</h4></p>1499 <p><a name="latency"><h4>3.14.3 Latency</h4></p> 1440 1500 <p> 1441 1501 The 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. … … 1447 1507 <p><u>Figure:</u> Latency of incoming streams.</p> 1448 1508 1449 <p><a name="ppptab"><h4>3.1 3.4 PPP Plot</h4></p>1509 <p><a name="ppptab"><h4>3.14.4 PPP Plot</h4></p> 1450 1510 <p> 1451 1511 Precise 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 coordiate components. … … 1457 1517 <p><u>Figure:</u> Time series plot of PPP session.</p> 1458 1518 1459 <p><a name="bottom"><h4>3.1 4. Bottom Menu Bar</h4></p>1519 <p><a name="bottom"><h4>3.15. Bottom Menu Bar</h4></p> 1460 1520 <p> 1461 1521 The 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. … … 1465 1525 <p><u>Figure:</u> Steam input communication links.</p> 1466 1526 1467 <p><a name="streamadd"><h4>3.1 4.1 Add Stream - Coming from Caster</h4></p>1527 <p><a name="streamadd"><h4>3.15.1 Add Stream - Coming from Caster</h4></p> 1468 1528 1469 1529 <p> … … 1471 1531 </p> 1472 1532 1473 <p><a name="streamhost"><h4>3.1 4.1.1 Caster Host and Port - mandatory</h4></p>1533 <p><a name="streamhost"><h4>3.15.1.1 Caster Host and Port - mandatory</h4></p> 1474 1534 <p> 1475 1535 Enter 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>. 1476 1536 </p> 1477 1537 1478 <p><a name="streamtable"><h4>3.1 4.1.2 Casters Table - optional</h4></p>1538 <p><a name="streamtable"><h4>3.15.1.2 Casters Table - optional</h4></p> 1479 1539 <p> 1480 1540 It 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. … … 1485 1545 <p><u>Figure:</u> Casters table.</p> 1486 1546 1487 <p><a name="streamuser"><h4>3.1 4.1.3 User and Password - mandatory for protected streams</h4></p>1547 <p><a name="streamuser"><h4>3.15.1.3 User and Password - mandatory for protected streams</h4></p> 1488 1548 <p> 1489 1549 Some 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>. 1490 1550 </p> 1491 1551 1492 <p><a name="gettable"><h4>3.1 4.1.4 Get Table</h4></p>1552 <p><a name="gettable"><h4>3.15.1.4 Get Table</h4></p> 1493 1553 <p> 1494 1554 Use 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.x, RTCM Version 3.x, or RTIGS format. For access to observations, ephemeris or ephemris correctiors, an RTCM Version 2.x streams must contain message types 18 and 19 or 20 and 21 while an RTCM Version 3.x streams must contain … … 1512 1572 <p><u>Figure:</u> Broadcaster source-table.</p> 1513 1573 1514 <p><a name="ntripv"><h4>3.1 4.1.5 NTRIP Version - mandatory</h4></p>1574 <p><a name="ntripv"><h4>3.15.1.5 NTRIP Version - mandatory</h4></p> 1515 1575 <p> 1516 1576 Some 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: … … 1533 1593 </p> 1534 1594 1535 <p><a name="map"><h4>3.1 4.1.6 Map - optional</h4></p>1595 <p><a name="map"><h4>3.15.1.6 Map - optional</h4></p> 1536 1596 <p> 1537 1597 Button 'Map' opens a window to show a distribution map of the casters's 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. 1538 1598 </p> 1539 1599 1540 <p><a name="streamip"><h4>3.1 4.2 Add Stream - Coming from TCP/IP Port</h4></p>1600 <p><a name="streamip"><h4>3.15.2 Add Stream - Coming from TCP/IP Port</h4></p> 1541 1601 <p> 1542 1602 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: … … 1557 1617 </p> 1558 1618 1559 <p><a name="streamudp"><h4>3.1 4.3 Add Stream - Coming from UDP Port</h4></p>1619 <p><a name="streamudp"><h4>3.15.3 Add Stream - Coming from UDP Port</h4></p> 1560 1620 <p> 1561 1621 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: … … 1572 1632 <p> 1573 1633 1574 <p><a name="streamser"><h4>3.1 4.4 Add Stream - Coming from Serial Port</h4></p>1634 <p><a name="streamser"><h4>3.15.4 Add Stream - Coming from Serial Port</h4></p> 1575 1635 <p> 1576 1636 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: … … 1612 1672 <p><u>Figure:</u> BNC setup for pulling a stream via serial port.</p> 1613 1673 1614 <p><a name="start"><h4>3.1 4.5 Start</h4></p>1674 <p><a name="start"><h4>3.15.5 Start</h4></p> 1615 1675 <p> 1616 1676 Hit '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. 1617 1677 </p> 1618 1678 1619 <p><a name="stop"><h4>3.1 4.6 Stop</h4></p>1679 <p><a name="stop"><h4>3.15.6 Stop</h4></p> 1620 1680 <p> 1621 1681 Hit the 'Stop' button in order to stop BNC. 1622 1682 </p> 1623 1683 1624 <p><a name="cmd"><h4>3.1 5. Command Line Options</h4></p>1684 <p><a name="cmd"><h4>3.16. Command Line Options</h4></p> 1625 1685 <p> 1626 1686 Command line options are available to run BNC in 'no window' mode or let it read data from a file in offline mode. 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'. 1627 1687 </p> 1628 1688 1629 <p><a name="nw"><h4>3.1 5.1 No Window Mode - optional</h4></p>1689 <p><a name="nw"><h4>3.16.1 No Window Mode - optional</h4></p> 1630 1690 <p> 1631 1691 Apart 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. … … 1636 1696 </p> 1637 1697 1638 <p><a name="post"><h4>3.1 5.2 Offline Mode - optional</h4></p>1639 <p> 1640 Although BNC is primarily a real-time online tool, it can be run in offline mode to read data from a previously saved file for post-processing purposes. Enter the following command line options for that:1698 <p><a name="post"><h4>3.16.2 Offline Mode - optional</h4></p> 1699 <p> 1700 Although BNC is primarily a real-time online tool, it can be run in offline mode to read data from a previously saved file (see chapter on saving 'Raw Output File') for post-processing purposes. Enter the following command line options for that: 1641 1701 </p> 1642 1702 <p> … … 1644 1704 <li>'--file <<u>inputFileName</u>>' to enter the full path to an input file containing data previously saved by BNC.</li> 1645 1705 <li>'--format <<u>format</u>>' to enter one of the file format describing strings 'RTCM_2', 'RTCM_3' or 'RTIGS'.</li> 1706 <li>'--staID <<u>stationID</u>>' to enter the mountpoint of one of the streams contained in the input file. This allows you to</li> 1707 <ul> 1708 <li>carry out an offline PPP solution using one particular (of probably several) orbit/clock corrections stream contained in the input file.</li> 1709 <li>offline convert one specific stream (of probably several streams) contained in the input file into a RINEX file.</li> 1710 </ul> 1711 1646 1712 </ul> 1647 1713 <p> 1648 1714 Example:<br><br> 1649 ./bnc --file FFMJ.dat --format RTCM_31715 ./bnc --file raw.output_110301 --format RTCM_3 --staID FFMJ1 1650 1716 </p> 1651 1717 <p> … … 1653 1719 </p> 1654 1720 1655 <p><a name="conffile"><h4>3.1 5.3 Configuration File - optional</h4></p>1721 <p><a name="conffile"><h4>3.16.3 Configuration File - optional</h4></p> 1656 1722 The default configuration file name is 'BNC.ini'. You may change this name at startup time using the command line option '--conf <<u>confFileName</u>>'. This allows to run 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. 1657 1723 </p> … … 1839 1905 1840 1906 <tr> 1841 <td> Feb2011 </td><td>Version 2.6 </td>1907 <td>Mar 2011 </td><td>Version 2.6 </td> 1842 1908 <td>[Add]</td> 1843 1909 </tr>
Note:
See TracChangeset
for help on using the changeset viewer.
