NAME

     tease - TEsting the Amplitudes of SEismic, (David Tett  gets
     credit for the name)

SYNOPSIS

     getamp [ -Nntap ] [  -Pptap  ]  [  -titm  ]  [  -wiwin  ]  [
     -HWheaderwordfR  ]  [  -nsnstr  ]  [ -nenetr ] [ -rsnrst ] [
     -renred ] [ -max ] [ -min ] [ -maa ] [ -head ] [ -nb ] [  -V
     ] [ -? ]

      >  [disk file]

DESCRIPTION

     tease retrieves amplitudes at a  user  specified  time  from
     traces  in  a  seismic  data  set  or  finds the maximum (or
     minimum or maximum absolute) amplitude from  a  window  cen-
     tered  on  the specified time and then completes a  weighted
     least square analysis of the data with confidence  interval.
     This  program  is  a  step  child  of  USP  program  getamp.
     Currently a single time may be given so that  the  event  of
     interest  must  be flattened using constant refraction velo-
     city moveout (vred), normal moveout (anmo, dipnmo,  tvdnmo),
     or flattened using an oper pick file (from the seismic plot)
     and programs flatten to  write  flattening  times  into  the
     trace headers, piped into program rest to apply the flatten-
     ing times.  The user may also specify a XSD pickfile with  a
     picked event (only one per trace) and use that as the center
     of the time window.  The user may also read a time from  any
     user defined header word for the center of the time window.

     This program was designed as a  processing  quality  control
     tool  and is meant for targeted analysis.  It is recommended
     that the user apply this code to a test data set then a per-
     form  a  processing step and reapply tease (tease the data).
     This will allow the user to plot both the before  and  after
     data  and  curves for a comparison.  The output format is an
     xgraph file (or plotxy).  At  the  initial  release  of  the
     code, I have not made any effort to format the output to any
     specific type of plotting, so have at it and let me know.

     Note: the amplitude information along with  the  record  and
     trace  number  will  be  written  to standard out (it can be
     redirected to a disk file name).

     tease gets both its data and  its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the amplitude time, the start and end  traces,  and  verbose
     printout, if desired.

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing -N unless the input is from a pipe in which case
          the -N entry must be omitted.  This input  file  should
          include the complete path name if the file resides in a
          different directory.  Example -N/b/vsp/dummy tells  the
          program to look for file 'dummy' in directory '/b/vsp'.

     -P ptap
          Enter the XSD pickfile name with the  amplitude  values
          (default = no pick file).

     -t time
          Enter the time of the tracking window in ms  (must  set
          -T flag below.  The window is centered about this trace
          time, itm and the maximum (or minimum) amplitude within
          this  window  is  found.   A  message is written if the
          start or end of the window  is  picked  -  chances  are
          there's been a bust in the picking

     -w iwin
          Enter the length of the tracking window in ms (must set
          -T  flag below.  The window is centered about the above
          trace time, itm and the maximum (or minimum)  amplitude
          within  this  window is found.  A message is written if
          the start or end of the window is picked - chances  are
          there's  been  a bust in the picking.  This may also be
          used with pick files and the header word option.

     -HW hdrwrd
          Enter the trace  header  word  mnemonic  to  be  either
          listed  in the output along with the amplitude and time
          (default = none) or define the trace header  word  with
          the window time.

     -ns nstr Enter the start trace number.  The default  is  the
     first trace of the record.

     -ne netr
          Enter the end trace number. The  default  is  the  last
          trace of the record.

     -rs nrst
          Enter start record number.  Default value is the  first
          record.

     -re nred
          Enter end record number.  Default value is last record.

     -nb  Enter the command line argument '-nb' to  not  separate
          records  in the output file with a blank line, i.e. all
          entries in the output  file  will  be  one  line  after
          another.

     -max Enter the command line argument '-max' to extract  max-
          imum positive amplitudes.

     -min Enter the  command  line  argument  '-min'  to  extract
          minimum negative amplitudes.

     -maa Enter the command line argument '-maa' to extract  max-
          imum absolute amplitudes.

     -x   Enter the command  line  argument  '-x'  to  output  in
          xgraph format.

     -V   Enter the command line argument '-V' to get  additional
          printout.

     -?   Enter the command line  argument  '-?'  to  get  online
          help.   The program terminates after the help screen is
          printed.

BUGS

     unknown, please inform the USP Team if any are found.

SEE ALSO

     vred, anmo, flatten, rest, getamp

AUTHOR

     James M. Gridley, Don Adams  (now  at  Exxon)  with  special
     thanks to all the users who helped.

COPYRIGHT

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