← Назад
Mute PEP-клиент.
Designation
Soluble problems and method
The program is intended for zeroing (muting) of the file of traces along
the specified hodograph. The hodograph is read out from the database. With
regard to it the window formed by the left and right boundaries is set.
The values of the amplitudes of the samples within this window do not vary.
In addition to each boundary the interval with the smooth fading of amplitude
(according to the cosine law) is set. All samples of traces outside
the given window are unset.
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 viewing the protocol of program operation.
Description
Session
The setting of parameters and start of the program is 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 package VSP.
-
Setting of the project, the data directory of which contains the initial
modification (menu item File - > Project...).
-
Setting of the input and output modifications and selection of the table,
containing the times of the earliest entries.
-
Setting of the left and right borders of the window, values of intervals
of smooth fading, and range of cable depths, for all traces of which the
muting is applied.
-
Start of the program on execution (button Start in a toolbar or
menu item Mute - > Start).
-
To view the resulting modification it is necessary to press the button
View
for the name of output modification on the panel of results.
To view the protocol of execution of the program it is necessary
to press the button View log in the toolbar or to select the menu
item Mute - > View log.
-
For escaping the environment of packet execution program it is necessary
to press the button Exit in a toolbar or to select the menu File
- > Exit.
Parameters of processing
Input parameters (panel Parameters)
-
Name: Data modification for muting
Type: nmod_s
Description: Name of modification with traces submitted on the input
of the program.
-
Name: Resulting data modification
Type: nmod_e
Description: Name of output modification. The name should be preselected
in the form of Sxxx, where xxx - are the digits. In this modification all
actual entry traces will be written. The traces which fall into the specified
range of cable depths, will be unset along the hodograph.
-
Name: Time hodograph
Type: dbname_s (FBLIST)
Description: Data base table with a temporary hodograph, along which
the nulling will be created. The TFB field of the data base is set
as the time of hodograph.
-
Name: Switcher of left-side muting
Type: state
Description: Turning on muting to the left of the hodograph.
-
Name: Left boundary shift, ms
Type: float
Description: Left boundary of the safe samples area.
-
Name: Width of left-side fading slope, ms
Type: float
Description: Width of the fading slope from the left boundary to the
left.
-
Name: Apply to depths: (start end)
Type: float2
Description: Cable depths of traces to which the muting to the left
of hodograph will be applied. The second value of depth should be less
than or equal to the first value.
-
Name: Switcher of right-side muting
Type: state
Description: Turning on muting to the right of the hodograph.
-
Name: Right boundary shift, ms
Type: float
Description: The right boundary of the safe samples area.
-
Name: Width of right-side fading slope, ms
Type: float
Description: Width of the fading slope from the right boundary to the
right.
-
Name: Apply to depths: (start end)
Type: float2
Description: Cable depths of traces, to which the muting to the right
of hodograph will be applied. The second value of depth should be less
than or equal to the first value.
Information of a runtime of the
program (panel Runtime)
-
-
Name: Current cable depth
The type: float
The description: Current cable depth of the processed trace.
Parameters of results (panel Results)
-
-
Name: Resulting data modification
The type: nmod_s
The description: Name of output modification
-
Name: Count of all input traces
The type: int
The description: Total number of the input traces.
-
Name: Count of written traces
The type: int
The description: Number of traces written to the output modification.
User interface
For detailed acquaintance with the user interface of the shell of the package
execution program, see the description of the program
pktexec.
An example of the window of the shell with active panel for input of parameters
is given below:
Input data
Traces
All traces of the given modification are moved to the input of the program.
Only actual traces (ACT!=0) are taken for the processing. The procedure of a nulling with smooth
fading is applied to the traces which have got in range of the left-side and/or the right-side muting. The actual traces which have not got in any range of cable depths, are anyway recorded in the initial order to the output modification. The output modification can not coincide
with the input modification.
Data base tables
The hodograph is read from the table of the FBINFO type. Thus the time
of a hodograph is taken from the TFB field. The comparison of the point
of hodograph and trace is executed on coincidence of the HCAB and NMGL
fields corresponding to the 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 down to the resulting file with the name of output modification.
Requirements to the environment
Operational environment
The program gets the name of the operating project through the variable
of environment PROJECT. If the program is started from under the shell,
this condition is fulfilled by selection of the operating project.
The program determines the location of the system files of the package
from a variable VSPHOME, defined in the user`s profile or in the file setup
in a home directory of the user of the package. In the file setup
the given variable can appear also under the name of VSP.
Used files
The program searches for the definition of parameters in the files $VSPHOME/etc/Mute.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, jobss and protocols of
execution of the projects and also paths to the system files of theVSP
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 to
the file of the protocol of the transmission of the job LOG/$PROJECT/Mute-#.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.
