  1.  NAME

  stat - Statistics on arrays of data

  2.  DESCRIPTION

  This manual page describes how to use the Matlab statistical scripts
  on log files. The following functions are implemented:

     statinit(3m)
        Initializes a statistics array.

     statupd(3m)
        Updates a statistics array.

     statcalc(3m)
        Calculates statistics saved in the given statistics array.

     statlim(3m)
        Set limits for good data for the statistics.

     stat_str(3m)
        Build a formated string with content of statistic array.

     flagdata(3m)
        Mark data as bad according to the limit array.

  Although statistics on whole arrays is possible within Matlab, these
  tools allow to calculate statistics on a unlimited set of data. The
  first thing to do is to initialize the statistics array with the num-
  ber of variables. Statistics is then updated for each subset of data.
  When all data have been parsed, statitics for each variable is calcu-
  lated.  The resulting statistics array contains bf/7/ columns, and a
  line for each different variable. The meaning of the columns is the
  following:

  1. Minimum value

  2. Maximum value

  3. Index of minimum value

  4. Index of maximum value

  5. Mean value

  6. Standard deviation

  7. Number of points used

     The array with the subset of data must have the different variables
     ordered along lines, in the same order as the statistics array, the
     values along columns corresponding the different values of one
     variable. Bad values must be set to NaN.

  Optionnally, a limit array may be related to the statistics array.
  However, data outside or inside limits must be explicitely flagged as
  bad before updating the statistics array. The limit array contains 3
  columns and as many lines as there are variables. The columns have the
  following meaning:

  1. Minimum value allowed

  2. Maximum value allowed

  3. Kind of limit to apply. Possible values are

     -1 Data must lie outside intervall specified by minimal and maximal
        values.

     0  Limit is disabled.

     +1 Data must lie inside intervall specified by minimal and maximal
        values.

  3.  SEE ALSO

  flagdata(3m)stat(5m)statcalc(3m)statinit(3m)statlim(3m)stat_str(3m)statupd(3m)

  4.  AUTHORS

  Pierre Jaccard, Geophysical Institute, University of Bergen, 1999

