R bxp 从摘要中绘制箱线图

说明

bxp 根据 z 中给定的摘要绘制箱线图。它通常从 boxplot 内部调用，但也可以直接调用。

用法

bxp(z, notch = FALSE, width = NULL, varwidth = FALSE,
    outline = TRUE, notch.frac = 0.5, log = "",
    border = par("fg"), pars = NULL, frame.plot = axes,
    horizontal = FALSE, ann = TRUE,
    add = FALSE, at = NULL, show.names = NULL,
    ...)

参数

z	包含用于构建绘图的数据摘要的列表。这些通常是调用 boxplot 的结果，但可以以任何方式生成。
notch	如果 notch 是 TRUE ，则在框的每一侧绘制一个凹口。如果两个图的缺口不重叠，则中位数在 5% 的水平上显著不同。
width	给出构成绘图的框的相对宽度的向量。
varwidth	如果 varwidth 是 TRUE ，则绘制框的宽度与组中观测值数量的平方根成正比。
outline	如果 outline 不为 true，则不会绘制异常值。
notch.frac	(0,1) 中的数字。当 notch = TRUE 时，凹口应使用的框宽度的分数。
border	字符或数字(向量)，框边框的颜色。可回收用于多个盒子。用作 boxcol 、 medcol 、 whiskcol 、 staplecol 和 outcol 选项的默认值(见下文)。
log	字符，指示是否应以对数刻度绘制任何轴，如 plot.default 中。
frame.plot	逻辑，指示是否应绘制‘frame’(box)；默认为 TRUE ，除非指定 axes = FALSE 。
horizontal	逻辑表明箱线图是否应该是水平的；默认FALSE表示垂直框。
ann	一个逻辑值，指示默认注释(标题以及 x 和 y 轴标签)是否应出现在绘图上。
add	逻辑，如果 true 将箱线图添加到当前绘图。
at	给出应绘制箱线图的位置的数值向量，特别是当 add = TRUE 时；默认为1:n，其中n 是盒子的数量。
show.names	设置为 TRUE 或 FALSE 以覆盖是否为每个组打印 x 轴标签的默认值。
pars,...	graphical parameters (等)可以作为参数传递给此函数，可以作为列表( pars )或通常( ... )，请参阅以下内容。 (... 中的内容优先于 pars 中的内容。) 现在，yaxs和ylim“沿箱线图”使用，即垂直使用，当horizontal是假的，并且xlim水平地。xaxt,yaxt,las,cex.axis,gap.axis， 和col.axis被传递给axis， 和main,cex.main,col.main,sub,cex.sub,col.sub,xlab,ylab,cex.lab， 和col.lab被传递给title. 此外，接受 axes (请参阅 plot.window )，默认为 TRUE 。 以下参数(或 pars 组件)允许进一步自定义箱线图图形。它们的默认值通常是根据无前缀版本(例如， lty 中的 boxlty )确定的，可以根据指定的参数或 pars 组件或相应的 par 组件确定。 盒子维克斯： 应用于所有框的比例因子。当只有几个组时，可以通过使框变窄来改善绘图的外观。默认值取决于at，通常为0.8。 钉书钉，外钉书钉： 订书钉和离群线宽度扩展，与盒子宽度成正比；两者都默认为 0.5。 boxlty、boxlwd、boxcol、boxfill： 框轮廓类型、宽度、颜色和填充颜色(当前默认为 col ，将来默认为 par("bg") )。 medlty、medlwd、medpch、medcex、medcol、medbg： 中线类型、线宽、点字符、点大小扩展、颜色和背景颜色。默认medpch = NA 会抑制点，medlty = "blank" 则会抑制线。请注意， medlwd 默认为 3\times 默认为 lwd 。 威士忌蒂、威士忌lwd、威士忌科尔： 须线类型(默认值："dashed")、宽度和颜色。 staplelty、staplelwd、staplecol： 订书钉(=须的末端)线条类型、宽度和颜色。 outlty、outlwd、outpch、outcex、outcol、outbg： 离群线类型、线宽、点字符、点尺寸扩展、颜色和背景颜色。默认outlty = "blank" 抑制线，outpch = NA 抑制点。

值

一个不可见的向量，实际上与 at 参数相同，具有框中心的坐标(如果水平为 false，则为 "x"，否则为 "y")，可用于添加到绘图中。

注意

当 add = FALSE 时，xlim 现在默认为 xlim = range(at, *) + c(-0.5, 0.5) 。如果 "x" 轴具有对数刻度或 width 远不均匀，则通常最好指定 xlim。

例子

require(stats)
set.seed(753)
(bx.p <- boxplot(split(rt(100, 4), gl(5, 20))))
op <- par(mfrow =  c(2, 2))
bxp(bx.p, xaxt = "n")
bxp(bx.p, notch = TRUE, axes = FALSE, pch = 4, boxfill = 1:5)
bxp(bx.p, notch = TRUE, boxfill = "lightblue", frame.plot = FALSE,
    outline = FALSE, main = "bxp(*, frame.plot= FALSE, outline= FALSE)")
bxp(bx.p, notch = TRUE, boxfill = "lightblue", border = 2:6,
    ylim = c(-4,4), pch = 22, bg = "green", log = "x",
    main = "... log = 'x', ylim = *")
par(op)
op <- par(mfrow = c(1, 2))

## single group -- no label
boxplot (weight ~ group, data = PlantGrowth, subset = group == "ctrl")
## with label
bx <- boxplot(weight ~ group, data = PlantGrowth,
              subset = group == "ctrl", plot = FALSE)
bxp(bx, show.names=TRUE)
par(op)

## passing gap.axis=* to axis(), PR#18109:
boxplot(matrix(100*rnorm(1e3), 50, 20),
        cex.axis = 1.5, gap.axis = -1)# showing *all* labels


z <- split(rnorm(1000), rpois(1000, 2.2))
boxplot(z, whisklty = 3, main = "boxplot(z, whisklty = 3)")

## Colour support similar to plot.default:
op <- par(mfrow = 1:2, bg = "light gray", fg = "midnight blue")
boxplot(z,   col.axis = "skyblue3", main = "boxplot(*, col.axis=..,main=..)")
plot(z[[1]], col.axis = "skyblue3", main =    "plot(*, col.axis=..,main=..)")
mtext("par(bg=\"light gray\", fg=\"midnight blue\")",
      outer = TRUE, line = -1.2)
par(op)

## Mimic S-Plus:
splus <- list(boxwex = 0.4, staplewex = 1, outwex = 1, boxfill = "grey40",
              medlwd = 3, medcol = "white", whisklty = 3, outlty = 1, outpch = NA)
boxplot(z, pars = splus)
## Recycled and "sweeping" parameters
op <- par(mfrow = c(1,2))
 boxplot(z, border = 1:5, lty = 3, medlty = 1, medlwd = 2.5)
 boxplot(z, boxfill = 1:3, pch = 1:5, lwd = 1.5, medcol = "white")
par(op)
## too many possibilities
boxplot(z, boxfill = "light gray", outpch = 21:25, outlty = 2,
        bg = "pink", lwd = 2,
        medcol = "dark blue", medcex = 2, medpch = 20)

作者

The R Core development team and Arni Magnusson (then at U Washington) who has provided most changes for the box*, med*, whisk*, staple*, and out* arguments.

参考

Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.