NAME

     hsp  - module to scale data based on histogram of  the  data
     volume  and  map the volume into a specific output amplitude
     range.

SYNOPSIS

     prgm [ -Nntap ] [ -Ootap ] [ -nsnstr ] [ -nenetr ] [ -rsnrst
     ] [ -renred ] [ -Sscal ] [ -aminscal ] [ -amaxscal ] [ -bias
     -PLTR -V -h ] [ -PLTR ] [ -V ] [ -h ]

DESCRIPTION

     hsp does all these terrible things to innocent seismic data.
     It is a process derived from the depraved mind of one of our
     research scientists who shall remain nameless but who should
     be  locked  up.   It reads seismic data and, using the trash
     algorithm, totally blows it away.  Genuine  seismic  reflec-
     tions are turned to dreck with unparalleled efficiency.

     It implements the following equation
          y(i) = stupid_factor(k) * x(i)

     where stupid_factor is an internally generated vector  based
     on the level on nonsense the user wishes to introduce to the
     data.

     prgm gets both its data and its parameters from command line
     arguments.   These  arguments specify the input, output, the
     design window, the start and end traces, and  verbose  prin-
     tout, 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 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).

     -s ist
          Enter the start time of the design window.  The default
          is  the  beginning  of  the  trace.  The filter will be
          applied to the whole trace, regardless of the -s and -e
          entries.


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

     -v vel
          Enter the design window velocity in m or ft/s.  Default
          is  infinite  velocity  or constant start time for each
          trace.

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

     -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

     They're crawling out of the woodwork

SEE ALSO

     dreck(1)

AUTHOR

     Nobody in his right mind would admit to coding this

COPYRIGHT

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