other versions

- buster 5.14.0+dfsg-3
- testing 5.15.0+dfsg-16
- unstable 5.15.0+dfsg-19
- experimental 5.15.0+dfsg-16+gnat10

PLBIN(3plplot) | PLplot API | PLBIN(3plplot) |

# 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*vector. Also see

**plhist**(3plplot) for drawing histograms from unbinned data.

Redacted form: General: **plbin(x, y, opt)** Python:
**plbin(nbin, x, y, opt)**

This function is not used in any examples.

# ARGUMENTS¶

*nbin*(**PLINT**(3plplot), input)- Number of bins (i.e., number of values in
*x*and*y*vectors.) *x*(**PLFLT_VECTOR**(3plplot), input)- A vector containing values associated with bins. These must form a strictly increasing sequence.
*y*(**PLFLT_VECTOR**(3plplot), input)- A vector containing a number which is proportional to the number of points in each bin. This is a PLFLT (instead of PLINT) vector so as to allow histograms of probabilities, etc.
*opt*(**PLINT**(3plplot), 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.org/credits.php) have contributed to PLplot over its long history.# SEE ALSO¶

PLplot documentation at http://plplot.org/documentation.php.November, 2020 |