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