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