08.06.2013 Views

Bernese GPS Software Version 5.0 - Bernese GNSS Software

Bernese GPS Software Version 5.0 - Bernese GNSS Software

Bernese GPS Software Version 5.0 - Bernese GNSS Software

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

19. <strong>Bernese</strong> Processing Engine (BPE)<br />

Warning messages of the <strong>Bernese</strong> programs are merged into the protocol file if they are<br />

executed in the BPE user script. They may be extracted into an additional file using the<br />

method getWarn of the ${BPE}/bpe util.pm module:<br />

Usage: getWarn($bpe,$sumFil)<br />

Parameters: $bpe BPE object<br />

$sumFil file in which the warnings should be collected.<br />

Messages are appended to this file.<br />

As example, to collect all warning messages from reading the RINEX observation<br />

files in a number of parallel running RXOBV3 scripts you may add a command like<br />

“getWarn{$bpe,"${dirOut}RNX${yyssss}.ERR");” to the user script.<br />

To concatenate summary, output, or result files from the processing of a BPE into a file<br />

summarizing the BPE run a method appFile is available in the module${BPE}/bpe util.pm:<br />

Usage: appFile($title,$blank,$source,$target,$stop)<br />

Parameters: $title title line (blank: no title printed)<br />

$blank number of blank lines to append<br />

$source file which should be appended<br />

$target file to which the source file should be appended<br />

$stop = 0: script stops if the source file is missing<br />

19.6.5.5 Define User Variables<br />

You may add any user-defined variable or modify the actual value of the client variables<br />

and user-defined server variables within an user script. The variable names and the values<br />

have to be prepended to the keyword USERVAR in the ${U}/PAN/MENU VAR.INP (remember<br />

that ${U} points to the temporary BPE user environment). The method setUserVar in the<br />

${BPE}/bpe util.pm module performs this task in a very comfortable way:<br />

Usage: setUserVar($bpe,%vars)<br />

Parameters: $bpe BPE object<br />

%vars hash array containing the variables as keys with corresponding<br />

values<br />

Example: setUserVar($bpe,”CD4”,”$param1”,”pgm”,”<strong>GPS</strong>EST”)<br />

defines user variables $CD4 with the content of $param1 and<br />

$pgm with the value <strong>GPS</strong>EST<br />

A special case is the update of the ranges of session variables (see option “RANGES OF<br />

PREDEFINED VARIABLES” in panel “Variables Available in the Menu for Interactive and Automatic<br />

Processing 2”. The module ${BPE}/bpe util.pm contains a corresponding method:<br />

Usage: setPlusMinus($bpe,$plus,$minus)<br />

Parameters: $bpe BPE object<br />

$plus new value of plus-range in MENU VAR.INP<br />

$minus new value of minus-range in MENU VAR.INP<br />

Note that the range variables are changed in the file MENU VAR.INP of the script’s option<br />

directory. The variables $$bpe{V PLUS} and $$bpe{V PLUS} remain unchanged.<br />

Page 406 AIUB

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!