gbhisto.1 2.47 KB
Newer Older
1
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.44.1.
2
.TH GBHISTO "1" "November 2015" "gbhisto 5.6.7" "User Commands"
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83
.SH NAME
gbhisto \- Produce histogram from data
.SH SYNOPSIS
.B gbhisto
[\fIoptions\fR]
.SH DESCRIPTION
Compute histogram counting the occurrences of each value (discrete data) or
binning the values on a regular grid (continuous data). Data are read from
standard input. For discrete data, values and their occurrences are printed;
For binned data, the bin reference point and the relative statistics are
printed. The type of variable and the statistics can be set with option \fB\-M\fR.
The binning grid can be linear, logarithmic or geometric. The bin reference
point is the algebraic midpoint for linear binning and the geometric midpoint
for log or geometric binning. The reference point can be moved using option
\fB\-S\fR. Set it to 0 for the lower bound or to 1 for the upper bound.
.SH OPTIONS
.TP
\fB\-n\fR
number of equispaced bins where the histogram is computed (default 10)
.TP
\fB\-w\fR
min,max set manually the binning window
.TP
\fB\-M\fR
set the type of output (default 0)
.TP
0
occurrences number (continuous binned variable)
.TP
1
relative frequency (continuous binned variable)
.TP
2
empirical density  (continuous binned variable)
.TP
3
occurrences number (discrete variable)
.TP
4
relative frequency (discrete variable)
.TP
5
CDF (left cumulated probability; continuous binned variable)
.TP
6
inverse CDF (1\-CDF; continuous binned variable)
.TP
\fB\-B\fR
set the type of binning (default 0)
.TP
0
linear
.TP
1
logarithmic
.TP
2
geometric
.TP
\fB\-S\fR
set the bin reference point (default 0.5)
.TP
\fB\-r\fR
set the ratio for geometrical binning  (default 1.618)
.TP
\fB\-t\fR
print the histogram for each imput column
.TP
\fB\-F\fR
specify the input fields separators (default " \et")
.TP
\fB\-v\fR
verbose mode
.SH AUTHOR
Written by Giulio Bottazzi
.SH "REPORTING BUGS"
Report bugs to <gbutils@googlegroups.com>
.PP
.br
Package home page <http://cafim.sssup.it/~giulio/software/gbutils/index.html>
.SH COPYRIGHT
84
Copyright \(co 2001\-2015 Giulio Bottazzi
85 86 87 88 89 90 91 92
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
(version 2) as published by the Free Software Foundation;
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.