.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.6.
.TH GBHISTO2D "1" "March 2019" "gbhisto2d 6.1" "User Commands"
.SH NAME
gbhisto2d \- Produce 2D histogram from data
.SH SYNOPSIS
.B gbhisto2d
[\fI\,options\/\fR]
.SH DESCRIPTION
2D histogram on a regular grid. Data are read from standard input as couples
(X,Y). If data are treated as continuous, equispaced bins are built and their
center coordinates together with the required statistics are printed. For
discrete variables, bins are built directly from the given variables. Transition
matrices (option \fB\-M\fR 5 and \fB\-M\fR 8) have final states across the rows. In case of
continuous variables it is also possible to consider rectangular matrices.
.SS "Options :"
.TP
\fB\-M\fR
choose the statistics to print for each bin (default 0)
.TP
0
occurrences number for continuous binned variables (*)
.TP
1
relative frequency for continuous binned variables (*)
.TP
2
empirical density  for continuous binned variables (*)
.TP
3
occurrences number for discrete symmetric variables (bins{X}=bins{Y})
.TP
4
relative frequency for discrete symmetric variables (bins{X}=bins{Y})
.TP
5
transition matrix  (X=>Y) for discrete symmetric variables (bins{X}=bins{Y})
.TP
6
occurrences number for discrete asymmetric variables
.TP
7
relative frequency for discrete asymmetric variables
.TP
8
transition matrix  (X=>Y) for continuous binned variables (*)
.TP
\fB\-n\fR
number of equispaced bins where the histogram is computed. For output marked
with (*),  use comma ',' to specify different values for x and y coordinates.
(default 10)
.TP
\fB\-v\fR
verbose mode
.TP
\fB\-F\fR
specify the input fields separators (default " \et")
.TP
\fB\-h\fR
this help
.SH EXAMPLES
.TP
gbhisto2d \-n 20 < file
compute a 2D histrogram using 20x20 bins.
.TP
gbhisto2d \-M 8 \-n 4 < file
compute transition matrix on equispaced bins for
continuous variables.
.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
Copyright \(co 2001\-2018 Giulio Bottazzi
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.