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   array.    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, input)
28              Number of bins (i.e., number of values in x and y arrays.)
29
30       x (PLFLT *, input)
31              Pointer to array containing values associated with bins.   These
32              must form a strictly increasing sequence.
33
34       y (PLFLT *, input)
35              Pointer  to array containing number of points in bin.  This is a
36              PLFLT (instead of PLINT) array so  as  to  allow  histograms  of
37              probabilities, etc.
38
39       opt (PLINT, 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       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This
54       man page was automatically generated from the  DocBook  source  of  the
55       PLplot   documentation,   maintained   by  Alan  W.  Irwin  and  Rafael
56       Laboissiere.
57

SEE ALSO

59       PLplot documentation at http://plplot.sourceforge.net/resources.
60
61
62
63                                  March, 2007                   PLBIN(3plplot)
Impressum