.\" 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 .