trusty (3) plbin.3plplot.gz

Provided by: plplot-doc_5.10.0-0ubuntu5_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 (const PLFLT *, input)
              Pointer  to  array  containing values associated with bins.  These must form a strictly increasing
              sequence.

       y (const 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

       Many developers (who are  credited  at  http://plplot.sourceforge.net/credits.php)  have  contributed  to
       PLplot over its long history.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/documentation.php.

                                                 February, 2014                                   PLBIN(3plplot)