numprocess(1)
NAME
numprocess - This program mutates numbers as it encounters them.
SYNOPSIS
numprocess [-dhV] /<expression>/ [FILE or STDIN] | numprocess [-dhV] /<expression>/ (Input on STDIN from pipeline.) numprocess [-dhV] /<expression>/ (Input on STDIN. Use Ctrl-D to stop.)
DESCRIPTION
numprocess will take as one argument, a list of operations to be performed on numbers that it encounters. It will perform those operations
on each number and return the result in place of the original number.
USAGE EXAMPLES
- Add 1 to all numbers.
- $ numprocess /+1/ file1
- Convert all numbers from miles to kilometers. Multiply by 8 and divide by 5.
$ cat file1 | numprocess /*8,%5/- Convert from celcius to fahreheit degrees. Multiply by 9, divide by 5 and add 32.
$ numprocess /*9,%5,+32/ temperatures- Find the area of each circle from the given radius.
$ numprocess /^2,*pi/ radii
KEYWORDS AND OPERATORS
For operators, the modifying number goes directly after the operator, with
the exception of functions like sqrt, sin, cos, etc.
+ Addition
- Subtraction
* Multiplication
% Division
^ Power function
sqrt Square Root (*)
sin Sine function
cos Cosine function
- Constants and keywords that can be used
- pi 3.141592654
e 2.718281828 - (*) When using the sqrt operation on negative numbers, it will take the
- absolute value of the number, sqrt it and then tack an i on the end of the result to signify that the resulting number is imaginary.
OPTIONS
-h Help: You're looking at it.
-V Increase verbosity.
-d Debug mode. For developers
SEE ALSO
numaverage(1), numbound(1), numinterval(1), numnormalize(1), numgrep(1), numsum(1), numrandom(1), numrange(1), numround(1)
BUGS
There is currently no way to take the number found in the text stream
and use it as the numerator instead of the denominator of a division
operation.
COPYRIGHT
- numprocess is part of the num-utils package, which is copyrighted by
Suso Banderas and released under the GPL license. Please read the
COPYING and LICENSE files that came with the num-utils package - Developers can read the GOALS file and contact me about providing
- submitions or help for the project.
MORE INFO
More info on numprocess can be found at:
- http://suso.suso.org/programs/num-utils/