gsl-histogram man page

gsl-histogram — compute histogram of data on stdin


gsl-histogram xmin xmax [n]


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.


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

See Also

gsl(3), gsl-randist(1).


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 GSL.

Referenced By