NAME

     ampspec - produces a summed amplitude spectra

SYNOPSIS

     ampspec [ -Nntap ] [ -Ootap ] [ -sist ] [ -eiend ] [ -nsnstr
     ]  [ -nenetr ] [ -rsnrst ] [ -renred ] [ -P ] [ -db ] [ -X ]
     [ -V ] [ -? ]

DESCRIPTION

     ampspec implements the MathAdvantage forward FFT and outputs
     a  summed  amplitude  spectra  for  frequency analysis.  The
     input data is in SIS format and the output is an ascii  file
     of  frequencty and amplitude.  Optionally, the amplitude can
     be normalized, plotted  in  db  down  and  the  program  can
     automatically plot the output.

     ampspec gets both its data and its parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the start and end traces, type  of  output  [normalized,  db
     down, automatic xgraph] 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 in ascii format
          of frequency and summed amplitude.  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.

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

     -P   Enter the command line argument '-P' to  output  ampli-
          tude that is normalzed to 1. The spectra of the indivi-
          dual traces going into the sum are themselves not  nor-
          malized, only the final sum itself.

     -db  Enter the command line argument '-db' to output  ampli-
          tude  spectral  in  db  down.   In this case the output
          amplitude is simply 10 times the log [base 10]  of  the
          ratio  of  each  amplitude  value to the maximum in the
          spectrum.

     -X   Enter the command line argument '-X'  to  automatically
          graph the output.

     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

     none to date

AUTHOR

     James M. Gridley, x3842,  ATTC,  general  clean  up  and  db
     option --> Garossino [x3615 Houston ;-( ]