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

NAME

       plbin - Plot a histogram from binned data

SYNOPSIS

       plbin(nbin, x, y, opt)

DESCRIPTION

       Plots  a  histogram  consisting  of  nbin bins.  The value associated with the i'th bin is
       placed in x[i], and the number of points in  the  bin  is  placed  in  y[i].   For  proper
       operation,  the values in x[i] must form a strictly increasing sequence.  By default, x[i]
       is the left-hand edge of the i'th bin. If opt=PL_BIN_CENTRED is used, the  bin  boundaries
       are placed midway between the values in the x array.  Also see plhist(3plplot) for drawing
       histograms from unbinned data.

       Redacted form:  General: plbin(x,  y,  opt)  Perl/PDL:  plbin(nbin,  x,  y,  opt)  Python:
       plbin(nbin, x, y, opt)

       This function is not used in any examples.

ARGUMENTS

       nbin (PLINT, input)
              Number of bins (i.e., number of values in x and y arrays.)

       x (PLFLT *, input)
              Pointer  to  array  containing  values  associated  with  bins.   These must form a
              strictly increasing sequence.

       y (PLFLT *, input)
              Pointer to array containing number of points in bin.  This is a PLFLT  (instead  of
              PLINT) array so as to allow histograms of probabilities, etc.

       opt (PLINT, input)
              Is  a  combination  of several flags: opt=PL_BIN_DEFAULT: The x represent the lower
              bin boundaries, the outer bins are expanded to fill up the entire x-axis  and  bins
              of zero height are simply drawn.  opt=PL_BIN_CENTRED|...: The bin boundaries are to
              be midway between the x values. If the values in x are equally spaced,  the  values
              are  the  center  values  of the bins.  opt=PL_BIN_NOEXPAND|...: The outer bins are
              drawn with equal size as the ones inside.  opt=PL_BIN_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                           PLBIN(3plplot)