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  pl‐
18       hist(3plplot) for drawing histograms from unbinned data.
19
20       Redacted form: General: plbin(x, y, opt) Python: plbin(nbin, x, y, opt)
21
22
23       This function is not used in any examples.
24

ARGUMENTS

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

AUTHORS

52       Many developers (who  are  credited  at  http://plplot.org/credits.php)
53       have contributed to PLplot over its long history.
54

SEE ALSO

56       PLplot documentation at http://plplot.org/documentation.php.
57
58
59
60                                February, 2022                  PLBIN(3plplot)
Impressum