| 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: |
| 52 |
> |
To count data values between \-1 and 1 in 50 bins: |
| 53 |
|
.IP "" .2i |
| 54 |
< |
histo -1 1 50 < input.dat |
| 54 |
> |
histo \-1 1 50 < input.dat |
| 55 |
|
.PP |
| 56 |
|
To count frequencies of integers between 0 and 255: |
| 57 |
|
.IP "" .2i |
| 59 |
|
.SH AUTHOR |
| 60 |
|
Greg Ward |
| 61 |
|
.SH "SEE ALSO" |
| 62 |
< |
cnt(1), lam(1), neat(1), rcalc(1), tabfunc(1), total(1) |
| 62 |
> |
cnt(1), neaten(1), rcalc(1), rlam(1), tabfunc(1), total(1) |
