summaryrefslogtreecommitdiff
path: root/gsl-1.9/doc/gsl-histogram.1
diff options
context:
space:
mode:
Diffstat (limited to 'gsl-1.9/doc/gsl-histogram.1')
-rw-r--r--gsl-1.9/doc/gsl-histogram.142
1 files changed, 42 insertions, 0 deletions
diff --git a/gsl-1.9/doc/gsl-histogram.1 b/gsl-1.9/doc/gsl-histogram.1
new file mode 100644
index 0000000..66f9b5a
--- /dev/null
+++ b/gsl-1.9/doc/gsl-histogram.1
@@ -0,0 +1,42 @@
+.\" 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 .