## Box Plot Statistics

## Usage

    boxplot.stats(x, coef = 1.5)

## Arguments

`x` | a numeric vector for which the boxplot will be constructed (`NA`s and `NaN`s are allowed and omitted).
`coef` | this determines how far the plot ``whiskers'' extend out from the box. If `coef` is positive, the whiskers extend to the most extreme data point which is no more than `coef` times the interquartile coef from the box. A value of zero causes the whiskers to extend to the data extremes.

## Value

This function is typically is called by `boxplot` to gather the statistics necessary for producing box plots, but may be invoked separately. The value it returns is a list with named components as follows:

`stats` | a vector of length 5, containing the extreme of the lower whisker, the lower ``hinge'', the median, the upper ``hinge'' and the extreme of the upper whisker.
`n` | the number of of non-`NA` observations in the sample.
`conf` | the lower and upper extremes of the ``notch''.
`out` | the values of any data points which lie beyond the extremes of the whiskers.

Note that `$stats` and `$conf` are sorted increasingly, contrary to S, and that `$n` and `$out` include any `+- Inf` values.

## See Also

`fivenum`, `boxplot`, `bxp`.

## Examples

    str(boxplot.stats(1:100))
    str(boxplot.stats(1:100, coef = 3))
    str(boxplot.stats(1:100, coef = 0))

    str(boxplot.stats(c(1:100,NA)))
    str(boxplot.stats(c(1:100,-1:1/0)))

[Package Contents]