Parameter lists in detail:

2DPATH

Great-arc parameters.

Finds midpoint, offsets, and azimuths in the current geometry (Plane, spherical, etc.)

Usage: 2DPATH XMID YMID DIST AZIM FORMAT X1 Y1 X2 Y2
9 parameters in this list:

XMID

 Name of header entry to write X-coordinate of the midpoint into
  • Format: Character (8 characters)
  • Default value: Not specified

YMID

 Name of header entry to write Y-coordinate of the midpoint into
  • Format: Character (8 characters)
  • Default value: Not specified

DIST

 Name of header entry for the distance between (X1, Y1) and (X2,Y2)
  • Format: Character (8 characters)
  • Default value: Not specified

AZIM

 Name of header entry for the azimuth from (X1, Y1) to (X2,Y2), in degrees. The azimuth is in the range [-180, 180), equals 0 in the upward (North) direction and inreases counter-clockwise.
  • Format: Character (8 characters)
  • Default value: Not specified

FORMAT

 Format of the XM and YM entries: FLOAT or INTEGER
  • Format: Numeric Header entry format: float, double, integer, or long
  • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
  • Default value: Not specified

X1

 X-coordinate of the first point
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 0

Y1

 Y-coordinate of the first point
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 0

X2

 X-coordinate of the second point
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 0

Y2

 Y-coordinate of the second point
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 0

ASKUSER

Ask for user input.

Requests a value from the user. At present, limited to numeric values only.

Usage: ASKUSER RESULT FORMAT REQUEST
3 parameters in this list:

RESULT

 Name of the trace header (table record) entry to write result into
  • Format: Character (8 characters)
  • Default value: Not specified

FORMAT

 Format of the header entry
  • Format: Header entry format: float, double, integer, long, or char
  • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
  • Default value: real

REQUEST

 Prompt message printed in the current log file before the value id read in. The request is preceeded by the name of the header field that is overwritten, and its original value in parantheses
  • Format: Character (56 characters)
  • Default value: No message

Preceding list (2DPATH)

BINHFMT

Binary header format

This list specifies additional options for SEGY-like files. These options may override some specifications of the format.

Usage: BINHFMT SAMFORM SAMPNUM SAMPINT SAMPVAR AUTOSWP
5 parameters in this list:

SAMFORM

 Data sample format override
  • Format: Selection
  • Selectable Values: (codes in parentheses)
    • By SEGY convention (DEF)
    • By CSEGY convention (DEF)
    • Autodetect (not imlemented) (AUTO)
    • Autodetect 4-byte (not imlemented) (AUTO4)
    • Autodetect 2-byte (not imlemented) (AUTO2)
    • IBM 4-byte real (IBM4)
    • IEEE 4-byte float (IEEE4)
    • IEEE 2-byte real (IEEE2)
    • Integer 2-byte (little endian) (INT2-LE)
    • Integer 2-byte (big endian) (INT2-BE)
    • Integer 4-byte (little endian) (INT4-LE)
    • Integer 4-byte (big endian) (INT4-BE)
    • Integer 1-byte (INT1)
  • Default value: DEF

SAMPNUM

 Number of samples per trace (<=0 means determined from the header
  • Format: INTEGER
  • Default value: 0

SAMPINT

 Sample interval override (<=0.0 means determined from the header
  • Format: FLOAT
  • Default value: 0

SAMPVAR

 Flag indicating whether trace sample interval and number of samples are read in from each trace
  • Format: TOGGLE
  • Min value: yes:YES|no:NO
  • Default value: YES

AUTOSWP

 Flag for automatically selecting the data byte order by testing the statistics of the first trace
  • Format: TOGGLE
  • Min value: yes:YES|no:NO
  • Default value: YES

Preceding list (ASKUSER)

BNDRY

Reflectivity

Calculates reflection, transmission, and conversion coefficients using a matrix equivalent of Zoeppritz equations

Usage: BNDRY PAMPL SAMPL INCDWV OUTPUT RAYPAR VP1 VS1 RHO1 VP2 VS2 RHO2
11 parameters in this list:

PAMPL

 Name of a header entry to output the amplitude of the reflected (transmitted) P wave
  • Format: Character (8 characters)
  • Default value: Not specified

SAMPL

 Name of a header entry to output the amplitude of the reflected (transmitted) S wave
  • Format: Character (8 characters)
  • Default value: Not specified

INCDWV

 Type of the incident wave
  • Format: Selection
  • Selectable Values: (codes in parentheses)
    • P wave (P)
    • S wave (S)
  • Default value: P

OUTPUT

 Type of output. The "I-" modes correspond to "incoherent" refelction or transmission on a layer of (VP2,VS2,RHO2). This amplitude is obtained by taking sqrt() of the sum of squares of the coresponding amplitudes on the upper and lower boundaries of the layer.
  • Format: Selection
  • Selectable Values: (codes in parentheses)
    • Reflected (REFL)
    • Transmitted (TRANS)
    • I-Reflected (IREFL)
    • I-Transmitted
  • Default value: REFL

RAYPAR

 Ray parameter of the incident wave
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 0

VP1

 Vp in the medium of the incident wave
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 1

VS1

 Vs in the medium of the incident wave
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 1

RHO1

 Density in the medium of the incident wave
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 1

VP2

 Vp in the medium on the other side of the boundary from the incident wave
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 1

VS2

 Vs in the medium on the other side of the boundary from the incident wave
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 1

RHO2

 Density in the medium on the other side of the boundary from the incident wave
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 1

Preceding list (BINHFMT)

BOFFSET

Byte offset

Creates an optional header containing byte offset of the beginning of data record in the file

Usage: BOFFSET BOFFSET
1 parameter in this list:

BOFFSET

 Name of the byte offset header
  • Format: Character (8 characters)
  • Default value: boffset

Preceding list (BNDRY)

BOFFSET

Byte offset

Creates a trace header containing the address of each trace in the dataset. This option should only be used with single-file datasets.

Usage: BOFFSET BOFFSET
1 parameter in this list:

BOFFSET

 Name of the byte offset trace header created.
  • Format: Character (8 characters)
  • Default value: Not specified

Preceding list (BOFFSET)

CLOOKUP

Conditional LOOKUP.

Works in the same way as LOOKUP, but a condition for the calculation may be specified.

Usage: CLOOKUP CONDCHK MIN MAX RESULT FORMAT LOOKUP TABLE
7 parameters in this list:

CONDCHK

 Name of key header entry. Its value will be compared with MIN and MAX values below. If the value lies within [MIN..MAX] range, the opertaion will be performed
  • Format: Character (8 characters)
  • Default value: Not specified

MIN

 Min value of CONDCHK
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: Not specified

MAX

 Max value of CONDCHK
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: Not specified

RESULT

 Name of the entry in current table or trace headers which is created or modified
  • Format: Character (8 characters)
  • Default value: Not specified

FORMAT

 Format of TARGET
  • Format: Numeric Header entry format: float, double, integer, or long
  • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
  • Default value: real

LOOKUP

 Name of the entry in the source table whose value will be assigned to RESULT. This entry must be defined during Edit phase.
  • Format: Character (8 characters)
  • Default value: Not specified

TABLE

 Name of the table used for the interpolation. If this field is left blank, we try to find an "associated" table. The association is established through ASSOC list in module DEFINE. If such association call is found, an attempt is made to replace the corresponding token in the name of the table on which LOOKUP is currently working, and to replace this token with the substitution string.
  • Format: Character (40 characters)
  • Default value: Associated table

5 groups of 2 REPEAT parameters per line:

SOURCE

 Name of the argument of the TABLE
  • Format: Character (8 characters)
  • Default value: Not specified

VALUE

 Value of the SOURCE entry. This value must be a constant or be found in the trace header or in current table
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: Not specified

Preceding list (BOFFSET)

CONDSET

Conditional SET

Same as SET, but a condition for calculation may be specified.

Usage: CONDSET CONDCHK MIN MAX RESULT FORMAT ADD WEIGHT FUNCTN PARAM
9 parameters in this list:

CONDCHK

 Name of key header entry. Its value is be compared with MIN and MAX values below. If the value is within [MIN..MAX], the opertaion is performed
  • Format: Character (8 characters)
  • Default value: Not specified

MIN

 Min value of CONDCHK
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: Not specified

MAX

 Max value of CONDCHK
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: Not specified

RESULT

 Name of header entry to write result into
  • Format: Character (8 characters)
  • Default value: Not specified

FORMAT

 Format of the header entry: FLOAT or INTEGER
  • Format: Numeric Header entry format: float, double, integer, or long
  • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
  • Default value: int

ADD

 Constant term to add (default 0)
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 0.0

WEIGHT

 Factor to multiply the resulting value after all other calculations (default 1)
  • Format: Trace Header (table entry), name, or numerical value (8 characters)
  • Default value: 1.0

FUNCTN

 Name of function to calculate:
  • ABS, absolute value
  • BRANCH - for the first trace or table entry, returns 1; increments the return value whenevar the subsequent values of X differ by more than PARAM;
  • COS, SIN, (trigonometric functions; radian measure of the argument),
  • RAND-G (random value normally distributed with variance=x)
  • LN, LG (natural and decimal logariphms),
  • EXP, EXP10, (powers of e and 10),
  • POWER (x**PARAM)
  • SIGN,
  • DELTA (Kroneker - for integer values of the argument),
  • SQR, SQRT, INV ( 1. / x )
  • MOD (float or integer residual of x(PARAM)),
  • DIV (floor(x/PARAM)),
  • CEIL, FLOOR, MANT (mantissa),
  • RAND-U (random value uniformly distributed within [0..x]),
  • RAND-G (random value normally distributed with variance=x)
    •  Also, some more specialized functions:
  • P:PP, P:PS - PP and PS reflection coefficients for a plane P-wave incident on the surface from below, as a function of its ray parameter times the subsurface P-wave velocity (S-wave velocity is taken to equal Vp / sqrt(3)
  • P:Z, P:R - vertical and radial displacements for a plane P-wave incident on the surface from below, as a function of its ray parameter times the subsurface P-wave velocity (S-wave velocity is taken to equal Vp / sqrt(3)
  • P:R/Z - a ratio of the radial and vertical-component displacements for a plane P-wave incident on the surface from below, as a function of its ray parameter times the subsurface P-wave velocity (S-wave velocity is taken to equal Vp / sqrt(3)
  • arc/deg - converts arc in degrees to linear arc length units (km, m, ft, depending on the currents units of length);
  • deg/arc - converts arc length in the current units (km, m, ft, etc.) to degrees ("delta");
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • None (NONE)
      • Abs(x) (ABS)
      • branch(x) (BRANCH)
      • cos(x) (COS)
      • sin(x) (SIN)
      • tan(x) (TAN)
      • arccos(x) (ACOS)
      • arcsin(x) (ASIN)
      • arctan(x) (ATAN)
      • cos(x degrees) (COS_D)
      • sin(x degrees) (SIN_D)
      • tan(x degrees) (TAN_D)
      • ln(x) (LN)
      • log10(x) (LG)
      • exp(x) (EXP)
      • 10**x (EXP10)
      • x**PARAM (POWER)
      • sign(x) (SIGN)
      • delta(int x) (DELTA)
      • sqr(x) (SQR)
      • sqrt(x) (SQRT)
      • 1/x (INV)
      • mod(x) (MOD)
      • floor(x/PARAM) (DIV)
      • ceil(x) (CEIL)
      • floor(x) (FLOOR)
      • mantissa(x) (MANT)
      • random_uniform in [0..x] (RAND_U)
      • random_Gauss(variance=x) (RAND_G)
      • Degrees(arc length) (deg/arc)
      • Arc_length(degrees) (arc/deg)
      • P to Prefl (P>P)
      • P to Srefl (P>S)
      • P to Z amplitude (P>Z)
      • P to R amplitude (P>R)
      • P to R/Z ratio (P>R/Z)
      • P to R,Z inclination (P>R/Z)
      • S to Prefl (S>P)
      • S to Srefl (S>S)
      • S to Z amplitude (S>Z)
      • S to R amplitude (S>R)
      • S to R/Z ratio (S>R/Z)
      • S to R,Z inclination (S>R/Z)
    • Default value: NONE

    PARAM

    		 Second parameter of some functions (DIV, MOD, POWER), as explained in the descriptions of FUNCTN
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    2 groups of 4 REPEAT parameters per line:

    WEIGHT

    		 Weight of FUNCTION(ENTRY)
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    FUNCTN

    		 Name of function to calculate:
  • ABS, absolute value
  • BRANCH - for the first trace or table entry, returns 1; increments the return value whenevar the subsequent values of X differe by more than PARAM;
  • COS, SIN, (trigonometric functions; radian measure of the argument),
  • RAND-G (random value normally distributed with variance=x)
  • LN, LG (natural and decimal logariphms),
  • EXP, EXP10, (powers of e and 10),
  • POWER (x**PARAM)
  • SIGN,
  • DELTA (Kroneker - for integer values of the argument),
  • SQR, SQRT, INV ( 1. / x )
  • MOD (float or integer residual of x(PARAM)),
  • DIV (floor(x/PARAM)),
  • CEIL, FLOOR, MANT (mantissa),
  • RAND-U (random value uniformly distributed within [0..x]),
  • RAND-G (random value normally distributed with variance=x)
    •
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • None (NONE)
      • Abs(x) (ABS)
      • branch(x) (BRANCH)
      • cos(x) (COS)
      • sin(x) (SIN)
      • tan(x) (TAN)
      • arccos(x) (ACOS)
      • arcsin(x) (ASIN)
      • arctan(x) (ATAN)
      • cos(x degrees) (COS_D)
      • sin(x degrees) (SIN_D)
      • tan(x degrees) (TAN_D)
      • ln(x) (LN)
      • log10(x) (LG)
      • exp(x) (EXP)
      • 10**x (EXP10)
      • x**PARAM (POWER)
      • sign(x) (SIGN)
      • delta(int x) (DELTA)
      • sqr(x) (SQR)
      • sqrt(x) (SQRT)
      • 1/x (INV)
      • mod(x) (MOD)
      • floor(x/PARAM) (DIV)
      • ceil(x) (CEIL)
      • floor(x) (FLOOR)
      • mantissa(x) (MANT)
      • random_uniform in [0..x] (RAND_U)
      • random_Gauss(variance=x) (RAND_G)
      • Degrees(arc length) (deg/arc)
      • Arc_length(degrees) (arc/deg)
      • P to Prefl (P>P)
      • P to Srefl (P>S)
      • P to Z amplitude (P>Z)
      • P to R amplitude (P>R)
      • P to R/Z ratio (P>R/Z)
      • P to R,Z inclination (P>R/Z)
      • S to Prefl (S>P)
      • S to Srefl (S>S)
      • S to Z amplitude (S>Z)
      • S to R amplitude (S>R)
      • S to R/Z ratio (S>R/Z)
      • S to R,Z inclination (S>R/Z)
    • Default value: NONE

    FACTOR

    		 Factor to multiply before calculating FUNCTION (default 1)
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    ENTRY

    		 Name of header entry to add with WEIGHT to RESULT
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (CLOOKUP)

    CRACKV

    Effective medium

    Calculates effective Vp and Vs in a medium with isolated cracks (Hudson, Pointer, and Liu, 2001; eqs. (6), (10))

    Usage: CRACKV VP VSPAR VSPERP THEORY THETA VPM VSM RHOM KF RHOF CDENS CARATIO
    12 parameters in this list:

    VP

    		 Name of a header entry to output the resulting effective Vp velocity
    • Format: Character (8 characters)
    • Default value: Not specified

    VSPAR

    		 Name of a header entry to output resulting effective velocity of Vs polarized parallel to the cracks
    • Format: Character (8 characters)
    • Default value: Not specified

    VSPERP

    		 Name of a header entry to output resulting effective velocity of Vs polarized perpendicular to the cracks
    • Format: Character (8 characters)
    • Default value: Not specified

    THEORY

    		 Type of the solution (Hudson only for now)
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Hudson et al (HUDSON)
    • Default value: HUDSON

    THETA

    		 Angle of the incident wave relative to the axis of symmetry (that is, to the normal to crack plane)
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    VPM

    		 Vp in the rock matrix
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 6.5

    VSM

    		 Vs in the matrix
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 3.6

    RHOM

    		 Density of the rock matrix
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1

    KF

    		 Fluid compressibility
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 2.2

    RHOF

    		 Fluid density
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1.0

    CDENS

    		 Crack density
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0.001

    CARATIO

    		 Crack aspect ratio
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0.01

    Preceding list (CONDSET)

    DBLIST

    DB List

    Database List selector. Two keys are provided. If the primary and secondary keys match the database list, the condition is considered satisfied.

    Usage: DBLIST PKEY SKEY DBLIST
    3 parameters in this list:

    PKEY

    		 Primary key whose values are used for branching
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    SKEY

    		 Secondary key whose values are used for branching
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    DBLIST

    		 Name of the database list
    • Format: Character (24 characters)
    • Default value: Not specified

    Preceding list (CRACKV)

    DBSQL

    SQL database command

    Echnange data with an SQL database or dataset

    Usage: DBSQL DBASE
    1 parameter in this list:

    DBASE

    		 Database name, as defined in modules DBASE or DATASET. If DATASET name is given, the first SQL database in it is used. The database must be connected to.
    • Format: Character (24 characters)
    • Default value: Not specified

    1 group of 1 REPEAT parameter per line:

    QUERY

    		 Database query string. Strings specified in several Repeat groups are concatenated and sent to the database. Lines beginning with token ">>" are not included in the SQL string but interpreted as commands for processing the database outputs. These commands can be:
    • >> set trace_hdr format database_field - copies database_field into trace/table header of the specified format;
    Note that only the first line of database output is used to set header values.
    • Format: Character (88 characters)
    • Default value: Not specified

    Preceding list (DBLIST)

    DCODA

    Deconvolve coda

    Calculates ("deconvolves") overlapping coda amplitudes. The model assumes that a "total" event coda is measured on the background of a slower-decaying "background" coda (like Lg appearing on top of an S or P-wave coda). The function rerturns an estimate of the true event shape after the background is removed. The estimate is derived by Least-Squares regression in the (time,log(Amp)) domain.

    Usage: DCODA TSTART TEND LAMP SLAMP TIMET LAMPT SLAMPT TIMEB LAMPB SLAMPB
    10 parameters in this list:

    TSTART

    		 Time start of the analysis window
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    TEND

    		 Time end of the analysis window
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    LAMP

    		 Name of a floating-point header entry to output the resulting coda log(amplitude) into. The amplitude is output at time t=TIMET below.
    • Format: Character (8 characters)
    • Default value: Not specified

    SLAMP

    		 Name of a floating-point header entry to output the resulting -[log(amplitude)/dt] coda slope into.
    • Format: Character (8 characters)
    • Default value: Not specified

    TIMET

    		 Time at which the total log(amplitude) is given in LAMPT
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    LAMPT

    		 Log-amplitude of the total coda at t=TIMET
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    SLAMPT

    		 Slope (decay rate) of Log-amplitude of the total observed coda
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    TIMEB

    		 Time at which the vbackground observed log(amplitude) is given in LAMPB
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    LAMPB

    		 Log-amplitude of the background coda at t=TIMEB
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    SLAMPB

    		 Slope (decay rate) of Log-amplitude of the background coda
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    Preceding list (DBSQL)

    DEFHDR

    Defines a new header.

    The new header is initilized with value 0 for numerical, and zero-length string for CHARACTER types.

    Usage: DEFHDR RESULT FORMAT NUM
    3 parameters in this list:

    RESULT

    		 Name of header entry created
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header entry: FLOAT (REAL), INTEGER, DOUBLE, CHAR
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: int

    NUM

    		 Number of fields in the header
    • Format: INTEGER
    • Min value: 1
    • Default value: 1

    Preceding list (DCODA)

    DEFINED

    Defined

    This selector uses no trace headers and returns TRUE if a string is defined in the job by using tools DEFINE or PARAMS

    Usage: DEFINED NAME
    1 parameter in this list:

    NAME

    		 Name of defined variable. If the variable is defined by using either DEFINE or PARAMS, the condition returns TRUE
    • Format: Character (28 characters)
    • Default value: Not specified

    Preceding list (DEFHDR)

    ENSEMBL

    Ensemble loading

    If this list is included, LOAD will wait until a complete ensemble is accumulated before sending it to the output. This is useful, for example, when a complete file needs to be loaded before continuing with processing.

    Usage: ENSEMBL (No parameters)

    No REPEAT parameter groups in this list.


    Preceding list (DEFINED)

    EVAL

    Evaluate expression

    Expression in natural mathematical format including external functions and database operations (under development)

    Usage: EVAL EXPRESS
    1 parameter in this list:

    EXPRESS

    		 Expression in a free-format string. It can be continued in the following Repeat lines. The format of expressions is described in the introduction to module HDRMATH.
    • Format: Character (88 characters)
    • Default value: Not specified

    1 group of 1 REPEAT parameter per line:

    EXPRESS

    		 Continuation of the expression string.
    • Format: Character (88 characters)
    • Default value: Not specified

    Preceding list (ENSEMBL)

    FLEARTH

    Earth-flattening

    Performs correction of velocity and depth parameters from true values to the flat-Earth approximation, and back. The radius of the Earth should be set using SETGEOM.

    Usage: FLEARTH MODE DEPTH VEL
    3 parameters in this list:

    MODE

    		 Application mode:
  • FORW (or APPLY; forward transformation--from true to flattened-Earth values),
  • INVERSE (or INV, REMOVE; inverse transformation from flattened-Earth to true spherical-Earth values)
    •
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Apply (APPLY)
      • Remove (REMOVE)
    • Default value: FORW

    DEPTH

    		 Name of the DEPTH header entry to write result into
    • Format: Character (8 characters)
    • Default value: Not specified

    VEL

    		 Name of the VELOCITY header entry to write result into
    • Format: Character (8 characters)
    • Default value: Not specified

    Preceding list (EVAL)

    GETSTAT

    Get status

    Obtains varius status information from the system and puts it in trace/flow/table headers

    Usage: GETSTAT RESULT FORMAT TYPE PARAM
    4 parameters in this list:

    RESULT

    		 Name of header entry for which the status info is set
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the target header entry
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: char32

    TYPE

    		 Type of status query
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • File size (FILESIZE)
      • Directory size (DIRSIZE)
      • Disk usage|DISKUSAGE
    • Default value: Not specified

    PARAM

    		 Additional optional parameters of the status query (file, directory name, or disk mountpoint name)
    • Format: Character (49 characters)
    • Default value: Not specified

    Preceding list (FLEARTH)

    GROUP

    Group

    Group selector. Trace header or table entries are compared to the ranges. Several groups are allowed; traces are passed if they satisfy AT LEAST one of the group ranges.

    Usage: GROUP KEY MIN LENGTH PERIOD
    4 parameters in this list:

    KEY

    		 Header entry whose values are used for branching
    • Format: Character (8 characters)
    • Default value: Not specified

    MIN

    		 First value of KEY within the group.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    LENGTH

    		 Length of the group in terms of KEY values.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1

    PERIOD

    		 Group period (the range of KEY values by which the KEY is incremented between the groups).
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    3 groups of 3 REPEAT parameters per line:

    MIN

    		 First value of KEY in another group
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    LENGTH

    		 Length of the group in terms of KEY
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    PERIOD

    		 Group period
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (GETSTAT)

    HDRSTAT

    Header statistics.

    Using a list of other (and optionally, the same) tables, extracts various statistics (e.g., min, max, mean, and smoothers) of other header values

    Usage: HDRSTAT RESULT FORMAT MODE WINDOW WIDTH LOOKUP TABLE
    7 parameters in this list:

    RESULT

    		 Name of the entry in current table or trace headers which is created or modified
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of TARGET
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: float

    MODE

    		 Type of operation performed:
  • MIN, MAX - the minimum or maximum value, respectively;
  • MINABS, MAXABS - the minimum or maximum absolute value, respectively;
  • MEAN - the mean value.
  • RMS - the root mean square value.
  • MEANABS - the mean absolute value.
  • STDEV - the standard deviation from the mean.
    •
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Min() (MIN)
      • Max() (MAX)
      • Min((abs()) (MINABS)
      • Max(abs()) (MAXABS)
      • Mean() (MEAN)
      • Mean(abs()) (MEANABS)
      • Rms() (RMS)
      • Standard deviation() (STDEV)
      • LS smoother (LS)
      • Loest smoother (LOEST)
    • Default value: Not specified

    WINDOW

    		 Keyword specifying the way parameter WIDTH is interpreted. For smoothers, "Values" gives a Least Squares smoother, and "Number of points" results in a loest smoother
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Values (VALUES)
      • Number of points (NUMBER)
    • Default value: Not specified

    WIDTH

    		 Width of the window in which the statistics are calculated. The deviation of each table argument value is first normalized by its division by the corresponding metric below, and then compared to WIDTH in order to determine whether to include this point into smoother. Thus, for Least Squares smoothing, a good approach is to set WIDTH=1 and METRIC=width_in_the_corespponding_direction. For Loest, set WIDTH=number_of_points_in_the_smoother, and METRIC=relative_weights_for_the_different_arguments (1.0 for a single argument)
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1.0

    LOOKUP

    		 Name of the entry in the source table whose value are used to compute the statistics. This entry must be defined during the Edit phase.
    • Format: Character (8 characters)
    • Default value: Not specified

    TABLE

    		 Name of the table (or table name mask) from which the value is extracted. Special name "--this--" refers to the same table as being currently processed (using this option makes of course no sense when processing trace headers).
    • Format: Character (56 characters)
    • Default value: The same table

    1 group of 2 REPEAT parameters per line:

    These Repeat groups are used for the smoothers and specify the centers and widths of the smoothers in each of the directions of the table argument. The number of these parameters should correspond to the number of arguments in the table from which LOOKUP is performed.

    CENTER

    		 Central vaue of the corresponding argument. From the values of the argument, CENTER is first subtracted, and the result is divided by METRIC below and the resulting unitless argument is used to determine the WIDTH above and to perform the inversion.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    METRIC

    		 Metric of the corresponding argument, used to normalize the deviations of the argument from CENTER (as described in the explanation of parameter CENTER)
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (GROUP)

    HEADERS

    Headers

    Load headers corresponding to the specified file formats. This option is useful with database datasets or datasets derived from Matlab files, for which it is not known beforehand what files to expect

    Usage: HEADERS HEADERS
    1 parameter in this list:

    HEADERS

    		 Names of predefined formats separated by spaces. In the future, a database call may be used to produce such a list.
    • Format: Character (88 characters)
    • Default value: Not specified

    1 group of 6 REPEAT parameters per line:

    The repeat list allows defining arbitrary trace headers that may be needed when loading files

    NAME

    		 Name of header entry created
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header entry: FLOAT (REAL), INTEGER, DOUBLE, CHAR
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: int

    NUM

    		 Number of fields in the header
    • Format: INTEGER
    • Min value: 1
    • Default value: 1

    OPTSTR

    		 Optional string parameter used for some data sources. Currently, this parameter is used only when loading from Matlab/Octave .mat files. Currently, parameters OPTSTR, OPTNUM1, and OPTNUM2 are only used when loading headers from Matlab/Octave .mat files. If OPTSTR is set, it contains the name of the Matlab variable from which tthe header is loaded, otherwise the NAME of the header is used. Parameters OPTNUM1 and OPTNUM2 correspond to the selected row and column numbers from the Matlab matrix variable, defined as follows:
    • If the variable in .mat file is a scalar, its value is loaded into every trace derived from current .mat file.
      If either of the variavles OPTNUM1 and OPTNUM2 is defaulted, then for each consequtive trace derived from the same .mat file, this variable (or both) are incremented by NUM, starting from 1. When the variable reaches the maximum value (number of rows or columns in Matlab variable matrix), the sequence is restarted from 1
    • Format: Character (16 characters)
    • Default value: 0

    OPTNUM1

    		 Optional additional number used for some data sources.
    • Format: INTEGER
    • Default value: 0

    OPTNUM2

    		 Second optional additional parameter. Its use is explained in the description of OPTNUM1.
    • Format: INTEGER
    • Default value: 0

    Preceding list (HDRSTAT)

    HSCALAR

    Header scalar

    Associate a scalar (factor) with the header.

    Usage: HSCALAR TARGET PAR
    2 parameters in this list:

    TARGET

    		 Name of header entry for which the scalar is set
    • Format: Character (8 characters)
    • Default value: Not specified

    PAR

    		 Factor by which the value is scaled.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1

    Preceding list (HEADERS)

    HSHIFT

    Header shift

    Associate a shift (added term) with the header.

    Usage: HSHIFT TARGET PAR
    2 parameters in this list:

    TARGET

    		 Name of header entry for which the scalar is set
    • Format: Character (8 characters)
    • Default value: Not specified

    PAR

    		 Shift value.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    Preceding list (HSCALAR)

    INSERT

    Insert traces

    This list specifies the trace insertion mode. Insertion is triggered by the "anchor" traces whose headers satisfy condition KEY=KEYVAL

    Usage: INSERT MODE KEY KEYVAL
    3 parameters in this list:

    MODE

    		 Mode of data loading:
  • BEFORE (all data from the dataset are loaded before the data in the main stream),
  • AFTER (all data from the dataset are loaded after the data in the main stream),
  • SYNTRAC (one trace from the dataset is loaded every time a trace has been obtained from the main stream),
  • EAFTER (one trace from the dataset is loaded every time a complete ensemble has been obtained from the main stream. Traces are added into the same ensemble after all of its traces),
  • EBEFORE (one trace from the dataset is loaded every time a complete ensemble has been obtained from the main stream. The added traces are added to the same ensemble before its traces).
  • ALLAFTR (all traces from the dataset are loaded after every trace on input).
    •  In EBEFORE and EAFTER modes, the header fields that are not defined in the loaded trace are taken from an adjacent trace in the ensemble.
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • After (AFTER)
      • Before (BEFORE)
      • Ens. after (EAFTER)
      • Ens. before (EBEFORE)
      • On trace (SYNTRAC)
      • All after (ALLAFTR)
    • Default value: AFTER

    KEY

    		 Name of (integer) trace header entry used for selective operation in SYNTRAC, EBEFORE, and EAFTER modes
    • Format: Character (8 characters)
    • Default value: No selection - Load for each trace or ensemble

    KEYVAL

    		 KEY selector value for which the data are loaded. In EBEFORE and EAFTER modes, if trace header field is used, the value is taken from the first trace in the current ensemble
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    Preceding list (HSHIFT)

    INTABLE

    In table

    Table entry selector. The values of a trace header field are compared to values of a specified table entry. Only exact (within some tolerance range) matches are passed or excluded from processing (depending on the calling tool).

    Usage: INTABLE KEY TOLER TABKEY TABLE
    4 parameters in this list:

    KEY

    		 Header entry values of which are used for branching
    • Format: Character (8 characters)
    • Default value: Not specified

    TOLER

    		 Tolerance in the comparisons of KEY to TABKEY
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0.001

    TABKEY

    		 Table entry field with which KEY is matched
    • Format: Character (8 characters)
    • Default value: Not specified

    TABLE

    		 Table name or table name mask
    • Format: Character (64 characters)
    • Default value: Not specified

    1 group of 4 REPEAT parameters per line:

    Additional keys that may be compared to the table entry identified by the KEY value above. These repeat groups can also specify ranges of values. To pass the comparator, all expressions specified in these groups must return True.

    KEY

    		 Additional header used for branching
    • Format: Character (8 characters)
    • Default value: Not specified

    TOLER

    		 Tolerance in the comparisons of KEY to TABKEY
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0.0

    TABKEY1

    		 The minimum level with which KEY is compared. The comparison is True if KEY lies within [TABKEY1-TOLER, TABKEY2+TOLER]
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    TABKEY2

    		 The maximum level with which KEY is compared. The comparison is True if KEY lies within [TABKEY1-TOLER, TABKEY2+TOLER]
    • Format: Character (8 characters)
    • Default value: Not specified

    Preceding list (INSERT)

    ISNULL

    Is null

    Selector equal TRUE when the KEY value equals the current NULL value (by default, -12345, but adjustable in tool SETUP)

    Usage: ISNULL KEY
    1 parameter in this list:

    KEY

    		 Header entry compared to NULL (integer or real)
    • Format: Character (8 characters)
    • Default value: Not specified

    Preceding list (INTABLE)

    JULDAY

    Julian day.

    Returns the number of the julian day

    Usage: JULDAY RESULT FORMAT YEAR MONTH DAY
    5 parameters in this list:

    RESULT

    		 Name of header entry to write the number of julian day into
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header entry
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: Not specified

    YEAR

    		 Year
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1970

    MONTH

    		 Month
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1

    DAY

    		 Day of the month
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1

    Preceding list (ISNULL)

    LIST

    List

    List selector

    Usage: LIST KEY
    1 parameter in this list:

    KEY

    		 Header entry whose values are used for branching
    • Format: Character (8 characters)
    • Default value: Not specified

    10 groups of 1 REPEAT parameter per line:

    KEYVAL

    		 Value of KEY
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (JULDAY)

    LOOKSRC

    Lookup source.

    For the last successful LOOKUP, OLOOKUP, or CLOOKUP, specifies the header field into which the program places the name of the table actually used in the operation.

    Usage: LOOKSRC TARGET FORMAT
    2 parameters in this list:

    TARGET

    		 Name of the entry in current table or trace header into which the name of the table is placed.
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of TARGET (must be among CHARACTER types)
    • Format: Character (8 characters)
    • Default value: real

    Preceding list (LIST)

    LOOKUP

    Lookup value

    Retrieves a value from a table. If the argument lies beyond the range of the table argument, LOOKUP fails.

    Usage: LOOKUP RESULT FORMAT LOOKUP TABLE
    4 parameters in this list:

    RESULT

    		 Name of the entry in current table or trace headers which is created or modified
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of TARGET
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: int

    LOOKUP

    		 Name of the entry in the source table whose value will be assigned to RESULT. This entry must be defined during Edit phase.
    • Format: Character (8 characters)
    • Default value: Not specified

    TABLE

    		 Name of the table used for the interpolation. If this field is left blank, we try to find an "associated" table. The association is established through ASSOC list in module DEFINE. If such association call is found, an attempt is made to replace the corresponding token in the name of the table on which LOOKUP is currently working, and to replace this token with the substitution string.
    • Format: Character (64 characters)
    • Default value: The Associated table

    5 groups of 2 REPEAT parameters per line:

    SOURCE

    		 Name of the argument in the TABLE
    • Format: Character (8 characters)
    • Default value: Not specified

    VALUE

    		 Value of the SOURCE entry. This value must be a constant or be found in the trace header or in current table
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (LOOKSRC)

    MATCH

    String match

    Selector based on text string matching. If TOKEN1 matches TOKEN2 (UNIX-style wildcards allowed), the condition is satisfied.

    Usage: MATCH TOKEN1 TOKEN2
    2 parameters in this list:

    TOKEN1

    		 First token compared to TOKEN2. Text substitutions using {...} with trace parameters are allowed.
    • Format: Character (24 characters)
    • Default value: Not specified

    TOKEN2

    		 Second token compared to TOKEN1. Text substitutions using {...} with trace parameters are allowed.
    • Format: Character (64 characters)
    • Default value: Not specified

    Preceding list (LOOKUP)

    MAXLEN

    Maximum trace length

    Restricts the output trace length. Ttraces longer than MAXLEN samples are splt into multiple traces of (nearly) equal lengths. This prevents some tools (such as using FFT) from problems with overly long records.

    Usage: MAXLEN MAXLEN
    1 parameter in this list:

    MAXLEN

    		 Maximum number of samples allowed in output traces. Non-positive values mean no limit.
    • Format: INTEGER
    • Default value: -1

    Preceding list (MATCH)

    NAME

    Name

    Name assigned to the input point. The name can be used, for example, by the interactive input.

    Usage: NAME NAME WAIT
    2 parameters in this list:

    NAME

    		 Name assigned to the tool
    • Format: Character (24 characters)
    • Default value: Not specified

    WAIT

    		 If Wait for request is specified, the data is loaded when requested by the GUI. If "Read now" is set, LOAD will load the data normally, and on request from the GUI, it may re-load the records.
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • On request (WAIT)
      • Read now (NOW)
    • Default value: Not specified

    Preceding list (MAXLEN)

    NOTNULL

    Not null

    Selector equal TRUE when the KEY value does not equal the current NULL value (by default, -12345, but adjustable in tool SETUP)

    Usage: NOTNULL KEY
    1 parameter in this list:

    KEY

    		 Header entry compared to NULL (integer or real)
    • Format: Character (8 characters)
    • Default value: Not specified

    Preceding list (NAME)

    NULL

    Null

    This list behaves exactly as ISNULL

    Usage: NULL KEY
    1 parameter in this list:

    KEY

    		 Header entry compared to NULL (integer or real)
    • Format: Character (8 characters)
    • Default value: Not specified

    Preceding list (NOTNULL)

    OLOOKUP

    "Or LOOKUP".

    Works in the same way as LOOKUP, but OLOOKUP does not fail when the argument is beyond the range of the table argument. Instead, other OLOOKUP calls are tried, and the operation fails only if all the calls fail to produce result. If an OLOOKUP operation is successfull, all the following similar calls are ignored. Note that ALL operations of the HDRMATH-type lists are carried out in the same sequence. Thus it makes sense to group all OLOOKUP lists together, in order to avoid confusion.

    Usage: OLOOKUP RESULT FORMAT LOOKUP TABLE
    4 parameters in this list:

    RESULT

    		 Name of the entry in current table or trace headers which is created or modified
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of TARGET
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: real

    LOOKUP

    		 Name of the entry in the source table whose value will be assigned to RESULT. This entry must be defined during Edit phase.
    • Format: Character (8 characters)
    • Default value: Not specified

    TABLE

    		 Name of the table used for the interpolation. If this field is left blank, we try to find an "associated" table. The association is established through ASSOC list in module DEFINE. If such association call is found, an attempt is made to replace the corresponding token in the name of the table on which LOOKUP is currently working, and to replace this token with the substitution string.
    • Format: Character (56 characters)
    • Default value: The Associated table

    5 groups of 2 REPEAT parameters per line:

    SOURCE

    		 Name of the argument in the TABLE
    • Format: Character (8 characters)
    • Default value: Not specified

    VALUE

    		 Value of the SOURCE entry. This value must be a constant or be found in the trace header or in current table
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (NULL)

    ORDER

    Order

    Selection of traces based on the sequence of values of a specified header (for example, offset, or station number).

    When using multiple ORDER statements, their criteria are combined by "AND" operation, as any other conditions in this tool. However, RESET criteria in these statements are combined by using "OR", (i.e., any one of the RESET clauses will reset all counters).

    Usage: ORDER MODE KEY MARGIN RESET
    4 parameters in this list:

    MODE
  • DEC: select traces going in decreasing order of VALUE
  • NOTDEC: select traces going in not decreasing order of VALUE
  • INC: select traces going in increasing order of VALUE
  • NOTINC: select traces going in not increasing order of VALUE
  • DENSE: select traces for which KEY is separated by less than MARGIN
  • REPEAT (or OLD, or NOTNEW): select traces with KEY values lying within MARGIN from the corresponding value in one of preceding traces
  • NEW: select traces for which the KEY values differs from all preceding it
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Decreasing (DEC)
      • Non-decreasing (NOTDEC:Increasing:INC)
      • Non-increasing (NOTINC)
      • Dense (DENSE)
      • Repeated (REPEAT)
    • Default value: DEC

    KEY

    		 Trace header used for comparisons. Constant value can be used but appears unreasonable in this case. The traces with decreasing (increasing) values of VALUE will be omitted or zeroed out, depending on the MODE selected for the tool (usually in Global list).
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    MARGIN

    		 Tolerance margin on the KEY values applied during comparisons
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0.3

    RESET

    		 Trace header used to reset the comparator. When the value of RESET changes, the array of stored values are cleared. Note that for multiple ORDER lists, any one of their RESET clauses will reset all lists.
    • Format: Character (8 characters)
    • Default value: Not specified

    Preceding list (OLOOKUP)

    ORELSE

    Or else

    This list starts a new sequence of RANGE, LIST, INTABLE, GROUP, ORDER, etc. statements. The result of their evaluation is added to the result of the main list by logical OR operation.

    Usage: ORELSE (No parameters)

    No REPEAT parameter groups in this list.


    Preceding list (ORDER)

    PRINT

    Print file header

    Prints file name and a file header summary for each input file or data source. The type of summary depends on parameter WHAT and file type

    Usage: PRINT WHAT MODE
    2 parameters in this list:

    WHAT

    		 What to print. For FNAME, only file name is printed, for ALL - all available information for the given file type or data source.
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • File name (FNAME)
      • All (ALL)
    • Default value: ALL

    MODE

    		 Continuation mode. If EXIT is placed here the input stops after the seismogram header is listed.
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Continue (CONT)
      • Exit (EXIT)
    • Default value: CONT

    Preceding list (ORELSE)

    PRINTF

    Print

    Prints the specified value into the current log file.

    Usage: PRINTF VALUE FORMAT
    2 parameters in this list:

    VALUE

    		 Name of the trace header (table record) entry to output. If this value is defaulted, the string still can be prined by using text substitutions {...}
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format string for printing, including the standard C format specifier. The string can be continued in REPEAT lines. Newline (n) is appended automatically.
    • Format: Character (80 characters)
    • Default value: %d

    1 group of 1 REPEAT parameter per line:

    FORMAT

    		 Continuation of the format string
    • Format: Character (88 characters)
    • Default value: Not specified

    Preceding list (PRINT)

    RANGE

    Range

    Range selector. Several ranges are allowed; traces are passed if they satisfy AT LEAST one of the ranges.

    Usage: RANGE KEY MIN MAX
    3 parameters in this list:

    KEY

    		 Header entry which values are used for branching
    • Format: Character (8 characters)
    • Default value: Not specified

    MIN

    		 Min value of KEY
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    MAX

    		 Max value of KEY
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    5 groups of 2 REPEAT parameters per line:

    MIN

    		 Min value of KEY
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    MAX

    		 Max value of KEY
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (PRINTF)

    REDUCE

    Travel time reduction

    Usage: REDUCE MODE TIME OFFSET VEL
    4 parameters in this list:

    MODE

    		 Application mode:
  • FORW (or APPLY; forward transformation--time reduction),
  • INVERSE (or REMOVE; removal of time reduction)
    •
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Apply (APPLY)
      • Remove (REMOVE)
    • Default value: FORW

    TIME

    		 Name of the TIME header entry that is corrected by this procedure
    • Format: Character (8 characters)
    • Default value: Not specified

    OFFSET

    		 Offset used for the reduction
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    VEL

    		 Reduction velocity
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: No reductiun

    Preceding list (RANGE)

    REWIND

    Rewind

    When a trace with KEY1=KEY2 is encountered, the dataset is reset for input. For datasets allowing custom inputs (such as SQL datasets), the inputs are re-evaluated (SQL database queried) using parameters of the current trace.

    Usage: REWIND WHEN KEY1 KEY2 DROPAN COPYHDR
    5 parameters in this list:

    WHEN

    		 Parameter specifying the response of the dataset. For EOF, LOAD will start output normally, i.e., when it gets to the EOF phase. For NOW, it will start output immediately following the present trace. In this case, the inputs of LOAD will be blocked until the dataset is exhausted.
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • EOF phase (EOF)
      • Now (NOW)
    • Default value: EOF

    KEY1

    		 The first part of optional selector used for anchor traces. If KEY1=KEY2, the trace is considered aqs anchor and causes loading from the dataset. Normally, KEY1 and KEY2 are integer trace headers or constants.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    KEY2

    		 The first part of optional selector used for anchor traces. If KEY1=KEY2, the trace is considered aqs anchor and causes loading from the dataset. Normally, KEY1 and KEY2 are integer trace headers or constants.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    DROPAN

    		 Flag indicating whether to keep or drop the anchor trace after loading dataset traces and copying the header
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Keep (KEEP)
      • Drop (DROP)
    • Default value: KEEP

    COPYHDR

    		 Flag indicating whether to copy all custom headers from the anchor trace into the traces loaded from the data sources
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Copy headers (COPYHDR)
      • Do not copy (NOCOPY)
    • Default value: NOCOPY

    11 groups of 1 REPEAT parameter per line:

    This Repeat list is used if KEY1 != COPYHDR. This list contains names of the headers that need to be copied from anchor trace to the output trace. Headers KEY1 or KEY2 are usually not copied but set equal -12345, in order to differentiate the new traces from the anchors.

    HDR

    		 Copied header name
    • Format: Character (8 characters)
    • Default value: Not specified

    Preceding list (REDUCE)

    SCANF

    Scan

    Scan header value from a text string.

    Usage: SCANF RESULT FORMAT STRFORM ADDFORM
    4 parameters in this list:

    RESULT

    		 Name of the trace header (table record) entry to output
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: real

    STRFORM

    		 Scan format string, as used by scanf() function in C language. Several predefined names (case insensitive) are used to convert some special string representations of values:
  • -LATITUDE- : reads encoded latitude values. If decimal dot is present in the string, for example, 45.23N, it is interpreted as 45.23 deg North. If there is no decimal dot, such as "48470974N", then 48 is the degrees, 47 - minutes, 09.474 - seconds, and the literal may be S or N.
  • -LONGITUDE- : reads encoded longitude values. If decimal dot is present in the string, for example, 45.23E, it is interpreted as 45.23 deg East. If there is no decimal dot, such as"48470974W", then 48 is the degrees, 47 - minutes, 09.474 - seconds, and the literal may be W or E.
  • -YMD- : reads encoded epoch date written as a single integer combining the year, month, and day. For example, 20081203 means the beginning of December 03 in year 2008
  • -YJD- : reads encoded epoch date written as a single integer combining the year and Julian day. For example, 2008123 means the beginning of day 123 in year 2008
  • -YMDHMS- : reads encoded epoch time values as a sequence of year, month, day, hour, min, sec values separated by spaces, colons, or slashes.
  • -YJDHMS- or -YDHMS-: reads encoded epoch time values as a sequence of year, Julian day, hour, min, sec values separated by spaces, colons, or slashes.
  • --PHPTIME-: reads encoded epoch time values as a PHP-formatted time string, according to format string ADDFORM.
  • --SQLTIME-: reads encoded epoch time values as a SQL-formatted time string, according to format string ADDFORM.
  • --YEAR-: extracts year from epoch time in seconds.
    •
    • Format: Editable selection (24 characters)
    • Selectable Values: (codes in parentheses)
      • Latitude (-LATITUDE-)
      • Longitude (-LONGITUDE-)
      • Time (YMDHMS) ( -YMDHMS-)
      • Time (YJDHMS) ( -YJDHMS-)
      • Time(YMD) ( -YMD-)
      • Time(YJD) ( -YJD- )
      • Year ( -YEAR-)
    • Default value: Not specified

    ADDFORM

    		 Additional format (such as of the time string)
    • Format: Character (48 characters)
    • Default value: Not specified

    1 group of 1 REPEAT parameter per line:

    STRING

    		 Source string. The string can use symbolic substitutions using headers of the current trace or table record. Multiple strings entered in this REPEAT group are concatenated before scanning.
    • Format: Character (88 characters)
    • Default value: Not specified

    Preceding list (REWIND)

    SEGYFMT

    SEGY format

    Options for loading SEGY-like files. These options may override some specifications of the format.

    Usage: SEGYFMT FTYPE EXTEND FHEAD SHEAD HDRFORM SAMFORM SAMPNUM SAMPINT SAMPVAR AUTOSWP
    10 parameters in this list:

    FTYPE

    		 NOT IMPLEMENTED. File name extension to which this option refers. Blank (default) applies to all SEGY-like files.
    • Format: Character (8 characters)
    • Default value: Not specified

    EXTEND

    		 Type or modification of SEGY format. Types available:
  • SEGY Revision 1;
  • PASSCAL extension (some additional timing-related values in free-format headers)
  • Seismic UNIX extension (no file headers, additional header fields)
  • Lithoprobe extension (some additional headers),
  • ARAM (ARIES) acquisition system disk file format (ASCII file header instead of EBCDIC, MS-DOS IEEE.32 header and sample formats instead of IBM)
    •
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Standard (STAND)
      • Revision 1 (REV1)
      • Passcal (PASSCAL)
      • Seismic UNIX (SU)
      • Lithopobe (LITHOPR)
      • ARAM (same as ARIES) (ARAM)
    • Default value: REV1

    FHEAD

    		 Flag indicating whether the SEGY file (EBCDIC) header is present in the file, and what format is used for it. This option overrides the standard setting for the current SEGY-like format
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • EBCDIC encoding (EBCDIC)
      • ASCII encoding (ASCII)
      • No header (NONE)
    • Default value: DEF

    SHEAD

    		 Flag indicating whether the SEGY seismogram (binary) header is present in the file. This option overrides the standard setting for the current SEGY-like format
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Header present (HEADER)
      • No header (NONE)
    • Default value: HEADER

    HDRFORM

    		 Seismogram and trace header format. If values other than NONE are selected, they will override the selections made by SEGY extension.
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • No override (NONE)
      • Default (SEGY) (DEF)
      • By SEGY convention (SEGY)
      • By CSEGY convention (CSEGY)
      • IBM| IEEE (IEEE)
    • Default value: NONE

    SAMFORM

    		 Data sample format override
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • No override (NONE)
      • Default (SEGY) (DEF)
      • By SEGY convention (SEGY)
      • By CSEGY convention (CSEGY)
      • Autodetect (not imlemented) (AUTO)
      • Autodetect 4-byte (not imlemented) (AUTO4)
      • Autodetect 2-byte (not imlemented) (AUTO2)
      • IBM 4-byte real (IBM4)
      • IEEE 4-byte float (IEEE4)
      • IEEE 2-byte real (IEEE2)
      • Integer 2-byte (little endian) (INT2-LE)
      • Integer 2-byte (big endian) (INT2-BE)
      • Integer 4-byte (little endian) (INT4-LE)
      • Integer 4-byte (big endian) (INT4-BE)
      • Integer 1-byte (INT1)
    • Default value: NONE

    SAMPNUM

    		 Number of samples per trace (<=0 means determined from the header
    • Format: INTEGER
    • Default value: 0

    SAMPINT

    		 Sample interval override (<=0.0 means determined from the header
    • Format: FLOAT
    • Default value: 0

    SAMPVAR

    		 Flag indicating whether the sampling interval and number of samples are read in from each trace
    • Format: TOGGLE
    • Min value: yes:YES|no:NO
    • Default value: YES

    AUTOSWP

    		 Flag for automatically selecting data byte order by testing the statistics of data values in the first trace
    • Format: TOGGLE
    • Min value: yes:YES|no:NO
    • Default value: YES

    Preceding list (SCANF)

    SEGYOPT

    SEGY options

    This list specifies the optionsfor loading SEGY-like files. These options may override some specifications of the format.

    Usage: SEGYOPT SCALEZ SCALEX
    2 parameters in this list:

    SCALEZ

    		 Value overriding the SEGY depth scalar located at byte 71 in SEGY trace headers. Negative value means using the standard SEGY scalar. The standard SEGY scalar is taken to equal 1.0
    • Format: FLOAT
    • Default value: -1.0

    SCALEX

    		 Value overriding the SEGY coordinate scalar located at byte 69 in SEGY trace headers. Negative value means using the standard SEGY scalar.
    • Format: FLOAT
    • Default value: -1.0

    Preceding list (SEGYFMT)

    SET

    Set

    Linear combination of functions of header values.

    Usage: SET RESULT FORMAT ADD WEIGHT FUNCTN PARAM2 PARAM3
    7 parameters in this list:

    RESULT

    		 Name of header entry to write the result into
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header entry: FLOAT or INTEGER
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: int

    ADD

    		 Constant term to add
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    WEIGHT

    		 Factor to multiply after all other calculations
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1

    FUNCTN

    		 Function to calculate (x denotes the argument):
  • ABS, absolute value
  • BRANCH - for the first trace or table entry, returns 1; increments the return value whenever the subsequent values of X differ by more than PARAM;
  • COS, SIN, TG, TAN (trigonometric functions; radian measure of the argument),
  • COS_D, SIN_D, TG_D, TAN_D (trigonometric functions; degree measure of the argument),
  • LN, LG (natural and decimal logariphms),
  • EXP, EXP10, (powers of e and 10),
  • POWER (x**PARAM)
  • SIGN,
  • DELTA (Kroeneker - for integer values of the argument),
  • SQR, SQRT, INV(1.0/x)
  • MOD (float or integer residual of x(PARAM)),
  • DIV (floor(x/PARAM)),
  • CEIL, FLOOR, MANT (mantissa),
  • RAND-U (random value uniformly distributed within [0..x]),
  • RAND-G (random value normally distributed with variance=x)
    •  Functions describing the amplitudes of upcoming P- or S-waves waves reflected from the free surface:
  • P>PP, P>PS - PP and PS reflection coefficients for a plane P-wave incident on the surface from below, as a function of its ray parameter. The subsurface P- and S-wave velocities should be given in PARAM2 and PARAM3, respectively;
  • P>Z, P>R - vertical and radial displacements for a plane P-wave incident on the surface from below, as a function of its ray parameter. The subsurface P- and S-wave velocities should be given in PARAM2 and PARAM3, respectively;
  • P>R/Z - a ratio of the radial and vertical-component displacements for a plane P-wave incident on the surface from below, as a function of its ray parameter. The subsurface P- and S-wave velocities should be given in PARAM2 and PARAM3, respectively;
  • P>INCL - inclination angle (degrees) of surface particle motion for a plane P-wave incident on the surface from below, as a function of its ray parameter. The subsurface P- and S-wave velocities should be given in PARAM2 and PARAM3, respectively;
  • S>PP, S>PS, S>Z, S>R, S>INCL, S>R/Z - similar parameters for an SV-wave incident on the free surface
    • In these expressions, axis R is directed horizontally along the ray parameter, and Z points downward. Also, some specialized functions:
  • arc/deg - converts arc in degrees to linear arc length units (km, m, ft, depending on the current units of length);
  • deg/arc - converts arc length in the current units (km, m, ft, etc.) to degrees ("delta");
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • None (NONE)
      • Abs(x) (ABS)
      • branch(x) (BRANCH)
      • cos(x) (COS)
      • sin(x) (SIN)
      • tan(x) (TAN)
      • arccos(x) (ACOS)
      • arcsin(x) (ASIN)
      • arctan(x) (ATAN)
      • cos(x degrees) (COS_D)
      • sin(x degrees) (SIN_D)
      • tan(x degrees) (TAN_D)
      • ln(x) (LN)
      • log10(x) (LG)
      • exp(x) (EXP)
      • 10**x (EXP10)
      • x**PARAM (POWER)
      • sign(x) (SIGN)
      • delta(int x) (DELTA)
      • sqr(x) (SQR)
      • sqrt(x) (SQRT)
      • 1/x (INV)
      • mod(x) (MOD)
      • floor(x/PARAM) (DIV)
      • ceil(x) (CEIL)
      • floor(x) (FLOOR)
      • mantissa(x) (MANT)
      • random_uniform in [0..x] (RAND_U)
      • random_Gauss(variance=x) (RAND_G)
      • Degrees(arc length) (deg/arc)
      • Arc_length(degrees) (arc/deg)
      • P to Prefl (P>P)
      • P to Srefl (P>S)
      • P to Z amplitude (P>Z)
      • P to R amplitude (P>R)
      • P to R/Z ratio (P>R/Z)
      • P to R,Z inclination (P>R/Z)
      • S to Prefl (S>P)
      • S to Srefl (S>S)
      • S to Z amplitude (S>Z)
      • S to R amplitude (S>R)
      • S to R/Z ratio (S>R/Z)
      • S to R,Z inclination (S>R/Z)
    • Default value: NONE

    PARAM2

    		 Second parameter of some functions (DIV, MOD, POWER, and P-wave reflectivity functions), as explained in the descriptions of FUNCTN
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    PARAM3

    		 Third parameter of some functions (P-wave reflectivity functions), as explained in the descriptions of FUNCTN
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    2 groups of 4 REPEAT parameters per line:

    WEIGHT

    		 Weight of FUNCTION(ENTRY)
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    FUNCTN

    		 Function to calculate:
  • ABS, absolute value
  • BRANCH - for the first trace or table entry, returns 1; increments the return value whenevar the subsequent values of X differs by more than PARAM;
  • COS, SIN, (trigonometric functions; radian measure of the argument),
  • RAND-G (random value normally distributed with variance=x)
  • LN, LG (natural and decimal logariphms),
  • EXP, EXP10, (powers of e and 10),
  • POWER (x**PARAM)
  • SIGN,
  • DELTA (Kroneker delta - for integer values of the argument),
  • SQR, SQRT, INV ( 1. / x )
  • MOD (float or integer residual of x(PARAM)),
  • DIV (floor(x/PARAM)),
  • CEIL, FLOOR, MANT (mantissa),
  • RAND-U (random value uniformly distributed within [0..x]),
  • RAND-G (Gaussian random value with mean=0 and variance=x)
    •  Also, some more specialized functions:
  • arc/deg - converts arc in degrees to linear arc length units (km, m, ft, depending on the currents units of length);
  • deg/arc - converts arc length in the current units (km, m, ft, etc.) to degrees ("delta");
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • None (NONE)
      • Abs(x) (ABS)
      • branch(x) (BRANCH)
      • cos(x) (COS)
      • sin(x) (SIN)
      • tan(x) (TAN)
      • arccos(x) (ACOS)
      • arcsin(x) (ASIN)
      • arctan(x) (ATAN)
      • cos(x degrees) (COS_D)
      • sin(x degrees) (SIN_D)
      • tan(x degrees) (TAN_D)
      • ln(x) (LN)
      • log10(x) (LG)
      • exp(x) (EXP)
      • 10**x (EXP10)
      • x**PARAM (POWER)
      • sign(x) (SIGN)
      • delta(int x) (DELTA)
      • sqr(x) (SQR)
      • sqrt(x) (SQRT)
      • 1/x (INV)
      • mod(x) (MOD)
      • floor(x/PARAM) (DIV)
      • ceil(x) (CEIL)
      • floor(x) (FLOOR)
      • mantissa(x) (MANT)
      • random_uniform in [0..x] (RAND_U)
      • random_Gauss(variance=x) (RAND_G)
      • Degrees(arc length) (deg/arc)
      • Arc_length(degrees) (arc/deg)
      • P to Prefl (P>P)
      • P to Srefl (P>S)
      • P to Z amplitude (P>Z)
      • P to R amplitude (P>R)
      • P to R/Z ratio (P>R/Z)
      • P to R,Z inclination (P>R/Z)
      • S to Prefl (S>P)
      • S to Srefl (S>S)
      • S to Z amplitude (S>Z)
      • S to R amplitude (S>R)
      • S to R/Z ratio (S>R/Z)
      • S to R,Z inclination (S>R/Z)
    • Default value: NONE

    FACTOR

    		 Factor to multiply before calculating FUNCTION (default 1)
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    ENTRY

    		 Name of header entry to add with WEIGHT to RESULT
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (SEGYOPT)

    SETMAX

    Maximum value

    Sets the result equal to a function of the maximum value of a list of supplied entries.

    Usage: SETMAX TYPE RESULT FORMAT
    3 parameters in this list:

    TYPE

    		 Type of maximum used. For LOCAL, only values derived from the current record are compared. For GLOBAL, the value is accumulated over all preceding records.
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Global (GLOBAL)
      • Local (LOCAL)
    • Default value: GLOBAL

    RESULT

    		 Name of header entry to write result into
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header entry: FLOAT or INTEGER
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: int

    10 groups of 1 REPEAT parameter per line:

    ENTRY

    		 One of the values for which the maximum is sought
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (SET)

    SETMIN

    Minimum value

    Sets the result equal to a function of the minimum value of a list of supplied entries.

    Usage: SETMIN TYPE RESULT FORMAT
    3 parameters in this list:

    TYPE

    		 Type of maximum used. For LOCAL, only values derived from the current record are compared. For GLOBAL, the value is accumulated over all preceding records.
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Global (GLOBAL)
      • Local (LOCAL)
    • Default value: GLOBAL

    RESULT

    		 Name of header entry to write result into
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header entry: FLOAT or INTEGER
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: int

    10 groups of 1 REPEAT parameter per line:

    ENTRY

    		 One of the values among which the minimum is sought
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (SETMAX)

    SHEADER

    Seismogram header

    Defines additional seismogram (shot, file) headers supported by some formats (currently SEGY or SU)

    Usage: SHEADER NAME FORMAT FIRSTBT RECFORM
    4 parameters in this list:

    NAME

    		 Name to be assigned to the header entry
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header field created
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: INTEGER

    FIRSTBT

    		 Number of the first byte of the field (count starting from 1)
    • Format: INTEGER
    • Default value: Not specified

    RECFORM

    		 Format of the field in trace file record. This may include the length of the field, for example: int1, int2, int4, real2, c8, c24
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: INTEGER

    1 group of 4 REPEAT parameters per line:

    NAME

    		 Name to be assigned to the header entry
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header field created
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: INTEGER

    FIRSTBT

    		 Number of the first byte of the field (count starting from 1)
    • Format: INTEGER
    • Default value: Not specified

    RECFORM

    		 Format of the field in trace file record. This may include the length of the field, for example: int1, int2, int4, real2, c8, c24
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: INTEGER

    Preceding list (SETMIN)

    SPRINTF

    Print into header

    Prints a string into a specified trace (or table) header field

    Usage: SPRINTF RESULT FORMAT OPER FAILED
    4 parameters in this list:

    RESULT

    		 Name of the trace header (table record) entry to write the result into
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header entry, must be of a character type
    • Format: Character (8 characters)
    • Default value: c8

    OPER

    		 Transformation performed with the string:
  • SHELL, or UNIX - replace the string with a result of a UNIX shell command
  • NONE - no transformation
    •
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • UNIX shell (SHELL)
      • None (NONE)
    • Default value: NONE

    FAILED

    		 String copied into RESULT in the case when the operation OPER fails (e.g., no string returned by the UNIX shell).
    • Format: Character (56 characters)
    • Default value: Not specified

    1 group of 1 REPEAT parameter per line:

    STRING

    		 String copied into RESULT, after text edits and operation OPER applied. Strings entered in multiple lines are concatenated.
    • Format: Character (88 characters)
    • Default value: Not specified

    Preceding list (SHEADER)

    STORE

    Load STORE

    Loads data traces from named run-time gathers accumulated by module STORE

    Usage: STORE PURGE
    1 parameter in this list:

    PURGE

    		 PURGE (remove data from the named sequence when it has been transferred to the main data flow), or KEEP (copy data from the named sequence and keep them there. in KEEP mode, the BEFORE and AFTER options above will result in an INFINITE (!!!) sequence of traces. In SYN... modes this will result in copying the same trace (ensemble) from the named sequence after each trace (ensemble) in the main data flow.
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Purge (PURGE)
      • Keep (KEEP)
    • Default value: PURGE

    Preceding list (SPRINTF)

    TGATE

    Time gate

    Extract a time range from the records.

    Usage: TGATE TSTART TEND
    2 parameters in this list:

    TSTART

    		 Start of the extracted time segment.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    TEND

    		 End of the extracted time segment.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    Preceding list (STORE)

    TGATE

    Time gate

    Enables branching based on the presence of a specified time interval ("time gate") in the record. If the trace contains data samples within the specified time window, the condition is satisfied.

    Usage: TGATE TBEG TEND PART MODE VALUE
    5 parameters in this list:

    TBEG

    		 Beginning of time window
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    TEND

    		 End of time window
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: Not specified

    PART

    		 Part of the time window with samples, in %. Value 0 means at least one sample must be present within the window; 100 means the entire window must be filled with trace samples in order for the criterion to be TRUE. Another example: PART=30 means that at least 30% of the window is sampled by the trace.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Min value: 0
    • Max value: 100
    • Default value: 0

    MODE

    		 Mode of interpreting samples within the time gate:
  • ANY (or ALL): consider any data samoples present in the window
  • NONZERO (or NOT0, "!=0": consider only nonzero samples with absolute values exceeding parameter VALUE
  • ZERO (or 0, "=0": consider only zero samples with absolute values less or equal parameter VALUE
    		•
    • Format: Selection
    • Selectable Values: (codes in parentheses)
      • Any (ANY)
      • Nonzero (NONZERO)
      • Zero (ZERO)
    • Default value: ANY

    VALUE

    		 Additional parameter for mode NONZERO (maximum value interpreted as zero absolute value of trace sample.
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0.0

    Preceding list (TGATE)

    THEADER

    Trace header

    Defines additional trace headers (supported by some formats, currently SEGY or SU)

    Usage: THEADER NAME FORMAT FIRSTBT RECFORM
    4 parameters in this list:

    NAME

    		 Name to be assigned to the header entry
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header field created
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: INTEGER

    FIRSTBT

    		 Number of the first byte of the field (count starting from 1)
    • Format: INTEGER
    • Default value: Not specified

    RECFORM

    		 Format of the field in trace file record. This may include the length of the field, for example: int1, int2, int4, real2, c8, c24
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: INTEGER

    1 group of 4 REPEAT parameters per line:

    NAME

    		 Name to be assigned to the header entry
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header field created
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: INTEGER

    FIRSTBT

    		 Number of the first byte of the field (count starting from 1)
    • Format: INTEGER
    • Default value: Not specified

    RECFORM

    		 Format of the field in trace file record. This may include the length of the field, for example: int1, int2, int4, real2, c8, c24
    • Format: Header entry format: float, double, integer, long, or char
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
    • Default value: INTEGER

    Preceding list (TGATE)

    TOOLMSG

    Message

    Sends messages to other tools. The response received from the tool can be processed similarly to DBSQL.

    Usage: TOOLMSG OBJECT
    1 parameter in this list:

    OBJECT

    		 Tool or object name (e.g., database or dataset name, model name in RSGLI and REFLECT, etc.
    • Format: Character (24 characters)
    • Default value: Not specified

    1 group of 1 REPEAT parameter per line:

    MESSAGE

    		 One line of message. The lines are concatenated and sent to the corresponding tool (object). Lines beginning with token ">>" are not included in the message string but interpreted as commands for processing the returned string. These commands can be:
    • >> set trace_hdr format response_token - copies the value identified by "response_token=value" into trace/table header of the specified format;
    • Format: Character (88 characters)
    • Default value: Not specified

    Preceding list (THEADER)

    YDHMS

    Year-day-hour-min-sec

    Transforms dates/times in year:day:hour:min:sec format to milliseconds relative to the current time base

    Usage: YDHMS RESULT FORMAT YEAR DAY HOUR MIN SEC
    7 parameters in this list:

    RESULT

    		 Name of header entry to write result into
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header entry
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: Not specified

    YEAR

    		 Year
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1970

    DAY

    		 Day of the year
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1

    HOUR

    		 Hour
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    MIN

    		 Minute
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    SEC

    		 Second
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    Preceding list (TOOLMSG)

    YMDHMS

    Year-month-day-hour-min-sec

    Transforms dates/times in year:month:day:hour:min:sec format to milliseconds relative to the current time base

    Usage: YMDHMS RESULT FORMAT YEAR MONTH DAY HOUR MIN SEC
    8 parameters in this list:

    RESULT

    		 Name of header entry to write result into
    • Format: Character (8 characters)
    • Default value: Not specified

    FORMAT

    		 Format of the header entry
    • Format: Numeric Header entry format: float, double, integer, or long
    • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE
    • Default value: Not specified

    YEAR

    		 Year
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1970

    MONTH

    		 Month
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1

    DAY

    		 Day of the month
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 1

    HOUR

    		 Hour
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    MIN

    		 Minute
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    SEC

    		 Second
    • Format: Trace Header (table entry), name, or numerical value (8 characters)
    • Default value: 0

    Preceding list (YDHMS)
    IGeoS version 5.1
    Copyright (c) 1995-2015, I.B.Morozov
    Updated Wed Apr 1 21:42:11 2020