Provided by: plplot-doc_5.9.9-2ubuntu2_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 (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.

```

#### SEEALSO

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

February, 2012                           PLBIN(3plplot)
```