NAME

     rest  - apply/remove  trace  statics,  phase  rotations,  or
     scale factors from trace header word

SYNOPSIS

     rest [ -Nntap ] [ -Ootap ] [ -nsns ] [ -nene ] [ -rsirs ]  [
     -reire   ]   [   -SWiswd   ]  [  -piglob  ]  [  -uunit  ]  [
     -nullvaluenullvalue ] [ -A ] [ -P ] [ -F ] [ -FS ] [ -D ]  [
     -titd ] [ -U ] [ -Mdsii ] [ -null ] [ -C ] [ -V ] [ -? ]

DESCRIPTION

     rest takes a set of traces  and  extracts  a  value  from  a
     specified  header word and either (1) applies (or unapplies)
     the trace header statics and writes the results to the  out-
     put,  or  (2)  applies (or unapplies) the trace header phase
     rotations and writes the  results  to  the  output,  or  (3)
     applies  (or  unapplies) a trace scale factor and writes the
     results to the output

     rest gets processing controls from the command  line.   Rea-
     sonable  defaults  are setup.  In addition, if no input file
     name is given, the binary trace data are expected to  be  on
     the standard input.

  Command line arguments
     -N ntap
          Enter the full path of the  file  containing  the  data
          set.   If  not specified, input is expected to be stan-
          dard input.  If standard input  is  not  specified  and
          there  is  no  input,  e.g., program run in background,
          expect a termination. (default standard input )

     -O otap
          Enter the full path of the output file.  If not  speci-
          fied,   output  is  expected  to  be  standard  output.
          (default standard output )

     -ns ns
          First trace in record to process (default = 1 )

     -ne ne
          Last trace in  record to process (default = all )

     -rs irs
          First  record to process (default = 1 )

     -re ire
          Last  record to process (default = all )

     -SW iswd
          Trace header word mnemonic in which  static  is  found.
          For  statics the default is StaCor; for phase rotations
          the default is SGRNum

     -p iglob
          Pad both top and bottom of trace by  this  many  ms  to
          prevent  both  shallow  and deep data from being pushed
          off the trace.   This  padding  will  be  automatically
          removed  if  rest  is  applied  later in the processing
          using the -U (undo statics) option.  0 ms )

     -u unit
          Time  scale  factor.   Designed  to  correct  for   any
          upstream scaling applied to the times.  Default = 1.0

     -nullvalue nullvalue
          Skip traces with the null value provided (must also use
          -null).   The  module will perform no rest operation on
          traces with nullvalue in the  headerword.   The  module
          will  flag  any traces with null value as dead but will
          not zero the trace.  Default is nullvalue = -30000.

     -D   If present do a time datum operation rather than a nor-
          mal  static  shift.  Not  used  for  the phase rotation
          option.

     -t itd
          Datum time (ms) used for the datum option.  The  traces
          are  shifted  to  this  time datum from the time values
          specified  in  the  appropriate  trace   header   word.
          Default is 0ms.  Note: only integer values (in samples)
          are allowed, otherwise rounding will  occur.  Not  used
          for the phase rotation option.

     -A   If present we are dealing with scale factors.  A  value
          is  extracted  from a header word specified by the user
          (this is a floating point full header word) and applied
          (multiplied)  to  the  entire  trace  (or  unapplied  -
          divided).

     -P   If present we are dealing with phase rotations,  other-
          wise we are dealing with statics.

     -F   If present the header word static value is  a  floating
          point  word,  i.e.  it will take up two standard header
          word positions in the header  starting  with  the  slot
          defined by the user specified mnemonic. If this is used
          the user should have taken pains in the  process  which
          generated  the  static  vaues to not trash an important
          header slot. Default is a standard integer number.

     -FS  If present the time of first sample will be taked  from
          line  header slot TmMsFs and that value subtracted from
          the trace extracted times. The default assumes the time
          of first sample  is zero.

     -U   If present unapply the original trace  header  statics,
          i.e.  piping rest into another rest with -U on the com-
          mand line will result in each trace having a net static
          shift of zero

     -M dsiifR
          Enter line header sample interval override.  Default is
          to  use  the  input  line header entry.  Note that this
          entry can be a fractional value. Not used for the phase
          rotation option.

     -null
          Skip traces with the specified null  header  word  pro-
          vided by input parameter -nullvalue[].

     -C   Force all shifts to be integer  sample  values  (coarse
          mode). The nearest integer value is taken of the resul-
          tant static shift (trace  header  value  +  any  datumn
          value).  To  properly  undo a prior coarse operation of
          rest you must inclide -C on the command line  with  the
          -U flag. This option valid only for static shifts.

     -V   Verbose mode. List command line  and  lineheader  input
          parameters.

     -?   Query mode.  With this flag, rest will give a  descrip-
          tion  of  the  command line arguments and stop the pro-
          gram.

BUGS

     Unknown

SEE ALSO

     recshift, bdnmo, flatten, picker, storeit

AUTHOR

     P. R. Gutowski, Amoco TRC, Modified by James M. Gridley  10-
     96.

COPYRIGHT

     copyright 2001, Amoco Production Company
               All Rights Reserved
          an affiliate of BP America Inc.