.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.38.4.
.TH MAPHIMBU "1" "February 2012" "maphimbu 2.8.4" "User Commands"
.SH NAME
maphimbu \-  histogram builder for 1\-d numerical and text data
.SH SYNOPSIS
.B maphimbu
[\fIOPTION\fR]... [\fIFILE\fR]
.SH DESCRIPTION
This program produces 1\-d histograms from numerical or text data input. It can be also used to estimate the probability distribution function of a numerical variable \- see http://en.wikipedia.org/wiki/Probability_density_function.
.SH OPTIONS
.TP
\fB\-x\fR <int>
x\-data column (default is 1)
.TP
\fB\-y\fR <int>
y\-data column (default is 2);
It is considered only when combined with '\-m' or '\-S'
.TP
\fB\-d\fR <float|int>
delta size (dx\-resolution) in case of numerical data;
Keep in mind that 2 is not the same as 2.0: in the
first case the numbers are treated as integers, in
the latter as floats.
.TP
\fB\-n\fR
normalize the result
A) non\-numerical data: n(x) = counts(x)/sum_of_counts
B) numerical data: the normalized probability density func.
.IP
is P(\-INF\fR < x <INF) = Int_[\-INF:INF] P(x)*dx = 1 ;
For the numerical integration an open x\-data interval
is assumed.
.TP
\fB\-N\fR
normalize data against the total sum of counts
(same as option '\-n' with case A forced)
.TP
\fB\-U\fR
normalize the result with x\-range mapped to unit;
The x\-values are mapped to the interval [0:1],
respectively Int_[0:1] P(x)*dx = 1; This option is
mutually exclusive with '\-n'.
.TP
\fB\-S\fR
compute sums and normalized sums of y\-values;
The total sum of all y\-values is used for the
normalization.
.TP
\fB\-m\fR
compute the arithmetic mean of y\-values
in the respective x\-bar
.TP
\fB\-s\fR <int>
sort output using the specified column;
Header is skipped in this case.
.TP
\fB\-g\fR <int>
sort output numerically using the specified column;
Header is skipped in this case.
.TP
\fB\-r\fR
do reverse sorting (in combination with '\-g' and '\-s')
.TP
\fB\-C\fR
center histogram bars (shifts x\-axis by 0.5*dx)
.TP
\fB\-X\fR
treat hole line as one string (single data record)
.TP
\fB\-H\fR
print a data description header
.TP
\fB\-V\fR
print program version and exit
.TP
\fB\-\-version\fR
output version and copyright information
.TP
\fB\-\-help\fR
display help
.TP
\fB\-h\fR
display short help (options summary)
.PP
Note: this program is not intended for use in high order numerical computations.
.SH "REPORTING BUGS"
Report bugs to <gnu@mirendom.net>
.SH COPYRIGHT
Copyright \(co 2003\-2007, 2009, 2011 Dimitar Ivanov
.PP
License: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.