box#
Purpose#
Graphs data using the box graph percentile method.
Note
This function uses the deprecated PQG graphics. Use plotBox()
instead.
Library#
pgraph
Format#
- box(grp, y)#
- Parameters:
grp (1xM vector) – This contains the group numbers corresponding to each column of y data. If scalar 0, a sequence from 1 to
cols(y)
will be generated automatically for the x-axis.y (NxM matrix) – Each column represents the set of y values for an individual percentiles box symbol.
Global Input#
- _pboxctl#
5x1 vector, controls box style, width, and color.
[1]
box width between 0 and 1. If zero, the box plot is drawn as two vertical lines representing the quartile ranges with a filled circle representing the 50th percentile.
[2]
box color. If this is set to 0, the colors may be individually controlled using the global variable
_pcolor
.[3]
Min/max style for the box symbol. One of the following
- 1:
Minimum and maximum taken from the actual limits of the data. Elements 4 and 5 are ignored.
- 2:
Statistical standard with the minimum and maximum calculated according to interquartile range as follows:
intqrange = 75th - 25th
min = 25th - 1.5 intqrange
max = 75th + 1.5 intqrange
Elements 4 and 5 are ignored.
- 3:
Minimum and maximum percentiles taken from elements 4 and 5.
[4]
Minimum percentile value (0-100) if _pboxctl[3] = 3.
[5]
Maximum percentile value (0-100) if _pboxctl[3] = 3.
- _plctrl#
1xM vector or scalar as follows:
0
Plot boxes only, no symbols.
1
Plot boxes and plot symbols which lie outside the min and max box values.
2
Plot boxes and all symbols.
-1
Plot symbols only, no boxes.
These capabilities are in addition to the usual line control capabilities of _plctrl.
- _pcolor#
1xM vector or scalar for symbol colors. If scalar, all symbols will be one color.
Remarks#
If missing values are encountered in the y data, they will be ignored
Source#
pbox.src