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
              existing 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 combined 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).



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                       PLHIST(3)
