Changeset 7485 in ntrip for trunk/BNC/src/bnchelp.html


Ignore:
Timestamp:
Oct 6, 2015, 12:53:08 PM (9 years ago)
Author:
weber
Message:

Documentation completed

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/BNC/src/bnchelp.html

    r7484 r7485  
    178178&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.19.5 <a href=#stop>Stop</a><br>
    179179&nbsp; &nbsp; &nbsp; 2.20 <a href=#cmd>Command Line Options</a><br>
    180 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.1 <a href=#nw>No Window Mode</a><br>
    181 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.2 <a href=#post>File Mode</a><br>
    182 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.3 <a href=#conffile>Configuration File</a><br>
    183 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.4 <a href=#confopt>Configuration Options</a><br>
     180&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.1 <a href=#cmdVersion>Version</a><br>
     181&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.2 <a href=#cmdDisplay>Display</a><br>
     182&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.3 <a href=#nw>No Window Mode</a><br>
     183&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.4 <a href=#post>File Mode</a><br>
     184&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.5 <a href=#conffile>Configuration File</a><br>
     185&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2.20.6 <a href=#confopt>Configuration Options</a><br>
    1841863. <a href=#annex>Annex</a><br>
    185187&nbsp; &nbsp; &nbsp; 3.1. <a href=#history>Revision History</a><br>
     
    270272<b><a name="authors">Authors</b><br><br>
    271273The BKG Ntrip Client (BNC) and its Qt Graphical User Interface (GUI) has been developed for
    272 </p>
    273 <p>
    274 Federal Agency for Cartography and Geodesy (BKG)<br>
    275 c/o Dr. Axel R&uuml;lke<br>
    276 Department of Geodesy, Section Navigation<br>
    277 Frankfurt, Germany<br>
    278 [axel.ruelke@bkg.bund.de]
    279 </p>
    280 
    281 <p>
     274<pre>
     275   Federal Agency for Cartography and Geodesy (BKG)
     276   c/o Dr. Axel R&uuml;lke
     277   Department of Geodesy, Section Navigation
     278   Frankfurt, Germany
     279   [axel.ruelke@bkg.bund.de]
     280</pre>
     281
    282282The software has been written by
    283 </p>
    284 
    285 <p>
    286 Prof. Dr. Leos Mervart<br>
    287 Czech Technical University (CTU)<br>
    288 Department of Geodesy<br>
    289 Prague, Czech Republic
     283
     284<pre>
     285   Prof. Dr. Leos Mervart
     286   Czech Technical University (CTU)
     287   Department of Geodesy
     288   Prague, Czech Republic
     289</pre>
    290290</p>
    291291
     
    592592<li>Specifying the 'Reread configuration' option lets BNC reread its configuration from disk at pre-defined intervals.</li>
    593593</ul>
    594 <li>A certain BNC configuration can be started in 'no window' mode from scratch without any configuration file if options for the active configuration level (2) are provided via command line.</li>
     594<li>A specific BNC configuration can be started in 'no window' mode from scratch without a configuration file if options for the active configuration level (2) are provided via command line.</li>
    595595</ul>
    596596</p>
     
    928928<p>SSL communication may involve queries coming from the Ntrip Broadcaster or from a HTTPS website hosting RINEX skeletons. Such a query could show up under BNC's 'Log' tab as follows:
    929929<pre>
    930 SSL Error
    931 Server Certificate Issued by:
    932 GNSS Data Center
    933 BKG (Bundesamt fuer Geodaesie und Kartographie)
    934 Cannot be verified
    935 
    936 The issuer certificate of a locally looked up certificate could not be found
    937 The root CA certificate is not trusted for this purpose
    938 No certificates could be verified
     930   SSL Error
     931   Server Certificate Issued by:
     932   GNSS Data Center
     933   BKG (Bundesamt fuer Geodaesie und Kartographie)
     934   Cannot be verified
     935
     936   The issuer certificate of a locally looked up certificate could not be found
     937   The root CA certificate is not trusted for this purpose
     938   No certificates could be verified
    939939</pre>
    940940Tick 'Ignore SSL authorization errors' if you generally trust the server and don't want to be bothered with this. Note that SSL communication is usually done over port 443.
     
    10061006</p>
    10071007<p>
    1008 See BNC's command line option -nw for an auto-start of BNC in 'no window' mode.
     1008See BNC's command line option '-nw' for an auto-start of BNC in 'no window' mode.
    10091009</p>
    10101010
     
    10161016Data will be saved in blocks in the received format separated by ASCII time stamps like (example):
    10171017<pre>
    1018 2010-08-03T18:05:28 RTCM3EPH RTCM_3 67
     1018   2010-08-03T18:05:28 RTCM3EPH RTCM_3 67
    10191019</pre>
    10201020</p>
     
    10571057
    10581058<pre>
    1059 FRAN{ddd}{h}.{yy}O
    1060 WETT{ddd}{h}.{yy}O
     1059   FRAN{ddd}{h}.{yy}O
     1060   WETT{ddd}{h}.{yy}O
    10611061</pre>
    10621062<p>
     
    10661066If there is 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 filename. For example, when simultaneously retrieving data from mountpoints FRANKFURT and FRANCE, their hourly RINEX Version 2 Observation files are named as</p>
    10671067<pre>
    1068 FRAN{ddd}{h}_KFURT.{yy}O
    1069 FRAN{ddd}{h}_CE.{yy}O
     1068   FRAN{ddd}{h}_KFURT.{yy}O
     1069   FRAN{ddd}{h}_CE.{yy}O
    10701070</pre>
    10711071<p>
    10721072If 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 filename leading i.e. to hourly RINEX Version 2 Observation files like</p>
    10731073<pre>
    1074 BRUS{ddd}{h}_0.{yy}O
    1075 BRUS{ddd}{h}_1.{yy}O
     1074   BRUS{ddd}{h}_0.{yy}O
     1075   BRUS{ddd}{h}_1.{yy}O
    10761076</pre>
    10771077<p>
    10781078Note that RINEX Version 2 filenames for all intervals less than 1 hour follow the filename convention for 15 minutes RINEX Version 2 Observation files i.e.</p>
    10791079<pre>
    1080 FRAN{ddd}{h}{mm}.{yy}O
     1080   FRAN{ddd}{h}{mm}.{yy}O
    10811081</pre>
    10821082<p>
     
    11031103Example for Mixed RINEX Version 3 GNSS observation filename, file containing 1 hour of data, one observation every second, 'MO' standing for 'Mixed Observations':
    11041104<pre>
    1105 ALGO00CAN_R_20121601000_01H_01S_MO.rnx
     1105   ALGO00CAN_R_20121601000_01H_01S_MO.rnx
    11061106</pre>
    11071107</p>
     
    11361136</p>
    11371137<pre>
    1138 BRUS.skl
    1139 FRAN.skl
    1140 WETT.skl
     1138   BRUS.skl
     1139   FRAN.skl
     1140   WETT.skl
    11411141</pre>
    11421142<p>
     
    12811281The following is an example for a RINEX Version 3 Navigation filename. The file contains one days data. 'MN' stands for 'Multi Constellation Navigation' data.
    12821282<pre>
    1283 BRDC00DEU_S_20121600000_01D_MN.rnx
     1283   BRDC00DEU_S_20121600000_01D_MN.rnx
    12841284</pre>
    12851285</p>
     
    15141514> 2015 06 15 00 00 30.0000000 39  0.6
    15151515...
    1516 
    15171516</pre>
    15181517</p>
     
    16011600BNC 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
    16021601</p>
    1603 <p>
    1604 --key &lt;keyName&gt; &lt;keyValue&gt;
    1605 </p>
     1602<pre>
     1603   --key &lt;keyName&gt; &lt;keyValue&gt;
     1604</pre>
    16061605<p>
    16071606where &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.
     
    16091608The 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 from station TLSE residing in the local directory to produce an hourly RINEX Version 3 file with 30 seconds sampling interval:
    16101609</p>
    1611 <p>
    1612 ./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
    1613 </p>
     1610<pre>
     1611   ./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
     1612</pre>
    16141613<p>
    16151614You 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:
    1616 </p>
    1617 <p>
    1618 --key reqcObsFile "tlse*"<br>
    1619 or:<br>
    1620 --key reqcObsFile tlse\*
     1615<pre>
     1616   --key reqcObsFile "tlse*"
     1617or:
     1618   --key reqcObsFile tlse\*
     1619</pre>
    16211620</p>
    16221621
    16231622<p>The following Linux command line produces RINEX QC plots (see Estey and Meertens 1999) offline in 'no window' mode and saves them in directory '/home/user'. Introducing a dummy configuration file /dev/null makes sure that no configuration options previously saved on disc are used:</p>
    1624 <p>
    1625 /home/user/bnc --conf /dev/null --key reqcAction Analyze --key reqcObsFile CUT02070.12O --key reqcNavFile BRDC2070.12P --key reqcOutLogFile CUT0.txt --key reqcPlotDir /home/user --nw
    1626 </p>
    1627 <p></p>
    1628 <p>The following Linux command line produces the same RINEX QC plots in interactive autoStart mode:</p>
    1629 <p>
    1630 /home/user/bnc --conf /dev/null --key reqcAction Analyze --key reqcObsFile CUT02070.12O --key reqcNavFile BRDC2070.12P --key reqcOutLogFile CUT0.txt --key --key startTab 4 --key autoStart 2
     1623<pre>
     1624   /home/user/bnc --conf /dev/null --key reqcAction Analyze --key reqcObsFile CUT02070.12O --key reqcNavFile BRDC2070.12P --key reqcOutLogFile CUT0.txt --key reqcPlotDir /home/user --nw
     1625</pre>
     1626</p>
     1627<p>The following Linux command line produces the same RINEX QC plots in interactive autoStart mode:
     1628</p>
     1629<pre>
     1630   /home/user/bnc --conf /dev/null --key reqcAction Analyze --key reqcObsFile CUT02070.12O --key reqcNavFile BRDC2070.12P --key reqcOutLogFile CUT0.txt --key --key startTab 4 --key autoStart 2
     1631</pre>
    16311632</p>
    16321633
     
    22842285</p>
    22852286<pre>
    2286 Windows:       COM1, COM2
    2287 Linux:         /dev/ttyS0, /dev/ttyS1
    2288 FreeBSD:       /dev/ttyd0, /dev/ttyd1
    2289 Digital Unix:  /dev/tty01, /dev/tty02
    2290 HP-UX:         /dev/tty1p0, /dev/tty2p0
    2291 SGI/IRIX:      /dev/ttyf1, /dev/ttyf2
    2292 SunOS/Solaris: /dev/ttya, /dev/ttyb
     2287   Windows:       COM1, COM2
     2288   Linux:         /dev/ttyS0, /dev/ttyS1
     2289   FreeBSD:       /dev/ttyd0, /dev/ttyd1
     2290   Digital Unix:  /dev/tty01, /dev/tty02
     2291   HP-UX:         /dev/tty1p0, /dev/tty2p0
     2292   SGI/IRIX:      /dev/ttyf1, /dev/ttyf2
     2293   SunOS/Solaris: /dev/ttya, /dev/ttyb
    22932294</pre>
    22942295<p>
     
    23962397Examples for command line parameter strings passed on to the advisory 'Script' are:
    23972398<pre>
    2398 FFMJ0 Begin_Outage 08-02-21 09:25:59
    2399 FFMJ0 End_Outage 08-02-21 11:36:02 Begin was 08-02-21 09:25:59
     2399   FFMJ0 Begin_Outage 08-02-21 09:25:59
     2400   FFMJ0 End_Outage 08-02-21 11:36:02 Begin was 08-02-21 09:25:59
    24002401</pre>
    24012402</p>
     
    24042405</p>
    24052406<pre>
    2406 #!/bin/bash
    2407 sleep $((60*RANDOM/32767))
    2408 cat &gt; mail.txt &lt;&lt;EOF
    2409 Advisory Note to BNC User,
    2410 Please note the following advisory received from BNC.
    2411 Stream: $*
    2412 Regards, BNC
    2413 EOF
    2414 mail -s &quot;NABU: $1&quot; email@address &lt; mail.txt
     2407   #!/bin/bash
     2408   sleep $((60*RANDOM/32767))
     2409   cat &gt; mail.txt &lt;&lt;EOF
     2410   Advisory Note to BNC User,
     2411   Please note the following advisory received from BNC.
     2412   Stream: $*
     2413   Regards, BNC
     2414   EOF
     2415   mail -s &quot;NABU: $1&quot; email@address &lt; mail.txt
    24152416</pre>
    24162417</p>
     
    25772578<p>
    25782579<u>Debugging</u><br>
    2579 Note that for debugging purposes BNC's real-time PPP functionality can also be used offline. Apply the 'File Mode' 'Command Line' option for that to read a file containing synchronized observations, orbit and clock correctors, and Broadcast Ephemeris. Example:<br><br>
    2580 bnc.exe --conf c:\temp\PPP.bnc --file c:\temp\RAW<br><br>
     2580Note that for debugging purposes BNC's real-time PPP functionality can also be used offline. Apply the 'File Mode' 'Command Line' option for that to read a file containing synchronized observations, orbit and clock correctors, and Broadcast Ephemeris. Example:
     2581<pre>
     2582   bnc.exe --conf c:\temp\PPP.bnc --file c:\temp\RAW
     2583</pre>
    25812584Such a file (here: 'RAW') must be saved beforehand using BNC's 'Raw output file' option.
    25822585</li>
     
    27282731
    27292732<pre>
    2730 /Users/pppDir/PPP_${STATION}_${DATE}.log
     2733   /Users/pppDir/PPP_${STATION}_${DATE}.log
    27312734</pre>
    27322735
     
    28072810
    28082811<pre>
    2809 /Users/pppDir/PPP_${STATION}_${DATE}.nmea
     2812   /Users/pppDir/PPP_${STATION}_${DATE}.nmea
    28102813</pre>
    28112814<p>
     
    28522855BNC estimates the tropospheric delay according to equation
    28532856<pre>
    2854 T(z) = T_apr(z) + dT / cos(z)
     2857   T(z) = T_apr(z) + dT / cos(z)
    28552858</pre>
    28562859where T_apr is the a priori tropospheric delay derived from Saastamoinen model.
     
    28602863You can specify the full path to daily SINEX Troposphere files to save troposphere parameters on disk, see <u>https://igscb.jpl.nasa.gov/igscb/data/format/sinex_tropo.txt</u> for a documentation of the file format. Example:
    28612864<pre>
    2862 /Users/pppDir/PPP_${STATION}${DOY}_${YY}.zpd
     2865   /Users/pppDir/PPP_${STATION}${DOY}_${YY}.zpd
    28632866</pre>
    28642867In this '${STATION}' stands for the observation's mountpoint or RINEX file, '${DOY}' for the Day Of Year, and '${YY}' for the year. For a RINEX observations file 'CUT0' it would lead to a troposphere file named 'PPP_CUT01810.15.zpd' with the following contents (example):
     
    31023105<p><u>Figure 25:</u> BNC in 'Quick-Start' mode (PPP, Panel 2)</p>
    31033106
    3104 <p><a name="pppaverage"><h4>2.13.3.NN Averaging - optional if XYZ is set</h4></p>
    3105 <p><a name="pppgap"><h4>2.13.3.NN Maximal Solution Gap - optional if Quick-Start is set</h4></p>
    3106 
    31073107<p><a name="pppPlots"><h4>2.13.4 PPP (4): Plots</h4></p>
    31083108<p>
     
    34253425</p>
    34263426<pre>
    3427 dC = (s - 1) / s * &rho; / c
     3427   dC = (s - 1) / s * &rho; / c
    34283428</pre>
    34293429<p>
     
    36123612</p>
    36133613<p>
    3614 Specify 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 filename.
     3614Specify 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:
     3615<pre>
     3616   /home/user/BNC${GPSWD}.clk
     3617</pre>
     3618Note that '${GPSWD}' produces the GPS Week and Day number in the filename.
    36153619</p>
    36163620<p>
     
    39863990<p><a name="cmd"><h4>2.20. Command Line Options</h4></p>
    39873991<p>
    3988 Command line options are available to run BNC in 'no window' mode or let it read previously recorded input offline from one or several files for debugging purposes. The self-explaining contents of the configuration file can easily be edited. It is possible to introduce a specific configuration filename instead of using the default name 'BNC.bnc'.
    3989 </p>
    3990 <p>
    3991 In addition to reading processing options from the involved configuration file, BNC can optionally read all configuration options from command line. Running BNC with command line option 'help'
     3992Command line options are available to run BNC in 'no window' mode or let it read previously recorded input offline from one or several files for debugging purposes. It is also possible to introduce a specific configuration filename instead of using the default filename 'BNC.bnc'. The self-explaining contents of the configuration file can easily be edited.
     3993</p>
     3994<p>
     3995In addition to reading processing options from the involved configuration file, BNC can optionally read any configuration option from command line. Running BNC with command line option 'help'
    39923996</p>
    39933997<p>
    39943998Example:<br><br>
    3995 bnc.exe --help
     3999&nbsp; &nbsp; &nbsp; bnc.exe --help
    39964000</p>
    39974001<p>
     
    39994003</p>
    40004004
    4001 <p><a name="nw"><h4>2.20.1 No Window Mode - optional</h4></p>
     4005<p><a name="cmdVersion"><h4>2.20.1 Version - optional</h4></p>
     4006<p>
     4007Command line option '--version' lets BNC print its version number.
     4008</p>
     4009<p>
     4010Example:<br><br>
     4011&nbsp; &nbsp; &nbsp; bnc.exe --version
     4012</p>
     4013
     4014<p><a name="cmdDisplay"><h4>2.20.2 Display - optional</h4></p>
     4015<p>
     4016On systems which support graphics command line option '--display' forces BNC to present the BNC window on the specified display.
     4017</p>
     4018<p>
     4019Example:<br><br>
     4020&nbsp; &nbsp; &nbsp; bnc.exe --display localhost:10.0
     4021</p>
     4022
     4023<p><a name="nw"><h4>2.20.3 No Window Mode - optional</h4></p>
    40024024<p>
    40034025Apart from its regular windows mode, BNC can be started on all systems as a 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.
     
    40054027<p>
    40064028Example:<br><br>
    4007 bnc.exe --nw
     4029&nbsp; &nbsp; &nbsp; bnc.exe --nw
    40084030</p>
    40094031<p>
     
    40174039</p>
    40184040<pre>
    4019 #!/bin/bash
    4020 
    4021 # Save string localhost
    4022 echo "localhost" > /home/user/hosts
    4023 
    4024 # Start virtual X-Server, save process ID
    4025 /usr/bin/Xvfb :29 -auth /home/user/hosts -screen 0 1280x1024x8 &
    4026 psID=`echo $!`
    4027 
    4028 # Run BNC application with defined display variable
    4029 /home/user/BNC/bnc --conf /dev/null --key reqcAction Analyze --key reqcObsFile ons12090.12o --key reqcNavFile brdc2090.12p --key reqcOutLogFile multi.txt --key reqcPlotDir /home/user --display localhost:29 --nw
    4030 
    4031 # BNC done, kill X-server process
    4032 kill $psID
    4033 </pre>
    4034 
    4035 <p><a name="post"><h4>2.20.2 File Mode - optional</h4></p>
     4041   #!/bin/bash
     4042
     4043   # Save string localhost
     4044   echo "localhost" > /home/user/hosts
     4045
     4046   # Start virtual X-Server, save process ID
     4047   /usr/bin/Xvfb :29 -auth /home/user/hosts -screen 0 1280x1024x8 &
     4048   psID=`echo $!`
     4049
     4050   # Run BNC application with defined display variable
     4051   /home/user/BNC/bnc --conf /dev/null --key reqcAction Analyze --key reqcObsFile ons12090.12o --key reqcNavFile brdc2090.12p --key reqcOutLogFile multi.txt --key reqcPlotDir /home/user --display localhost:29 --nw
     4052
     4053   # BNC done, kill X-server process
     4054   kill $psID
     4055</pre>
     4056
     4057<p><a name="post"><h4>2.20.4 File Mode - optional</h4></p>
    40364058<p>
    40374059Although 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
    40384060</p>
    40394061<p>
    4040 --file &lt;<u>inputFileName</u>&gt;
     4062&nbsp; &nbsp; &nbsp; --file &lt;<u>inputFileName</u>&gt;
    40414063</p>
    40424064
    40434065and specify the full path to an input file containing previously saved data. Example:<br><br>
    4044 ./bnc --file /home/user/raw.output_110301
     4066&nbsp; &nbsp; &nbsp; ./bnc --file /home/user/raw.output_110301
    40454067</p>
    40464068<p>
     
    40504072</p>
    40514073
    4052 <p><a name="conffile"><h4>2.20.3 Configuration File - optional</h4></p>
     4074<p><a name="conffile"><h4>2.20.5 Configuration File - optional</h4></p>
    40534075The default configuration filename is 'BNC.bnc'. 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 filename. If you introduce only a filename, the corresponding file will be saved in the current working directory from where BNC is started.
    40544076</p>
    40554077<p>
    40564078Example:<br><br>
    4057 ./bnc --conf MyConfig.bnc
     4079&nbsp; &nbsp; &nbsp; ./bnc --conf MyConfig.bnc
    40584080</p>
    40594081<p>
     
    40614083</p>
    40624084
    4063 <p><a name="confopt"><h4>2.20.4 Configuration Options - optional</h4></p>
     4085<p><a name="confopt"><h4>2.20.6 Configuration Options - optional</h4></p>
    40644086<p>
    40654087BNC 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
    40664088</p>
    40674089<p>
    4068 --key &lt;keyName&gt; &lt;keyValue&gt;
     4090&nbsp; &nbsp; &nbsp; --key &lt;keyName&gt; &lt;keyValue&gt;
    40694091</p>
    40704092<p>
     
    40724094</p>
    40734095<p>
    4074 bnc --nw --conf &lt;confFileName&gt --key &lt;keyName1&gt; &lt;keyValue1&gt; --key &lt;keyName2&gt; &lt;keyValue2&gt; ...
    4075 </p>
    4076 <p>
    4077 Example:
    4078 </p>
    4079 <p>
    4080 ./bnc --conf CONFIG.bnc --key proxyPort 8001 --key rnxIntr "1 day"
     4096&nbsp; &nbsp; &nbsp; bnc --nw --conf &lt;confFileName&gt --key &lt;keyName1&gt; &lt;keyValue1&gt; --key &lt;keyName2&gt; &lt;keyValue2&gt; ...
     4097</p>
     4098<p>
     4099Configuration options which are part of the configuration files PPP section must be prefixed by 'PPP/'. As an example, option 'minObs' from the PPP section of the BNC configuration file would be specified as 'PPP/minObs' on a command line.
     4100</p>
     4101<p>
     4102Values for configuration options can be introduced via command line exactly as they show up in the configuration file. However, any value containing one or more blank characters must be enclosed by quotation marks when specified on the command line.
     4103</p>
     4104<p>
     4105Example command lines:
     4106</p>
     4107<p>
     4108&nbsp; &nbsp; &nbsp; (1) &nbsp; /Applications/bnc.app/Contents/MacOS/bnc -- version<br>
     4109&nbsp; &nbsp; &nbsp; (2) &nbsp; ./bnc --conf CONFIG.bnc --key proxyPort 8001 --key rnxIntr "1 day"<br>
     4110&nbsp; &nbsp; &nbsp; (3) &nbsp; D:\BKG\bnc.exe --conf C:\Users\weber\Desktop\BNC.bnc --file C:\Users\weber\Desktop\rawfile<br>
     4111&nbsp; &nbsp; &nbsp; (4) &nbsp; /home/weber/bin/bnc --conf /home/weber/MyConfigFile.bnc<br>
     4112&nbsp; &nbsp; &nbsp; (5) &nbsp; bnc --conf /Users/weber/.config/BKG/BNC.bnc -nw<br>
     4113&nbsp; &nbsp; &nbsp; (6) &nbsp; bnc --conf /dev/null --key startTab 4 --key reqcAction Edit/Concatenate --key reqcObsFile AGAR.15O --key reqcOutObsFile AGAR_X.15O --key reqcRnxVersion 2 --key reqcSampling 30 --key reqcV2Priority CWPX_?<br>
     4114&nbsp; &nbsp; &nbsp; (7) &nbsp; bnc --key mountPoints "//user:pass@mgex.igs-ip.net:2101/CUT07 RTCM_3.0 ETH 9.03 38.74 no 2;//user:pass@www.igs-ip.net:2101/FFMJ1 RTCM_3.1 DEU 50.09 8.66 no 2"<br>
     4115&nbsp; &nbsp; &nbsp; (8) &nbsp; bnc --key cmbStreams "CLK11 BKG 1.0;CLK93 CNES 1.0"<br>
     4116&nbsp; &nbsp; &nbsp; (9) &nbsp; bnc --key PPP/staTable "FFMJ1,100.0,100.0,100.0,100.0,100.0,100.0,0.1,3e-6,7777;CUT07,100.0,100.0,100.0,100.0,100.0,100.0,0.1,3e-6,7778"<br>
    40814117</p>
    40824118
Note: See TracChangeset for help on using the changeset viewer.