NAME

     scanvol - Univariate statistical analysis of  amplitudes  in
     3D  volumes  prior to 8 bit voxel conversion and interpreta-
     tion.

SYNOPSIS

     scanvol [ -Nntap ] [ -Ootap ] [ -GTogt ] [ -GPogp ] [  -nsns
     ] [ -nene ] [ -T0nincr ] [ -rsirs ] [ -reire ] [ -R0irincr ]
     [ -sist ] [ -eiend ] [ -S0isincr ] [ -bibin ] [ -V ] [ -? ]

DESCRIPTION

     scanvol Useful for univariate statistical analysis of ampli-
     tudes  in  3D  volumes  prior  to  8bit voxel conversion and
     interpretation.

     Scanvol produces two xgraph files ready for graphing and one
     flat  file.  One xgraph file gives a histogram of each indi-
     vidual record as well as  the  entire  dataset.   The  other
     xgraph  file  give a histogram of just the peaks and troughs
     for each record and the entire dataset.  The flat  file  has
     statistics   for  both  cases.   Statistics  include:  mean,
     median, min, max, mode, variance, standard deviation,  coef-
     ficient  of  variation,  coefficient  of  skewness  and  1st
     through 9th deciles. Other  statistics  can  be  added  upon
     request.

     Scanvol gets both its data and its parameters  from  command
     line arguments.  These arguments specify the input, outputs,
     the start and end traces, the start  and  end  records,  and
     verbose.

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing  -N  (can  be  piped).   This  input file should
          include the complete path name if the file resides in a
          different  directory.   Example  -N/vsp/dummy tells the
          program to look for file 'dummy' in directory 'vsp'.

     -O otap
          Enter the output data  set  name  or  file  immediately
          after  typing -O.  This will be the ascii file with the
          statistics as described above.  It  can  optionally  be
          piped into xcat.  Default is 'ntap.stat'.

     -GT ogt
          Enter the output data set name for xgraph file of  fre-
          quency   histogram   of   all   samples.    Default  is
          'ntap.Txy'.

     -GP ogp
          Enter the output data  set  name  for  xgraph  file  of
          frequency histogram of peak/trough samples.  Default is
          'ntap.Pxy'.

     -ns ns
          Enter the processing start trace number.  Trace numbers
          below this value will not be processed.  The default is
          1.

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

     -T0 nincr
          Enter the trace increment.  Default = 1.

     -rs irs
          Enter processing start record number.   Record  numbers
          below  this value will not be processed.  Default value
          is the first record.

     -re ire
          Enter processing end  record  number.   Record  numbers
          above  this value will not be processed.  Default value
          is last record.

     -R0 irincr
          Enter the record increment.  Default = (re - rs)  /  20
          or 1 if (re - rs) less than 20.

     -s ist
          Enter the start time.  The default is 0 units.   Beware
          that this routine does NOT look at TmMsFS from the line
          header.  It assumes that sample one is time zero.

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

     -S0 sdel
          Output every sdel samples starting at  time  ist.   The
          default is 1.

     -b ibin
          Enter the number of bins  in  the  histogram  analyses.
          Default = 255.

     -V   Enter the command line argument '-V' to get  additional
          printout.

     -?   Enter this (or '-?' if you are running in  c-shell)  to
          get  online  help.   The  program  will terminate after
          printing this.

BUGS

     unknown

AUTHOR

     Jacquie Vinson per request of Doug Whitman


     Proprietary - for the exclusive use of Amoco Production Com-
     pany and other wholly owned subsidiaries of Amoco Production

COPYRIGHT

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