NAME

     uspstats - Barf out statistics of dataset samples
                with optional standard deviation volume.

SYNOPSIS

     uspstats [ -N ntap -O otap
                -1s i1s -1e i1e -2s i2s -2e i2e -3s i3s -3e i3e
                -emask emask -stdev -V ]

DESCRIPTION

     uspstats reports statistics for a USP dataset and optionally
     writes  a  volume  of  the  number of standard deviations an
     input point is from the mean. i/o and  process  control  are
     taken  from  command  line  arguments.  The  optional output
     requires a second pass over the data and can only be written
     if the input is available on disk.

ARGUMENTS AND OPTIONS

     -N ntap [default: ntap=stdin:]
          Enter the input data set name immediately after  typing
          -N.

     -O otap [default: no output]
          The  name  for  an  output  standard  deviation  volume
          (optional).  To pipe out to another process, use -stdev
          without -O. (This is not available if the  input  is  a
          pipe.)

     -1s i1s,  -1e i1e [default: i1s=1, i1e=NumSmp]
          The starting and ending indices of samples  to  analyze
          on axis 1 (samples).

     -2s i2s,  -2e i2e [default: i2s=1, i2e=NumTrc]
          The starting and ending indices of samples  to  analyze
          on axis 2 (traces).

     -3s i3s,  -3e i3e [default: i3s=1, i3e=NumRec]
          The starting and ending indices of samples  to  analyze
          on axis 3 (records).

-re for sample, trace and record limits, the command line is

also parsed for these.
     For those whose fingers will only type -s, -e, -ns, -ne, -rs, and

     -emask emask [default: emask=-1e+37]
          An embedded mask. Samples with this value are not accu-
          mulated for statistics.

     -stdev [default: .FALSE.]
          Use -stdev to create an output to a pipe (e.g. when  -O
          is absent).

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

BUGS

     None known.

AUTHOR

     M.J. O'Brien - Allied Geophysics, Inc.

COPYRIGHTS

     Copyright  2001,  Allied  Geophysics,   Inc.    All   Rights
     Reserved.

     Portions of this application are also protected as follows:

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