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  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.

```

#### SEEALSO

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

February, 2016                           PLBIN(3plplot)
```