htswanalysis/MACS/lib/gsl/gsl-1.11/doc/gsl-histogram.1

   1 .\" Man page contributed by Dirk Eddelbuettel <edd@debian.org>
   2 .\" and released under the GNU General Public License
   3 .TH GSL-HISTOGRAM 1 "" GNU
   4 .SH NAME
   5 gsl-histogram - compute histogram of data on stdin
   6 .SH SYNOPSYS
   7 .B gsl-histogram xmin xmax [n]
   8 .SH DESCRIPTION
   9 .B gsl-histogram
  10 is a demonstration program for the GNU Scientific Library.
  11 It takes three arguments, specifying the upper and lower bounds of the
  12 histogram and the number of bins.  It then reads numbers from `stdin',
  13 one line at a time, and adds them to the histogram.  When there is no
  14 more data to read it prints out the accumulated histogram using
  15 gsl_histogram_fprintf.  If n is unspecified then bins of integer width
  16 are used.
  17 .SH EXAMPLE
  18 Here is an example.  We generate 10000 random samples from a Cauchy
  19 distribution with a width of 30 and histogram them over the range -100 to
  20 100, using 200 bins.
  21
  22      gsl-randist 0 10000 cauchy 30 | gsl-histogram -100 100 200 > histogram.dat
  23
  24 A plot of the resulting histogram will show the familiar shape of the
  25 Cauchy distribution with fluctuations caused by the finite sample
  26 size.
  27
  28      awk '{print $1, $3 ; print $2, $3}' histogram.dat | graph -T X
  29
  30 .SH SEE ALSO
  31 .BR gsl(3) ,
  32 .BR gsl-randist(1) .
  33
  34 .SH AUTHOR
  35 .B gsl-histogram
  36 was written by Brian Gough.
  37 Copyright 1996-2000; for copying conditions see the GNU General
  38 Public Licence.
  39
  40 This manual page was added by the Dirk Eddelbuettel
  41 <edd@debian.org>, the Debian GNU/Linux maintainer for
  42 .BR GSL .