3 |
|
.SH NAME |
4 |
|
histo - compute 1-dimensional histogram of N data columns |
5 |
|
.SH SYNOPSIS |
6 |
< |
.B "histo [-c] xmin xmax nbins" |
6 |
> |
.B "histo [-c][-p] xmin xmax nbins" |
7 |
|
.br |
8 |
< |
.B "histo [-c] imin imax" |
8 |
> |
.B "histo [-c][-p] imin imax" |
9 |
|
.SH DESCRIPTION |
10 |
|
.I Histo |
11 |
|
bins columnular data on the standard input between the given minimum |
28 |
|
straight frequencies. |
29 |
|
The upper value of each bin is printed also instead of the centroid. |
30 |
|
This may be useful in computing percentiles, for example. |
31 |
+ |
Values below the minimum specified are still counted in the cumulative |
32 |
+ |
total. |
33 |
|
.PP |
34 |
+ |
The |
35 |
+ |
.I \-p |
36 |
+ |
option tells |
37 |
+ |
.I histo |
38 |
+ |
to report the percentage of the total number of input lines rather |
39 |
+ |
than the absolute counts |
40 |
+ |
In the case of a cumulative total, this yeilds the percentile values |
41 |
+ |
directly. |
42 |
+ |
Values above the maximum are counted as well as values below in |
43 |
+ |
this case. |
44 |
+ |
.PP |
45 |
|
All input data is interpreted as real values, and columns must be |
46 |
|
white-space separated. |
47 |
|
If any value is less than the minimum or greater than the maximum, |
48 |
< |
it will be ignored on the input. |
49 |
< |
(I.e., it will not contribute to any frequency count.) |
48 |
> |
it will be ignored unless the |
49 |
> |
.I \-c |
50 |
> |
option is specified. |
51 |
|
.SH EXAMPLE |
52 |
|
To count data values between -1 and 1 in 50 bins: |
53 |
|
.IP "" .2i |