NAME

     vmult  - vertically multiply/divide data sets

SYNOPSIS

     vmult [ -N1ntap1 ] [ -N2ntap2 ] [ -Ootap ] [ -ampampfR  ]  [
     -enetr  ]  [  -snrst ] [ -nsnstr ] [ -nenetr ] [ -rsnrst ] [
     -renred ] [ -D ] [ -R ] [ -RR ] [ -V ] [ -? ]

DESCRIPTION

     vmult weights and vertically multiplies or divides  portions
     of  2  input data sets.  Note: input N2 cannot be pipelined!
     Also it is assumed that N1 is the primary data set and  that
     N2  either  has the same # traces and # records as N1, or it
     hash the same number of single trace records, or  it  has  a
     single  record  with the same # traces as each record of N1,
     or it has a single one trace record

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

  Command line arguments
     -N1,2 ntap1,2
          Enter the input data set name or file immediately after
          typing  -N1  (or -N2).  Only N1 may be pipelined.  This
          input file should include the complete path name if the
          file   resides   in  a  different  directory.   Example
          -N1/vsp/dummy  tells  the  program  to  look  for  file
          'dummy'  in  directory  'vsp'.   Note: if one wishes to
          operate on a data set with a single trace (like a  gain
          curve) then N2 must be the single trace data set.

     -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).

     -amp amp
          Enter the global multiplier for data set 2, i.e.  every
          sample  in  the  second  data set will be multiplied by
          this factor before other operations. Default = 1.0

     -s ist
          Enter the start time (ms).  The default is  the  begin-
          ning of the trace.

     -e iend
          Enter the end time (ms).  The default is the end of the
          trace.

     -ns nstr
          Enter the start trace number.  Trace numbers below this
          value  will  not be processed.  The default is 1.  Note
          the the trace limiting only applies to N2 if the 2 data
          sets are of the same size).

     -ne netr
          Enter the end trace number.  Trace numbers  above  this
          value  will  not be processed.  The default is the last
          trace number on the input data set.

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

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

     -D   Enter the command line argument '-D'  to  divide  N1/N2
          instead of multiply.

     -R   Enter the command line argument '-R' to take the square
          root of the product or division.

     -RR  Enter the command  line  argument  '-RR'  to  take  the
          signed  square  root  of  the product or division.  The
          absolute value is taken before the square root function
          is applied.

     -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.

COPYRIGHT

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