File: README

package info (click to toggle)
stda 1.0-2
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 188 kB
  • ctags: 29
  • sloc: sh: 1,119; makefile: 135
file content (70 lines) | stat: -rw-r--r-- 2,711 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
--------------------------------------------------------------------------------
              Simple Tools for Data Analysis (STDA)
--------------------------------------------------------------------------------

About
=====
STDA includes some primary tools for data analysis. You can evaluate sums,
averages, integrals, histograms, and probability distribution functions of 1d
data, and eventually plot the results. The separate programs are stand-alone
tools (supporting the standard UNIX input and output pipelines) to be used 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 (http://gnuplot.info) since 'muplot' is a wrapper around it.
In summary, the package provides utilities for straightforward analysis in
situations where a complex analytical approach is not necessary 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.


Download
========
You can find the newest version of STDA at http://gnu.mirendom.net/stda.html


Installation
============
The software can be installed or uninstalled by using the script 'install.sh'
as follows:

./install.sh install
or
./install.sh uninstall

The default destination directories for the binaries and manual pages can be
overwritten by command line options. To see a short help, execute the script
without options.


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 %.6g |awk '{ print $1, sin($1) }' \
|maphimbu -d0.01 -x2 -ns1 |mintegrate -d0.01 -x1 -y3 -S |muplot lp - 1:3,4


Features
========
For new features, major changes and bug fixes see the NEWS file.


Copyright
=========
Copyright (C) 2009 Dimitar Ivanov <dimitar.ivanov@mirendom.net>

This is free software; You can redistribute it and/or modify it under the
terms of the GNU General Public License, Version 3 or later. For the full
text of the licence see the LICENCE file.