NAME

     up_dwn_sum.x  - script to do upsum or downsum dafd panels

SYNOPSIS

     up_dwn_sum.x [ -Nntap ] [ -Ootap ] [ -dfdf ]  [  -fufu  ]  [
     -f1f1  ] [ -f2f2 ] [ -f3f3 ] [ -f4f4 ] [ -rsrs ] [ -rere ] [
     -wwn ] [ -Pprint ] [ -V ] [ -? ]

DESCRIPTION

     up_dwn_sum.x bandpass filters the data using  an  upward  or
     downward  sliding trapezoidal filter, agc the result, verti-
     cally stack the resultant with previous  cumulative  result,
     and  append  this  to  the output file.  The output file now
     consists of groups of records (one or more) each having more
     and  more  of the total whitened spectrum of the input added
     in.

     up_dwn_sum.x is in fact a script that the user can "vi".  It
     can  therefore  be copied and modified or can provide a tem-
     plate for another entirely different function.  It uses some
     interesting usp utilities: usparg and getval set up.


  Command line arguments
     -N ntap
          Enter the full path of the  file  containing  the  data
          set.  No default or pipe allowed.


     -O otap
          Enter the output file name for the filtered traces.  No
          default or pipe allowed.

     -df df
          Frequency band increment (Hz).  This is  the  frequency
          by  which  the  previous  four  corner  frequencies are
          incremented (upsum), or if negative  (downsum),  decre-
          mented.  No default.

     -fu fu
          Uppermost frequency allowed, i.e. corner  frequency  f4
          will  not  be  allowed to exceed this value.  Default =
          nyquist.  Note: if df is negative (downsum) then fu  is
          ignored.

     -f1, -f2, -f3, -f4 f1, f2, f3, f4
          Starting values (low or high end) of  the  corner  fre-
          quency  of  the trapezoidal bandpass filters.  If df is
          positive (upsum) these four values will be  incremented
          by df for each pass until the last f4 value exceeds fu.
          If df is negative (downsum) the trapezoidal corners are
          decremented until f1=0.  No defaults.

     -w wn
          Length of agc window in ms (def=500).

     -rs, -re rs, re
          Start and end sequential  record  numbers  to  be  pro-
          cessed.  Defaults are the first and last records.

     -P print
          print = 1: keep printout files; print = 0:  remove  all
          printout files

     -?   Query mode.  With this flag, up_dwn_sum.x will  give  a
          description  of the command line arguments and stop the
          program (use '-?' if you are in c-shell).

BUGS

     unknown

SEE ALSO

     sctvf, davc, stack, editt, vstak, vmult

AUTHORS

     Paul Gutowski, APR x3146

COPYRIGHT

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