mkHisto

[ XITE Reference Manual | XITE home ]

Name

mkHisto - make and print a histogram

Syntax

mkHisto [-header] [-i] <inimage> <lim0> [<lim1> [<lim2> ...]]

Description

Creates a histogram and writes the histogram values to stdout. The limits (one or more) define the borders of the accumulator cells. The limits must be sorted in ascending order. The specified limits are applied to all bands in the image. The limits -Inf and Inf are always added.

The histogram will contain the following values:
 histo[0] = #pixels in <-Inf .. limits[0]]
 histo[i] = #pixels in <limits[i-1] .. limits[i]]
 histo[n] = #pixels in <limits[n-1] .. Inf>

Options

-header
A textual header will be given. By default the histogram values are given in ascii without any explanation.

-i
The limits are interpreted as integer values. By default, they are assumed to be floating point (double).

See also

Restrictions

Does not accept complex and double complex pixel type.

Author

Tor Lønnestad, BLAB, Ifi, UiO

Examples

 # how many pixels are below (or equal) and above 100?
 mkHisto mona.img -i 100
 # how many pixels are in 0..50, 50..100 etc.?
 mkHisto mona.img -header 50 100 150 200 250

Id

$Id: mkHisto.c,v 1.23 1997/01/29 10:42:48 svein Exp $