NAME

     saneusp  - compute signal and noise estimates

SYNOPSIS

     saneusp [ -Nntap ] [ -Ootap ]  [  -Wwtap  ]  [  -Sstap  ]  [
     -mllags  ] [ -ngngrp ] [ -gsgates ] [ -glgatel ] [ -nsnstr ]
     [ -nenetr ]  [  -rsnrst  ]  [  -renred  ]  [  -titaper  ]  [
     -lfdlfdrop  ] [ -lftlfthresh ] [ -T ] [ -noise ] [ -mindelay
     ] [ -V ] [ -? ]

DESCRIPTION

     saneusp computes the signal and noise estimates for a window
     on  each  record  input.  The heart of the method is a cross
     spectral calculation followed by a signal  to  noise  ration
     detection.

     saneusp gets both its data and its parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the desired number of lags, the start and  end  traces,  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 wavelet data set name or file  immedi-
          ately after typing -O. There will be one wavelet output
          per input record.  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).

     -W wtap
          Enter the optional output wavelets  in  xgraph  format.
          The file also contains a header with some useful infor-
          mation. To display run usp xgraph [file name]

     -S stap
          Enter the optional output noise and signal  spectra  in
          xgraph  format.  The  file  also contains a header with
          some useful information.  To  display  run  usp  xgraph
          [file name]

     -ml lags
          Enter the maximum number of lags (one sided) in  ms  to
          use  in  the  computations.  Default  is  half the gate
          length.

     -ng ngrp
          Enter the number  of  traces  to  use  in  the  rolling
          buffer.  This  buffer is rolled through each record and
          is used in the runsum  portions  of  the  calculations.
          Default = 4

     -gs gates
          Enter the start time of the window. Default is 0ms.

     -gl gatel
          Enter the length (ms) of the  window.  Default  is  the
          entire trace.

     -t itaper
          Enter the number of samples to pad the beginning of the
          window  to reduce the effects of the convolution of the
          prewhitening filter. Default = 10

     -lfd lfdrop
          Enter  the  db/octave  dropoff  in  the  minimum  delay
          wavelet calculation. Default = 0

     -lft lfthresh
          Enter the frequency below which  the  dropoff  applies.
          Default = 8Hz

     -ns nstr
          Enter the start trace number.  The default is the first
          trace of the record.

     -ne netr
          Enter the end trace number. The  default  is  the  last
          trace of the record.

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

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

     -T   Enter the command line argument '-T' to use the Thomson
          cross spectral calculation, otherwise the Papoulis cal-
          culation is used.

     -noise
          Enter the command line argument '-noise' to compute the
          noise wavelets, otherwise signal wavelets are computed.

     -mindelay
          Enter the command line argument '-mindelay' to  compute
          the  minimum  delay  wavelet,  otherwise the zero phase
          wavelet will be computed.

     -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

     unknown

AUTHOR

     Sue Raikes,  Terry  Redshaw  (Sunbury),  USP  version:  Paul
     Gutowski (UTG New Orleans)

COPYRIGHT

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