Provided by: plplot-doc_5.9.9-2ubuntu2_all bug

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(3plplot) to  draw
       the  resulting  histogram.  Parameter opt allows, among other things, the histogram either
       to be plotted in an existing window or causes plhist(3plplot) to call plenv(3plplot)  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(3plplot) 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.

                                          February, 2012                          PLHIST(3plplot)