生成给定（分组）值的盒须图。

公式，例如 y ~ grp ，其中 y 是要根据分组变量 grp （通常是一个因子）分成组的数据值的数值向量。请注意， ~ g1 + g2 相当于 g1:g2 。

应从中获取 formula 中的变量的 data.frame（或列表）。

一个可选向量，指定用于绘图的观测值子集。

一个函数，指示当数据包含 NA 时应该发生什么。默认设置是忽略响应或组中的缺失值。

x 轴和 y 轴注释，自 R 3.6.0 起具有非空默认值。可以用 ann=FALSE 抑制。

logical 指示是否应注释轴（通过 xlab 和 ylab ）。

传递到 split.default ，请参阅那里。

用于指定要生成箱线图的数据。数字向量或包含此类向量的单个列表。其他未命名参数将更多数据指定为单独的向量（每个向量对应于一个分量箱线图）。数据中允许使用 NA 。

对于 formula 方法，要传递给默认方法的命名参数。

对于默认方法，未命名参数是附加数据向量（除非 x 在被忽略时是一个列表），命名参数是除了参数 pars 给出的参数之外还要传递给 bxp 的参数和 graphical parameters （并覆盖 pars 中的参数） ）。请注意， bxp 可能会也可能不会使用它传递的图形参数：请参阅其文档。

这决定了图须从盒子中延伸出多远。如果 range 为正，须线会延伸到最极端的数据点，该数据点不超过 range 乘以盒子的四分位距。值为零会导致须线延伸至数据极值。

给出构成绘图的框的相对宽度的向量。

如果 varwidth 是 TRUE ，则绘制框的宽度与组中观测值数量的平方根成正比。

如果 notch 是 TRUE ，则在方框的每一侧绘制一个凹口。如果两个图的缺口不重叠，则这是两个中位数不同的“有力证据”（Chambers 等，1983，第 62 页）。有关使用的计算，请参阅 boxplot.stats 。

如果 outline 不为 true，则不会绘制离群值（作为点，而 S+ 使用线）。

将在每个箱线图下打印的组标签。可以是字符向量或 expression （请参阅 plotmath ）。

应用于所有框的比例因子。当只有几个组时，可以通过使框变窄来改善绘图的外观。

订书钉线宽度扩展，与框宽度成正比。

离群线宽度扩展，与框宽度成正比。

如果是 TRUE （默认），则会生成箱线图。如果不是，则返回箱线图所基于的摘要。

箱线图轮廓的可选颜色向量。如果 border 的长度小于绘图数，则回收 border 中的值。

如果 col 非空，则假定包含用于为箱线图主体着色的颜色。默认情况下，它们采用背景颜色。

指示 x 或 y 或两个坐标是否应以对数刻度绘制的字符。

（可能有很多）更多图形参数的列表，例如 boxwex 或 outpch ；这些被传递给 bxp （如果 plot 为 true）；详情请参阅此处。

逻辑表明箱线图是否应该是水平的；默认 FALSE 表示垂直盒子。

逻辑上，如果 true 将箱线图添加到当前绘图。

给出应绘制箱线图的位置的数值向量，特别是当 add = TRUE 时；默认为 1:n ，其中 n 是箱子数量。

通用函数 boxplot 目前具有默认方法 ( boxplot.default ) 和公式接口 ( boxplot.formula )。

如果多个组作为多个参数或通过公式提供，则将按照参数的顺序或因子水平的顺序绘制平行箱线图（请参阅 factor ）。

形成箱线图时将忽略缺失值。

包含以下组件的列表：

一个矩阵，每列包含一组/图的下须线的极值、下铰链、中值、上铰链和上须线的极值。如果所有输入都具有相同的类属性，则该组件也将具有相同的类属性。

一个向量，其中包含每组中的（非 NA ）观察值数量。

一个矩阵，其中每列包含凹口的下限和上限。

超出晶须极限的任何数据点的值。

与 out 长度相同的向量，其元素指示异常值属于哪个组。

组名称的向量。

贝克尔 (RA)、钱伯斯 (JM) 和威尔克斯 (AR) (1988)。新S语言。沃兹沃斯和布鲁克斯/科尔。

Chambers, JM、克利夫兰, WS、Kleiner, B. 和 Tukey, PA (1983)。数据分析的图形方法。沃兹沃斯和布鲁克斯/科尔。

马雷尔，P.（2005）。 R 显卡。Chapman & Hall/C R C 出版社。

另请参见 boxplot.stats 。

boxplot.stats 用于计算， bxp 用于绘图和更多示例；和 stripchart 作为替代方案（具有小数据集）。