stat_boxplot

stat_boxplot(mapping=NULL, data=NULL, geom="boxplot", position="dodge", na.rm=FALSE, coef=1.5, ...)

What do you think of the documentation? Please let me know by filling out this short online survey.

Aesthetics

The following aesthetics can be used with stat_boxplot. Aesthetics are mapped to variables in the data with the aes function: stat_boxplot(aes(x = var)). Note that you do not need quotes around the variable name.

Scales control how the variable is mapped to the aesthetic and are listed after each aesthetic.

Aesthetic	Default	Related scales
x	required	continuous, date, datetime, discrete
y	required	continuous, date, datetime, discrete

Layers are divided into groups by the group aesthetic. By default this is set to the interaction of all categorical variables present in the plot.

New variables produced by the statistic

To use these variables in an aesthetic mapping, you need to surrond them with .., like aes(x = ..output..). This tells ggplot that the variable isn't the original dataset, but has been created by the statistic.

• width, width of boxplot
• ymin, lower whisker, lower hinge - 1.5 * IQR
• lower, lower hinge, 25% quantile
• middle, median, 50% quantile
• upper, upper hinge, 75% quantile
• ymax, upper whisker, upper hinge + 1.5 * IQR

Parameters

Parameters control the appearance of the stat. In addition to the parameters listed below (if any), any aesthetic can be used as a parameter, in which case it will override any aesthetic mapping.

• width: NULL
• na.rm: NULL
• coef: NULL
• ...: ignored

Returns

This function returns a layer object.

Examples

> # See geom_boxplot for examples 

What do you think of the documentation? Please let me know by filling out this short online survey.

© Hadley Wickham 2010