Insert and delete zero samples.

Добавление и удаление нулевых отсчетов.

Insert and delete zero samples.

indzero PEP-клиент.

Soluble problems and method

The program is intended for changing of the length of the trace by addition/deleting of zero samples at the beginning and/or at the end of the trace.

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:

Start of the program from the menu of the VSP package.
Setting of the project, the data directory of which contains the initial modification (menu item File - > Project...).
Setting of the initial and output modifications
Selection of the mode of operation of the program (insertion or deleting of zero samples).
Setting of lengths of the zero areas at the beginning and at the end of traces.
Start of the execution of the program (button Start in the toolbar or menu item indzero - > Start).
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 indzero - > View log.
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 input
Type: nmod_s
Description: 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 the form of Sxxx, where xxx are the digits. All actual input traces will be written in this modification, and the traces which belong to the specified range of cable depths, will be muted along the hodograph.

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

Name: Insert/Delete
Type: enum
Description: selection of the mode of operation of the program.

Name: Left samples
Type: int
Description: number of zero samples at the beginning of a trace

Name: Right samples, ms
Type: int
Description: number of zero samples at the end of a trace

Information on the 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, moved to the input.; Name: Count of written traces
Type: int
Description: number of traces written in 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 output modification can not coincide with the input modification.

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/indzero.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/indzero-#.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.

Добавление и удаление нулевых отсчетов.