Provided by: plplot-doc_5.10.0+dfsg2-0.1ubuntu2_all

**NAME**

plbin- Plot a histogram from binned data

**SYNOPSIS**

plbin(nbin,x,y,opt)

**DESCRIPTION**

Plots a histogram consisting ofnbinbins. The value associated with the i'th bin is placed inx[i], and the number of points in the bin is placed iny[i]. For proper operation, the values inx[i] must form a strictly increasing sequence. By default,x[i] is the left-hand edge of the i'th bin. Ifopt=PL_BIN_CENTRED is used, the bin boundaries are placed midway between the values in thexarray. Also seeplhist(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 inxandyarrays.)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: Thexrepresent 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 thexvalues. If the values inxare 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, 2016 PLBIN(3plplot)