NAME

     ampgate  -  pass/reject  amplitude  values  lying  within  a
     min/max gate

SYNOPSIS

     ampgate [ -Nntap ] [ -Ootap ] [ -aminamin ] [ -amaxamax ]  [
     -A ] [ -A ] [ -V ] [ -? ]

DESCRIPTION

     ampgate reads traces and checks to see if each sample  falls
     within  a  gate  defined by a minimum and maximum threshold.
     Depending on  options  the  samples  are  either  passed  or
     rejected (set to zero).

     ampgate gets both its data and its parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the  gate  threshold,  absolute  or  signed  sample   check,
     pass/reject modes, 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 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).

     -amin amin
          Enter the minimum value for the  gate  threshold.  This
          could  be  either a signed or absolute value. Default =
          0.0

     -amax amax
          Enter the maximum value for the  gate  threshold.  This
          could  be  either a signed or absolute value. Default =
          0.0

     -A   Enter the command line argument '-A'  to  use  absolute
          sample values. Default is to use signed sample values.

     -P   Enter the command line argument '-P' to set all  sample
          values  falling  within  the  threshold  gate  to zero;
          default is to set all sample values falling outside the
          gate to zero.

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

EXAMPLE

     ampgate -Nidata -Oodata -amin.000001 -amax1000000. -A

     Here we set to zero all samples having absolute values  less
     than 1/million or greater that a million.

BUGS

     unknown

AUTHOR

     P. R. Gutowski, TRC, x3146

COPYRIGHT

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