SYNOPSIS

numsum [-iIcdhrsvxy] <\s-1FILE\s0>

| numsum [-iIcdhrsvxy] (Input on \s-1STDIN\s0 from pipeline.)

numsum [-iIcdhrsvxy] (Input on \s-1STDIN\s0. Use Ctrl-D to stop.)

DESCRIPTION

numsum will take all the numbers on stdin and return the sum of those numbers. Currently it only processes the first number on each line. Besides positive numbers, it also handles negative numbers and numbers with decimals.

OPTIONS

    -i  Only return the integer portion of the final sum.
    -I  Only return the decimal portion of the final sum.

    -c      Print out the sum of each column.
    -r      Print out the sum of each row.

    -x <n>  Specify a comma seperated list of columns to print.
    -y <n>  Specify a comma seperated list of rows to print.

    -s <string> Specify a string to use as a seperator for columns.
                This defaults to be consecutive whitespace (\s+).

    -h  Help: You're looking at it.
    -V  Increase verbosity.
    -d  Debug mode.  For developers
    -q  Quiet mode, don't print any warnings.

EXAMPLES

Simply add up the numbers in a file.

    $ numsum numbers.txt
    4315

Enter your own numbers on \s-1STDIN\s0. The last number is the answer.

    $ numsum
    4
    21
    98
    100
    223

Use it in a command pipeline.

    $ ls -1s | grep .mp3 | numsum -c -x 5
    72288

Add up the total byte count in a http log file.

    $ cat access_log | awk {'print $10'} numsum

or

numsum -c -x 10 access_log

Add up the columns of numbers of a file.

$ cat columns 1 6 11 16 21 2 7 12 17 22 3 8 13 18 23 4 9 14 19 24 5 10 15 20 25 $ numsum -c columns 15 40 65 90 115

Add up the 1st, 2nd and 5th columns only.

$ numsum -c -x 1,2,5 columns 15 40 115

Add up the rows of numbers of a file.

$ numsum -r columns 55 60 65 70 75

Add up the 2nd and 4th rows.

$ numsum -r -y 2,4 columns 60 70

RELATED TO numsum…

numaverage\|(1), numbound\|(1), numinterval\|(1), numnormalize\|(1), numgrep\|(1), numprocess\|(1), numrandom\|(1), numrange\|(1), numround\|(1)

COPYRIGHT

numsum is part of the num-utils package, which is copyrighted by Suso Banderas and released under the \s-1GPL\s0 license. Please read the \s-1COPYING\s0 and \s-1LICENSE\s0 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 numsum can be found at:

http://suso.suso.org/programs/num-utils/