


PLHIST(3)                   PLplot API                  PLHIST(3)


NAME
       plhist - Plot a histogram from unbinned data

SYNOPSIS
       plhist(n, data, datmin, datmax, nbin, opt)

DESCRIPTION
       Plots  a  histogram  from n data points stored in the array data.  This
       routine bins the data into nbin bins equally spaced between datmin  and
       datmax,  and calls plbin(3) to draw the resulting histogram.  Parameter
       opt allows, among other things, the histogram either to be  plotted  in
       an  existing  window or causes plhist(3) to call plenv(3) with suitable
       limits before plotting the histogram.

       Redacted form: plhist(data, datmin, datmax, nbin, opt)

       This function is used in example 5.

ARGUMENTS
       n (PLINT, input)
              Number of data points.

       data (PLFLT *, input)
              Pointer to array with values of the n data points.

       datmin (PLFLT, input)
              Left-hand edge of lowest-valued bin.

       datmax (PLFLT, input)
              Right-hand edge of highest-valued bin.

       nbin (PLINT, input)
              Number of (equal-sized) bins into which to divide  the  interval
              xmin to xmax.

       opt (PLINT, input)
              Is a combination of several flags: opt=PL_HIST_DEFAULT: The axes
              are automatically rescaled to fit the histogram data, the  outer
              bins are expanded to fill up the entire x-axis, data outside the
              given extremes are assigned to the outer bins and bins  of  zero
              height  are simply drawn.  opt=PL_HIST_NOSCALING|...: The exist-
              ing axes are not rescaled to fit  the  histogram  data,  without
              this  flag,  plenv(3)  is  called  to set the world coordinates.
              opt=PL_HIST_IGNORE_OUTLIERS|...: Data outside the given extremes
              are  not taken into account. This option should probably be com-
              bined with opt=PL_HIST_NOEXPAND|..., so as to  properly  present
              the  data.   opt=PL_HIST_NOEXPAND|...:  The outer bins are drawn
              with equal size as the  ones  inside.   opt=PL_HIST_NOEMPTY|...:
              Bins  with  zero  height  are not drawn (there is a gap for such
              bins).







                          November, 2007                        1





PLHIST(3)                   PLplot API                  PLHIST(3)


AUTHORS
       Geoffrey Furnish and Maurice LeBrun wrote and  maintain  PLplot.   This
       man  page  was  automatically  generated from the DocBook source of the
       PLplot  documentation,  maintained  by  Alan  W.   Irwin   and   Rafael
       Laboissiere.

SEE ALSO
       PLplot documentation at http://plplot.sourceforge.net/resources.

















































                          November, 2007                        2


