num-utils is Copyright 2002-2003 Suso Banderas
====================----------------------------
**PLEASE ALSO READ THE WARNING FILE THAT**
**COMES WITH THIS PROGRAM.**
Description - num-utils are a set of utilities that aim to provide
the numeric equivilent of the GNU text-utils. These programs do
operations on numbers such as filtering, adding, averaging and so on.
They help expand and complete the shell vocabulary.
Right now these programs are in the beta stage. If you have any bug
fixes or suggestions to improve this program, please see the "Contact"
section of this document . An extensive list of planned features is
in the 'GOALS' file included with this program.
Installation
------------
For now please use the Makefile to install the programs. By default
this will install them in /usr/bin. Standard 'make' and 'make install'
commands will build and install the programs. You can also make an RPM
source and binary package from the Makefile using 'make rpm'.
How to use
----------
These programs are useful when you want to deal with numbers on stdin or
from files. There are different programs for different functions:
numsum - Adding a set of numbers from stdin is simply a matter of passing
just the numbers themselves to numsum.
$ cat test/numbers | numsum
21937.74
$
You can use other programs like numgrep, awk or sed to get just the numbers
that you want from a file:
$ cat access_log | awk {'print $10'} | numsum
numgrep - Simular to grep, but specific to numbers. This program will let
you search for ranges of numbers and sequences.
$ numgrep /-5..5,100..200/ tests/numbers
5
135
135
1
1.5
4.5351
3
3
-1
-2.543
-1
3
random - Generates random numbers based on range expressions.
$ randnum /0..100/
47
$
range - This program will spit out a sequence of numbers for use in stuff
like shell for loops. The syntax for this program will most likely
change in the next version.
$ range /5..10/
5 6 7 8 9 10
$
$ for i in `range /1..5,10..15/` ; do mv track$i.mp3 song$i.mp3 ; done
1
2
3
4
5
10
11
12
13
14
15
$
interval - This program will calculate and display the interval between
every two seqeuntial numbers on the input stream:
$ cat numbers
1
2
3
5
10
45
35
2
1
$ cat numbers | interval
1
1
2
5
35
-10
-33
-1
$
Contact
-------
Please send bug reports, suggestions, requests or correspondence to Suso Banderas
at 'suso@suso.org'. You can visit the homepage for this program at:
http://suso.suso.org/programs/num-utils/