numsum(1)

numsum1

Numsum program file

Usage

numsum [-iIcdhrsvxy] <FILE>

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

Overview

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 (unless when using the -x option). 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 separated list of columns to print.
    -y <n>  Specify a comma separated list of rows to print.
    -s <string> Specify a string to use as a separator 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 STDIN. 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

More info

More info on numsum can be found at:

http://suso.suso.org/xulu/Num-utils

Releases

10 releases since Debian 4.0 (Etch); the text changed 4 times.

  1. 4.0
  2. 5.0
  3. 6.0–8
  4. 9–10
  5. 11–13

From num-utils 0.5-15 in Debian 13 (Trixie). Parsed by carta from the page's man source.