NAME

     toast  - Terminate  Objectionable  Amplitudes  with  Spacial
     Temerity  (Dee Dee Ragusa) or Toss Out All the Stupid Traces
     (Marilyn Miller).  This module  is  designed  for  amplitude
     editing and quality control via a robust statistical nonsta-
     tionary, time and space analysis.  This program was designed
     to  find  and  flag  data  with  spacially consecutive noise
     bursting (road_kill will  not  handle  this  problem).   The
     module  will   flag  traces as dead (StaCor=30000)  and zero
     the trace if requested.

SYNOPSIS

     toast [ -Nntap ]  [  -Ootap  ]  [  -sist  ]  [  -eiend  ]  [
     -rsrecstart  ] [ -rerecend ] [ -nstrcstart ] [ -netrcend ] [
     -winwindow ] [ -nsdnumber_stadard_deviations ] [ -Z ] [  -qc
     ] [ -V ] [ -h, -? ]

DESCRIPTION

     toast uses a statistical approach on  user  defined  windows
     of data to determine a degree of commonality between a trace
     and the average over the record.  If the trace  fails to  be
     common to its average record then the trace is  flagged dead
     (30000 in StaCor) and  zeroed if requested. Trace interpola-
     tion  may be complex since it is probable that there will be
     at least some traces with adjacent dead traces so interpola-
     tion  is  NOT  done  with this module.  There is some sensi-
     tivity control with number of standard deviations  to  allow
     (degree of commonalitiy).  The data should be amplitude bal-
     anced with  at  least  a  reasonable  single   NMO  function
     applied  to the data to ensure regularization of the data in
     time and space.  The NMO function can be on the  same  order
     as  what  would be used during data interpolation as is pro-
     gram zombie.  toast allows the user  to  define  the  window
     lengths for analysis though 1000 ms seems to be most reason-
     able.

     The module can also write a standard ascii  file  of  record
     and  trace  numbers  that have been killed or repaired.  The
     output file has the input  filename  with  the  suffix  _QC.
     This  file  can  be plotted with xgraph or plotxy and viewed
     for patterns.

     toast gets both its data and  its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the analysis window, maximum number of traces away to  allow
     for  analysis,   interpolation  option, qc option(though you
     should always do this), 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'.

     -O otap
          Enter the output data  set  name  or  file  immediately
          after typing -O.  This output file is not required when
          piping the output to another process.  The output  data
          set also requires the full path name (see above).

     -s ist
          Enter the global start time (or depth) of the  replace-
          ment.  Default = trace start.

     -e iend
          Enter the global end time (or depth)  of  the  replace-
          ment.  Default = trace end.

     -rs ist
          Enter the starting  record  number.   Default  =  first
          record.

     -re iend
          Enter the ending record number.  Default = last record.

     -ns ist
          Enter the  starting  trace  number.   Default  =  first
          trace.

     -ne iend
          Enter the ending trace number.  Default = last trace.

     -win window length
          Enter the analysis widow length.  Default = 1000 ms.

     -nsd number standard deviations
          Enter the maximum allowable number of  standard  devia-
          tions  from  the  average   can  pass  as a good trace.
          Default = 1.

     -Z   Enter the command line argument  '-Z'  to  zero  traces
          which have been flagged as dead

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

DISCUSSION

     This program was designed so  that  the  user  could  do  an
     effective  amplitude  editing  and  QC  on  a trace by trace
     basis.  It takes advantage of  nonstationarity  and  spacial
     relationships  of  data  as well as time.  The best mode for
     using toast is to input data with at least an  NMO  function
     which  the  user  would  consider  accurate enough for trace
     interpolation.  The NMO with some type of amplitude  balance
     on  the  traces  regularizes the data enough so that a trace
     comparison in time and space is valid.

     With the -qc option the  user  can  get  an  ascii  file  of
     records and traces killed.  This is to provide the user with
     additional QC of this process.  A simple xgraph of the  file
     will   show   the  user  the  distribution  of  record/trace
     kills/repairs.  It is always recommended that this  be  done
     in addition to viewing the output results.

BUGS

     unknown

ALSO SEE

     skill, tfskill, zombie, bdnmo, ttothen, road_kill

AUTHOR

     James M. Gridley

COPYRIGHT

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