NAME

     shape2  - shape records to selected portion of a trace

SYNOPSIS

     shape2 [ -Nntap ] [ -Ootap ] [ -Mmtap ] [ -sist ] [ -eied  ]
     [  -vvel ] [ -msmst ] [ -memend ] [ -nntrace ] [ -llfilt ] [
     -tpct ] [ -pprew ] [ -renred ] [ -J ] [ -S ] [ -F ] [  -zero
     ] [ -V ] [ -? ]

DESCRIPTION

     shape2 takes a portion of a selected trace  within  a  model
     seismic  record, calculates shaping filters which will shape
     the input traces to the model then applies the filter to the
     input  data  and  outputs  the  results  or, optionally, the
     filter itself.

     The model trace is computed several ways:

     1. a specified trace is extracted  from  the  model  seismic
     data  set.   The same filter is applied to all input gathers
     of the input data set

     2. a specified trace is extracted from each  record  of  the
     model  data set.  A different filter is computed and applied
     to each gather of the input data set.

     3. a specified gather is extracted from the model  data  set
     and  stacked  to  for  the  model trace.  The same filter is
     applied to all input gathers of the input data set

     4. each gather from the model data set  is  stacked  to  for
     model traces.  A different filter is computed and applied to
     each gather of the input data set.

     shape2 gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the design window,  the  taper,  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).

     -M mtap
          Enter the optional model trace data set  (necessity  of
          this is dependent on the modeling method chosen).

     -s ist
          Enter the start time of the input  data  design  window
          (ms).   The default is the beginning of the trace.  The
          filter will be applied to the whole  trace,  regardless
          of the -s and -e entries.

     -e ied
          Enter the end time of  the  input  data  design  window
          (ms).  The default is the end of the trace.

     -v vel
          Enter the velocity to alter the input data  set  design
          window.   This  assumes  trace  distances  are correct.
          Default is a flat window.

     -ms mst
          Enter the start time of the model  trace  window  (ms).
          Default is start of the model trace.

     -me mend
          Enter the end time of  the  model  trace  window  (ms).
          Default is end of the model trace.

     -n ntrace
          Enter the selected trace within the current  record  to
          use  as  the  desired  output.  No default.  If this is
          defaulted the stack of the  model  gather  becomes  the
          model trace.

     -l lfilt
          Enter the length of the shaping filter.  Default is 1/2
          the design window length.

     -t pct
          Enter the percent taper  of  the  design  window  (each
          side).  50% means the window is completely tapered both
          sides.  Default is 0%

     -p prew
          Enter the percent prewhitening  in  the  least  squares
          calculation.  Default is .1%

     -J   Enter the command line argument '-J' to  use  only  one
          model trace (stacked or not) for the whole data set


     -F   Enter the command line argument '-F' to output only the
          filter (it can be applied later using cross).

     -S   Enter the command line argument '-S'  to  use  a  model
          trace generated by a stack of a gather.  Otherwise mode
          trace is one trace from a gather

     -zero
          Enter the command line argument -zero  if  you  suspect
          dead  traces in the model dataset and you can live with
          a dead operator or output trace.  Without this flag the
          routine will abort if a dead model trace is detected.

     -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

     So far if the stack  option  is  chosen  the  model  records
     should have some sort of moveout applied.

AUTHOR

     Paul Gutowski, TRCVM(ZPRG03) or zprg03@trc.amoco.com

COPYRIGHT

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