NAME

       stda -  Simple Tools for Data Analysis (STDA)

DESCRIPTION

       STDA  includes  some  primary  tools  for  data  analysis.  You  can  evaluate sums, averages, integrals,
       derivatives, histograms or probability distribution functions  of  1-d  data,  and  eventually  plot  the
       results.  The  programs  are  stand-alone tools (supporting the standard UNIX input and output pipelines)
       intended for data processing from the command line. It should be noted that all but one  of  the  scripts
       use  awk  and  core  system utilities. For plotting you have to install Gnuplot (see http://gnuplot.info)
       since 'muplot' is a wrapper around it. In summary, the package  provides  utilities  for  straightforward
       analysis of data series where a complex analytical approach is not needed and where an ultimate numerical
       precision with floating-point numbers is not critical. Some general examples of application cases include
       evaluating  usage statistics from server logfiles, determining a response time distribution from a series
       of queries to a [remote] service, producing a plot from multiple data files, etc.

       This software should be considered as an open  project  to  be  extended  with  new  command-line  driven
       utilities  helpful  for  performing  common  data  analysis  tasks. Any contributions and suggestions are
       welcome.

       Following programs are included in the distribution:

       * maphimbu   - histogram builder for 1-d numerical and text data

       * mintegrate - average/sum/integral/derivative of 1-d numerical data

       * mmval      - find minimum and maximum value in a dataset

       * muplot     - plot a multi-curve figure from multiple dataset using Gnuplot

       * nnum       - produce a series of equally separated integers or floats

       * prefield   - prepare input file for 'muplot' to plot 2-d fields by arrows

EXAMPLES

       - Evaluate the  current  apache2  logfile  and  make  an  unique  list  of  the  hostnames  (respectively
       ip-addresses) sorted by the total number of their http requests:

              maphimbu -rs2 /var/log/apache2/access.log

       -  On  a  X terminal plot the probability function and the cumulative distribution function of a 'sin(x)'
       data sample:

              nnum -3.14159 3.14159 0.00001 "sin(x)" "%.17f %.7f" | maphimbu -d0.01 -x1 -ns1 | mintegrate -d0.01
              -x1 -y3 -S | muplot lp - 1:3,4

COPYRIGHT

       Copyright © 2009, 2011-2014 Dimitar Ivanov <dimitar.ivanov@mirendom.net>

       License: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to  the  extent
       permitted by law.

stda 1.3.1                                         August 2014                                           STDA(1)