Interaction with other programs

The program is PEP-client. Thus it is started from under the shell of the packet execution program pktexec, which gives tools for setting the parameters, control of execution of the program and monitoring the protocol of program operation.

DESCRIPTION

Session

Setting of parameters and start of the program are performed from under the shell of the packet execution program pktexec. The standard session consists of the following steps:

1. Start of the program from the menu of the VSP package.
2. Setting of the project, the data directory of which contains the initial modification (menu item File - > Project...).
3. Setting of the initial and output modifications and selection of the table, containing the times of first breaks.
4. Selection of the mode of weighting: decreasing of amplitudes or their restoring
5. Setting of the value of shift of the start point with respect to the hodograph
6. Setting of the value of decreasing of amplitudes. The parameter defines in how many times the amplitude of the input signal will be decreased during one second.
7. Start of execution of the program (button Start in the toolbar or menu item ExpWeight - > Start).
8. In order to view the resulting modification it is necessary to press the button View near the name of the output modification on the panel of results.

   In order to view the protocol of the program execution it is necessary to press the button View log on the toolbar or to select the menu item ExpWeight - > View log.

9. In order to exit from the packet execution environment it is necessary to press the button Exit on the toolbar or to select the menu item File - > Exit.

Parameters of processing

Input parameters (panel Parameters)

Name: Data modification for transforming
Type: nmod_s
Description: the name of modification with traces at the input of the program.

Name: Resulting data modification
Type: nmod_e
Description: name of the output modification. The name should be given in a form of Sxxx, where xxx - the digits. All actual input traces will be written in this modification.

Name: Hodograph
Type: dbname_s (FBLIST)
Description: the data base table with a temporary hodograph, along which the weighting will be performed. The field TFB of the data base table is considered the time of hodograph.

Name: Inverse weighting
Type: state
Description: switching of the mode of restoring of the amplitudes.

Name: Shift of starting point from hodograph, ms
Type: float
Description: shift of a starting point with respect to the hodograph. When the shift is negative the point is located to the left of the hodograph

---

Information on operating time of the program (panel Runtime)

Name: Current cable depth
Type: float
Description: current cable depth of the processed trace

---

Parameters of results (panel Results)

Name: Resulting data modification
Type: nmod_s
Description: name of the output modification

Name: Count of all input traces
Type: int
Description: total number of traces, sent to the input.

Name: Count of written traces
Type: int
Description: number of traces written to the output modification.

---

User interface

For detailed acquaintance with user interface of the packet execution program, see the description of the program pktexec.

---

Input data

Traces

All traces of the specified modification are moved to the input of the program. Only actual traces are accepted for processing (ACT! =0). The traces which have got in a range of the left-side and/or of the right-side muting, are processed by the procedure of muting with smooth fading. The actual traces which have not got in any range of cable depths, are in any case written in the initial order to the output modification. The output modification can not coincide with the input modification.

4.2. Data base tables

The hodograph is read from the table of the type FBINFO. The time of hodograph is taken from a field TFB. The point of hodograph and the trace are compared according to the coincidence of fields HCAB and NMGL to the appropriate fields of header of the body of the examined trace.

---

Output data

Traces

All actual traces with the values of samples changed according to the job are written in the resulting file with a name of the output modification.

---

Requirements to the environment

Operational environment

The program gets a name of the operative project through a variable of the environment PROJECT. In case of start of the program from under the shell, this condition is fulfilled by selection of the operative project.

The program defines the location of system files of the package from a variable VSPHOME, defined in the profile of the user or in the file setup in the home directory of the user of the package. In the file setup the given variable can appear also under a name of VSP.

---

Used files

The program searches for the description of parameters in files $VSPHOME/etc/ExpWeight.pep and $VSPHOME/etc/vsp.pep.

The user`s home directory should contain a setup file. This file should contain paths to the directories of data, jobs and protocols of execution of the projects and also paths to the system files of the VSP package.

---

Other requirements

Other requirements are defined by the shell of the packet execution program pktexec.

---

Messages to the user

Bringing messages to the notice of the user

All messages are moved to the standard stream of errors. If the program is started from under the interactive shell, the messages are saved in the file of the protocol of execution of the job LOG/$PROJECT/ExpWeight-#.log. The messages of classes EL_FATAL and EL_ERROR are placed in the area of messages of the interactive shell after the program termination.