NAME

     square - convert data to square waves

SYNOPSIS

     square [ -Nntap ] [ -Ootap ] [ -vvtap ] [ -rsirs ] [  -reire
     ] [ -rms ] [ -area ] [ -stretch ] [ -V ] [ -? ] [ -h ]

DESCRIPTION

     SQUARE scans each input trace for zero crossings and outputs
     a  trace  containing  constant values (square waves) between
     the identified zero crossings.  The constant  amplitude  can
     be the maximum value between zero crossings, the RMS average
     of all values between the zero crossings, or the area  under
     the lobe.

     The amplitudes may optionally be corrected for NMO  stretch,
     in  which case the stacking velocity field must be supplied.
     If the correction is requested, it is applied BEFORE  selec-
     tion of amplitudes for the square wave output.

     Square gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input and out-
     put data set names,  the  beginning  and  ending  sequential
     record numbers for processing, and the RMS average flag.

  Command line arguments
     -Nntap
          Enter the input data set name or file immediately after
          typing  -N;  entering  nothing  specifies a stdin pipe.
          This input put file should include  the  complete  path
          name  if the file resides in a directory other than the
          one  from  which  you  start  the  program.    Example:
          -N/work_area/dummy  tells  the program to look for file
          "dummy" in directory "work_area".

     -vvtap
          Enter the velocity data set name immediately after typ-
          ing  -v;  entering nothing specifies a stdin pipe. This
          input put file should include the complete path name if
          the file resides in a directory other than the one from
          which    you    start    the     program.      Example:
          -N/work_area/dummy  tells  the program to look for file
          "dummy" in directory "work_area".   This  data  set  is
          used  ONLY  IF THE STRETCH option is requested.  Other-
          wise, it is ignored.  However, if the stretch option is
          requested, this data set is REQUIRED.

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

     -rs irs
          (integer) First (sequential) record  to  process.   All
          records  prior  to this one are skipped and not written
          to the output data set. Default = 1 (the first).

     -re ire
          (integer) Last (sequential)  record  to  process.   All
          records  after  this are ignored and not written to the
          output data set. Default = process all.

     -rms Enter the command line argument '-rms' to request  that
          the  amplitude  within  each square wave be computed as
          the RMS average of all values  between  the  identified
          zero crossings.  Default = No.

     -area
          Enter the command line argument '-area' to request that
          the  amplitude  within  each square wave be computed as
          the  area  between  the  identified   zero   crossings.
          Default = No.

     -stretch
          Enter the command line argument '-stretch'  to  request
          that the amplitude within each input CDP be compensated
          for NMO stretch.  If  this  option  is  requested,  the
          velocity file must be specified.  Default = No.

     -V   Enter the command line argument '-V' to get  additional
          printout.

     -?   Enter this (or '-?' if you are running in  c-shell)  to
          get  online  help.   The  program  will terminate after
          printing this.

     -h   Enter this to get online help.  The program  will  ter-
          minate after printing this.

BUGS

     Unknown

AUTHOR

     Richard Crider, Houston x7070

COPYRIGHT

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