.\" Man page contributed by Dirk Eddelbuettel <edd@debian.org>
.\" 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
<edd@debian.org>, the Debian GNU/Linux maintainer for
.BR GSL .