From SusoSight


The 'num-utils' are a set of programs for dealing with numbers from the Unix command line. Much like the other Unix command line utilities like grep, awk, sort, cut, etc. these utilities work on data from both standard in and data from files.


  • November 23rd, 2007 - Work is continuing on num-utils, I've just been busy with other things. Some people on the mailing list have been discussing new features and future development so you might want to subscribe if you are interested. I think we should have another release in the next couple months. I'd like to work towards stabilizing the programs so that we can have a 1.0 release soon.
  • November 19th, 2004 Version 0.5 - numsum now has the ability to sum up rows and columns of numbers. Including methods for specifying which columns or rows you want to sum up.
  • September 23rd, 2003 Version 0.4 - New to this version is the 'normalize' program. Also the average function has added functionality in that it can find the median and mode of a set of numbers.
  • June 9th, 2003 Version 0.3 - New to this version is the 'interval' program.
  • May 29th, 2003 Version 0.2 - New features in this release include handling of factors and multiples in numgrep, a -e (exclude) option in the range command, and handling of negative numbers for the sqrt() function in numprocess. Several documentation additions and fixes have also been made.
  • June 17th, 2002 Version 0.1 - This initial release of num-utils is quite mature and usable, although it is still considered in development.


Click on the link to see its man page in html format.

  • average: A program for calculating the average of numbers.
  • bound: Finds the boundary numbers (min and max) of input.
  • interval: Shows the numeric intervals between each number in a sequence.
  • normalize: Normalizes a set of numbers between 0 and 1 by default.
  • numgrep: Like normal grep, but for sets of numbers.
  • numprocess: Do mathmatical operations on numbers.
  • numsum: Add up all the numbers.
  • random: Generate a random number from a given expression.
  • range: Generate a set of numbers in a range expression.
  • round: Round each number according to it's value.




You can now install num-utils on Debian based distributions by running apt-get install num-utils.


  • num-utils are available on Gentoo. Just run emerge num-utils. You may have to prefix that with ACCEPT_KEYWORDS="~x86" as it is currently masked.


  • Older versions of num-utils are available here.
  • num-utils even work under MacOS X. They are part of the Fink distrobution of Unix utilities.

Other files


Below are links to pages containing various ways in which the num-utils set of programs can be used to accomplish various tasks. They will help you get started and then you can come up with your own ways to accomplish your task.

Mailing list

I have created a mailing list for general discussion, development, questions, tips and tricks pertaining to the num-utils. You can subscribe to the mailing list on this page.

There is also a web forum for those that would rather use that than an e-mail mailing list.


Num-utils are currently in development and may be buggy or lacking in some respects. Anyone who is interested, is welcome to contribute in any way they feel they can. Please read the GOALS file and contact me at You should also subscribe to the mailing list if you plan to help with development.

Num-utils current list of known bugs

Also, check out the Web forum for development if you'd rather use a web forum than an e-mail list.