NAME

     rost  - module to stack traces in each input record to  form
     one  output  trace  using  one of several nonlinear stacking
     algorithms

SYNOPSIS

     rost  [ -Nntap ]  [ -Ootap ]  [ -Cparmfile ]  [ -Llistfile ]
     [ -R ] [ -V ] [ -H ] [ -? ] [ -algalgorithm ]
     [ -foldfold ] [ -rngrange ] [ -rec0nrec0 ] [ -otrtrprec ]

DESCRIPTION

     rost will combine all traces within  each  input  record  to
     make  a  single  composite  trace  for  that record.  One of
     several  nonlinear  algorithms,  including   median,   alpha
     trimmed  mean,  and  range trimmed mean, can be used to gen-
     erate the composite trace.

     rost will process all selected input records, producing  one
     output trace from each input record.

  Command line arguments
     -N ntap
          Enter the full path name of the file containing the in-
          put  data  set.  If not specified, input is expected to
          be on the standard input. The program will give an  er-
          ror message if the input file is read protected.  If no
          input file is given, and there is  no  standard  input,
          the program will hang.  (default is standard input )

     -O otap
          Enter the full path name for the output file.   If  not
          specified,  the  output will be written to the standard
          output. The program will give an error message  if  the
          output  file  is being written to a directory which has
          write protection.  (default is standard output )

     -C parmfile
          File from which processing parameters algorithm,  fold,
          range,  nrec0,  and trprec are to be read if not expli-
          citly included in the command line.  An  error  message
          will  be  issued  if parmfile does not exist.  If -C is
          present on the command line with no  argument,  parame-
          ters are assumed to be in-line in the job script marked
          with  the  flag  -rost.crd.   By  using   this   method
          (described in the STARTJOB section of this manual), the
          user is allowed to specify the rost parameters  in-line
          with  the  processing  sequence.   If  flag  -C  is not
          present on the command line, the parameters  algorithm,
          fold, range, nrec0, and trprec are explicitly read from
          the command line.  The parameter card for rost is:

               Column          Variable
                  1-5          card number and name
                 6-10          algorithm
                11-15          fold
                16-20          range
                21-25          nrec0
                26-30          trprec


     -L listfile
          File to which the run time listing (i.e.,  sysout)  for
          this  program  is sent.  If option -L is present on the
          command line with no argument, the name of the file  to
          receive the run time information is generated automati-
          cally as ROST.XXX.YYY where XXX  and  YYY  are  derived
          from  the  least  signficant digits of the process i.d.
          (PID) and parent process i.d. (PPID) of  this  process.
          If  option -L is not specified on the command line, the
          name of the file to receive the run time information is
          generated  automatically  as RO.XXXXX.YYYYY where XXXXX
          and YYYYY are derived from the process i.d.  (PID)  and
          parent process i.d. (PPID) of this job.  This is compa-
          tible  with  the  naming  convention  required  by  the
          STARTJOB  system,  so to use that system the -L flag is
          not used.

     -V   Verbose mode.  Detailed information about processing is
          sent to the output listing device.

     -?  or -H
          Query mode.  With this flag, rost will send a  descrip-
          tion  of the command line arguments to the standard er-
          ror output and stop.

     -alg algorithm
          Algorithm to be used to perform the stacking operation:
          1)  median
          2)  alpha trimmed mean
          3)  range trimmed mean
          4)  asymmetric range trimmed mean.
          (default = 1 )

     -fold fold
          The fold of the input data to be stacked.   (default  =
          number of traces in input record )

     -rng range
          Trim range for trimmed mean algorithms,  in  per  cent.
          In the alpha trimmed mean algorithm, 100% is equivalent
          to averaging (normal stacking) and 0% is equivalent  to
          the median stack.  (default = 0 )


     -rec0 nrec0
          This is the number to be assigned to the  first  record
          in  the  output.  The record number is incremented by 1
          for records after the first.  If nrec0 = -1,  then  the
          DI  (depth  index) of the first input record is used as
          the first output record number.  (default = 1 )

     -otr trprec
          Number of traces per output record.  (default = 1 ) PP

     -R   If present put  out  a  single  record,  with  multiple
          traces  (for  MBS velocity build ing). (Not designed to
          work with -otr option).

BUGS

     No trap for running program without an input file and  noth-
     ing in the standard input.

SEE ALSO

     stack(n)

AUTHOR

     W. J. Done (1987)

COPYRIGHT

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