.\" Man page contributed by Dirk Eddelbuettel
.\" and released under the GNU General Public License
.TH GSL-HISTOGRAM 1 "" GNU
.SH NAME
gsl-histogram - compute histogram of data on stdin
.SH SYNOPSYS
.B gsl-histogram xmin xmax [n]
.SH DESCRIPTION
.B gsl-histogram
is a demonstration program for the GNU Scientific Library.
It takes three arguments, specifying the upper and lower bounds of the
histogram and the number of bins. It then reads numbers from `stdin',
one line at a time, and adds them to the histogram. When there is no
more data to read it prints out the accumulated histogram using
gsl_histogram_fprintf. If n is unspecified then bins of integer width
are used.
.SH EXAMPLE
Here is an example. We generate 10000 random samples from a Cauchy
distribution with a width of 30 and histogram them over the range -100 to
100, using 200 bins.
gsl-randist 0 10000 cauchy 30 | gsl-histogram -100 100 200 > histogram.dat
A plot of the resulting histogram will show the familiar shape of the
Cauchy distribution with fluctuations caused by the finite sample
size.
awk '{print $1, $3 ; print $2, $3}' histogram.dat | graph -T X
.SH SEE ALSO
.BR gsl(3) ,
.BR gsl-randist(1) .
.SH AUTHOR
.B gsl-histogram
was written by Brian Gough.
Copyright 1996-2000; for copying conditions see the GNU General
Public Licence.
This manual page was added by the Dirk Eddelbuettel
, the Debian GNU/Linux maintainer for
.BR GSL .