NAME

     windstat  - calculates amplitude statistics within a  verti-
     cal window.


SYNOPSIS

     windstat [ -Nfile_in ] [ -Ofile_out ] [ -rsstart_record ]  [
     -reend_record  ]  [  -nsstart_trace  ]  [  -neend_trace  ] [
     -sstart_time ] [ -eend_time ] [ -uhupper_horizon_header_word
     ] [ -lhlower_horizon_header_word ] [ -uwupper_horizon_offset
     ] [ -lwlower_horizon_offset  ]  [  -decode  ]  [  -all  ]  [
     -AVAfilename   ]   [  -AAAfilename  ]  [  -LPVfilename  ]  [
     -LNVfilename  ]  [  -APVfilename  ]  [  -ANVfilename   ]   [
     -A36filename  ]  [  -A18filename  ] [ -PMfilename ]  [ -AAD-
     filename ] [ -SADfilename ] [ -ESSfilename ] [  -TLPfilename
     ]  [  -TLNfilename  ]  [  -P12filename  ] [ -P13filename ] [
     -SAVfilename  ]  [  -DAVfilename  ]  [  -LADfilename   ]   [
     -LTDfilename   ]   [  -SDfilename  ]   [  -SDPfilename  ]  [
     -SDNfilename  ]  [  -SDAfilename  ]  [  -MEDfilename   ]   [
     -MDPfilename   ]   [  -MDNfilename  ]  [  -MDAfilename  ]  [
     -MAAfilename ] [ -MTAfilename ] [ -ssam ] [ -V ] [ -? ]


DESCRIPTION

     windstat computes selected reductions for each trace in  the
     dataset.

     windstat gets all its parameters  from  command  line  argu-
     ments.  These arguments specify the input, output, start/end
     record/trace/sample and what reduction(s) to compute.

     -N file_in
          Enter the input data set name or file immediately after
          typing -N.  This input file should include the complete
          path name if the file resides in a different directory.
          Example  -N/export/data2/san_juan/taup_file  tells  the
          program to  look  for  file  'taup_file'  in  directory
          '/export/data2/san_juan'.

     -O file_out
          Enter the output multi-reduction data set name or  file
          immediately  after typing -O. Reductions will be output
          as subsequent samples within the same trace,  with  the
          average  first  (if  -AVA  is  entered), the average of
          absolute values second (if -AAA is entered), etc.  This
          output file name is not required when piping the output
          to another process.

     -rs rs
          Enter the desired starting record number.  If no entry,
          program assumes first record in data set.

     -re re
          Enter the desired final record number.   If  no  entry,
          program assumes last record in data set.

     -ns ns
          Enter the desired starting trace number.  If no  entry,
          program assumes first trace in each record.

     -ne ne
          Enter the desired final trace  number.   If  no  entry,
          program assumes last trace in each record.

     -s s Enter the start time for analysis. The default  is  the
          beginning  of  the trace. This parameter will be disre-
          garded if -uh is supplied.

     -e e Enter the end time for analysis. The default is the end
          of the trace. This parameter will be disregarded if -lh
          is supplied.

     -uh uh
          Trace header word mnemonic in which the start time  for
          analysis is found.

     -uw uw
          Offset in units of the data from the upper horizon [-uh
          above].  The default is 0.0.

     -lh lh
          Trace header word mnemonic in which the  end  time  for
          analysis is found.

     -lw uw
          Offset in units of the data from the lower horizon [-lh
          above].  The default is 0.0.

     -all Calculate all statistics.  For each  trace,  store  all
          statistics  (one  per sample) in the output trace.  See
          the -decode option for information on how to tell  what
          sample goes with what statistic.

     -decode
          Once you have generated a multi-statistic file, you can
          use  this  option  to tell which sample goes with which
          statistic.  Use the previously generated windstat  out-
          put  multiple  statistic file as input, as in "windstat
          -Nprev.out -decode".  A list of statistics  and  sample
          numbers will be printed.

     -XXX filename
          Enter the option followed by the file  name  to  output
          this  statistic  to a separate file.  Note that statis-
          tics will be output to  a  file  with  one  sample  per
          trace.   If  the  option  is entered with no file name,
          this statistic will be directed to  the  file  or  pipe
          defined by the -O option above.

     The following describes the available statistics:

     average (-AVA)

     average of absolute values (-AAA)

     largest positive (> 0) value (-LPV)

     largest negative (< 0) value (-LNV)

     average of positive (> 0) values (-APV)

     average of negative (< 0) values (-ANV)

     angle of phase vector sum; +360 if negative (-A36)

     angle of phase vector sum; +180 (-A18)

     phase magnitude (-PM)

     average of absolute sample to sample difference (-AAD)

     sum of absolute sample to sample difference (-SAD)

     energy, sum  of sample*sample (-ESS)

     time of largest positive (> 0) value (-TLP)

     time of largest negative (< 0) value (-TLN)

     -TLP with parabola fit (-P12)

     -TLN with parabola fit (-P13)

     sum of absolute values (-SAV)

     decay of absolute values (-DAV)

     largest peak/trough amplitude difference (-LAD)

     largest peak/trough time difference (-LTD)

     standard deviation (-SD)

     standard deviation of positive (> 0) values (-SDP)

     standard deviation of negative (< 0) values (-SDN)


     standard deviation of absolute values (-SDA)

     median (-MED)

     median of positive (> 0) values (-MDP)

     median of negative (< 0) values (-MDN)

     median of absolute values (-MDA)

     maximum of absolute values (-MAA)

     time of maximum of absolute values (-MTA)

     -ssam
          Enter the command line argument '-ssam' to  get  execu-
          tion status echoed to stderr during the run.

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


See Also:

     semb3d, asig, asig1d, asig3d, XIKP, lm3dvtosis, sistolm3dv



AUTHOR

     Kelly D. Crawford (E&PTG, Tulsa, OK, USA) Built mostly on an
     earlier  work (program asig3d - Kurt Marfurt) and input from
     Steve Farmer and Greg Partyka.


COPYRIGHT

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















Man(1) output converted with man2html