MAPHIMBU(1) User Commands MAPHIMBU(1)NAME
maphimbu - histogram builder for 1-d numerical and text data
SYNOPSIS
maphimbu [OPTION]... [FILE]
DESCRIPTION
This program produces 1-d histograms from numerical or text data input. It can be also used to estimate the probability distribution func-
tion of a numerical variable - see http://en.wikipedia.org/wiki/Probability_density_function.
OPTIONS -x <int>
x-data column (default is 1)
-y <int>
y-data column (default is 2); It is considered only when combined with '-m' or '-S'
-d <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.
-n normalize the result A) non-numerical data: n(x) = counts(x)/sum_of_counts B) numerical data: the normalized probability density
func.
is P(-INF < x <INF) = Int_[-INF:INF] P(x)*dx = 1 ; For the numerical integration an open x-data interval is assumed.
-N normalize data against the total sum of counts (same as option '-n' with case A forced)
-U 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'.
-S compute sums and normalized sums of y-values; The total sum of all y-values is used for the normalization.
-m compute the arithmetic mean of y-values in the respective x-bar
-s <int>
sort output using the specified column; Header is skipped in this case.
-g <int>
sort output numerically using the specified column; Header is skipped in this case.
-r do reverse sorting (in combination with '-g' and '-s')
-C center histogram bars (shifts x-axis by 0.5*dx)
-X treat hole line as one string (single data record)
-H print a data description header
-V print program version and exit
--version
output version and copyright information
--help display help
-h display short help (options summary)
Note: this program is not intended for use in high order numerical computations.
REPORTING BUGS
Report bugs to <gnu@mirendom.net>
COPYRIGHT
Copyright (C) 2003-2007, 2009, 2011 Dimitar Ivanov
License: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
maphimbu 2.8.4 February 2012 MAPHIMBU(1)
Check Out this Related Man Page
MINTEGRATE(1) User Commands MINTEGRATE(1)NAME
mintegrate - evaluate average/sum/integral/derivative of 1-d numerical data
SYNOPSIS
mintegrate [OPTION]... [FILE]
DESCRIPTION
mintegrate is a program to compute averages, sums, integrals or derivatives of numerical 1-d data in situations where ultimate numerical
precision is not needed.
OPTIONS -a compute mean value (arithmetic average) and standard deviation
-c compute integral on closed x-data interval; In case that dx is not specified by the '-d' flag, the data are supposed to be from an
irregular x-grid, and dx is computed separately for every x-interval. The integral is computed by the trapezoidal rule.
-d <float>
compute integral on open x-data interval with the specified dx; Can be used also in combination with '-D' and '-c'.
-D compute difference btw. numbers or derivative of the y-data; In the default scenario where x- and y-data column are same, the dif-
ference btw. the current and the previous data value will be output. In this case when '-d' is defined as 0, the x-data value will
be print out in front of the calculated difference. If x-and the y-column are different and if the x-data resolution is not defined
or it is !=0, then the derivative of the y-data is calculated. When the x-data resolution is constant, specify it explicitly by '-d'
to achieve a higher numerical precision by a 'leapfrog' algorithm.
-x <int>
x-data column (default is 1). If 0, the x-range is an index;
-y <int>
y-data column, where y=f(x) (default is 1)
-r x_0:x_1
x-data range to consider
-s print out accumulated y_i sums: x_i versus accumulated f(x_i); In the case of a closed integral you have to specify also the x-data
resolution dx (see '-d' above).
-S compute the accumulated y_i-sums and add it to the output
-p <str>
print format of the result ("%.10g" is default)
-t <str>
output text in front of the result (invalid with '-s' or '-S'); A blank can be printed by using a double underscore character '__'.
-T run a self-test that the program is working correctly
-V print version number
--version
output version and license message
--help|-H
display help
-h display short help (options summary)
If none of the options '-a', '-D', '-d', or '-c' is used, then the sum of the provided data will be computed. Empty lines or lines starting
with '#' are skipped.
This program is perfectly suitable as a basic tool for initial data analysis and will meet the expected accuracy of a numerical solution
for the most demanding computer users and professionals. Yet be aware that, although the computations are carried with double floating pre-
cision, the computational techniques used for evaluating an integral or a standard deviation are analytically low-order approximations, and
thus not intended to be used for numerical computations in engineering or mathematical sciences for cases where an ultimate numerical pre-
cision is a must. For deeper understanding of the topic see http://en.wikipedia.org/wiki/Numerical_analysis.
COPYRIGHT
Copyright (C) 1997, 2001, 2006-2007, 2009, 2011-2012 Dimitar Ivanov
License: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
mintegrate 2.2.1 February 2012 MINTEGRATE(1)