Bernese GPS Software Version 5.0 - Bernese GNSS Software

19. Bernese Processing Engine (BPE)
The slave script on its turn gets the name of one selection file. It may then put the list
of files in that file as file selection list into the program panel using a command like (see
Section 19.6.5.1)
09: $bpe->putKey("$$bpe{U}/PAN/GPSEST.INP","PSFILES",
10: "SELECTED","REPLACE",$$bpe{PARAM1});
In order to pass BPE parameters to the slave script their values may be added to
CONTROL FILE as a blank-delimited list by replacing line 15 in the master script example
above by, e.g.,
15: print TMP "$file $$bpe{PARAM2} $$bpe{PARAM3}\n";
In the slave script the values of the parameters is then accessible through the variables
$$bpe{PARAM2} and $$bpe{PARAM3} (while $$bpe{PARAM1} contains the name of the baseline).
The Bernese GPS Software provides utilities allowing file-wise or cluster-wise parallelization
in an easy way. See Section 19.6.5.2 for details or check the example user scripts delivered
with the software in the directory ${X}/USERSCPT and copied during the installation to the
user’s environment of ${U}/SCRIPT.
19.6.5 Useful Utilities for User Scripts
The example in Section 19.6.3 shows how the methods defined in ${BPE}/RUNBPE.pm can
be used in user scripts that inherit the RUNBPE behavior. The general syntax is
$bpe->functionName(list_of_arguments);
In addition useful functions can be found in the Perl module ${BPE}/bpe util.pm. Several
of them are just shortcuts that simplify the usage of methods.
19.6.5.1 Accessing Variables and Program Panels
In Section 19.6.3 one particularly useful method – RUNBPE::getKeys – has been introduced.
This method can be used to read a list of keyword values from menu input files
(${U}/PAN/MENU VAR.INP, ${U}/PAN/MENU EXT.INP, etc.) and may, e.g., be used to get
menu time variables or path and extensions of specific file types. It takes one or more keyword
names as its arguments and returns an array of all relevant keyword values. The special
feature of this method is that all menu variables (see Section 18.5) are correctly expanded.
I.e., variables that depend on the currently processed campaign or session are correctly set.
E.g., after the call
my ($sess,$sess30) = $bpe->getKeys(’$S+0’,’$S-(30)’);
Page 402 AIUB