1PLBIN(3plplot)                    PLplot API                    PLBIN(3plplot)
2
3
4

NAME

6       plbin - Plot a histogram from binned data
7

SYNOPSIS

9       plbin(nbin, x, y, opt)
10

DESCRIPTION

12       Plots  a  histogram consisting of nbin bins.  The value associated with
13       the i'th bin is placed in x[i], and the number of points in the bin  is
14       placed  in  y[i].  For proper operation, the values in x[i] must form a
15       strictly increasing sequence.  By default, x[i] is the  left-hand  edge
16       of  the i'th bin. If opt=PL_BIN_CENTRED is used, the bin boundaries are
17       placed  midway  between  the  values  in  the  x  vector.    Also   see
18       plhist(3plplot) for drawing histograms from unbinned data.
19
20       Redacted  form:  General:  plbin(x, y, opt) Perl/PDL: plbin(nbin, x, y,
21       opt) Python: plbin(nbin, x, y, opt)
22
23
24       This function is not used in any examples.
25

ARGUMENTS

27       nbin (PLINT(3plplot), input)
28              Number of bins (i.e., number of values in x and y vectors.)
29
30       x (PLFLT_VECTOR(3plplot), input)
31              A vector containing values associated  with  bins.   These  must
32              form a strictly increasing sequence.
33
34       y (PLFLT_VECTOR(3plplot), input)
35              A vector containing a number which is proportional to the number
36              of points in each bin.  This is a PLFLT (instead of PLINT)  vec‐
37              tor so as to allow histograms of probabilities, etc.
38
39       opt (PLINT(3plplot), input)
40              Is  a  combination  of  several flags: opt=PL_BIN_DEFAULT: The x
41              represent the lower bin boundaries, the outer bins are  expanded
42              to  fill up the entire x-axis and bins of zero height are simply
43              drawn.  opt=PL_BIN_CENTRED|...: The bin  boundaries  are  to  be
44              midway  between  the  x  values.  If the values in x are equally
45              spaced,  the  values  are  the  center  values  of   the   bins.
46              opt=PL_BIN_NOEXPAND|...:  The  outer  bins  are drawn with equal
47              size as the ones inside.  opt=PL_BIN_NOEMPTY|...: Bins with zero
48              height are not drawn (there is a gap for such bins).
49
50
51

AUTHORS

53       Many    developers   (who   are   credited   at   http://plplot.source‐
54       forge.net/credits.php) have contributed to PLplot over  its  long  his‐
55       tory.
56

SEE ALSO

58       PLplot    documentation   at   http://plplot.sourceforge.net/documenta‐
59       tion.php.
60
61
62
63                                 August, 2017                   PLBIN(3plplot)
Impressum