adjbox(robustbase)
adjbox()所属R语言包：robustbase
Plot an Adjusted Boxplot for Skew Distributions
在斜分布，绘制调整后的盒形图
译者：生物统计家园网 机器人LoveR
描述----------Description----------
Produces boxplots adjusted for skewed distributions as proposed in Hubert and Vandervieren (2004).
产生调整偏斜分布在休伯特和Vandervieren的（2004）提出的盒状图。
用法----------Usage----------
adjbox(x, ...)
## S3 method for class 'formula'[类formula的方法]
adjbox(formula, data = NULL, ..., subset, na.action = NULL)
## Default S3 method:[默认方法]
adjbox(x, ..., range = 1.5, doReflect = FALSE,
width = NULL, varwidth = FALSE,
notch = FALSE, outline = TRUE, names, plot = TRUE,
border = par("fg"), col = NULL, log = "",
pars = list(boxwex = 0.8, staplewex = 0.5, outwex = 0.5),
horizontal = FALSE, add = FALSE, at = NULL)
参数----------Arguments----------
参数：formula
a formula, such as y ~ grp, where y is a numeric vector of data values to be split into groups according to the grouping variable grp (usually a factor).
一个公式，如y ~ grp，其中y是一个数字矢量被分成不同的小组根据分组变量grp（通常是一个因素的数据值）。
参数：data
a data.frame (or list) from which the variables in formula should be taken.
数据框（或列表）中的变量formula应采取。
参数：subset
an optional vector specifying a subset of observations to be used for plotting.
一个可选的矢量指定的观测值的一个子集被用于进行绘图。
参数：na.action
a function which indicates what should happen when the data contain NAs. The default is to ignore missing values in either the response or the group.
一个函数，它表示当数据包含NA的，应该发生什么。默认情况下是忽略遗漏值的响应或组。
参数：x
for specifying data from which the boxplots are to be produced. Either a numeric vector, or a single list containing such vectors. Additional unnamed arguments specify further data as separate vectors (each corresponding to a component boxplot). NAs are allowed in the data.
用于指定数据以产生从该盒形图。可以是数字型的向量，或含有这种向量的一个单独的列表。额外的未命名参数指定了进一步的数据作为独立的向量（每个对应一个组件的盒形图）。 “”NA的允许的数据。
参数：...
For the formula method, named arguments to be passed to the default method. For the default method, unnamed arguments are additional data vectors (unless x is a list when they are ignored), and named arguments are arguments and graphical parameters to be passed to bxp in addition to the ones given by argument pars (and override those in pars).
对于formula方法，命名参数被传递到默认的方法。对于未命名的参数是默认的方法，额外的数据向量（除非x是一个列表时，它们将被忽略），和命名参数的参数和图形，除了所给出的参数被传递给bxp参数pars（和覆盖pars）。
参数：range
this determines how far the plot whiskers extend out from the box, and is simply passed as argument coef to adjboxStats(). If range is positive, the whiskers extend to the most extreme data point which is no more than range times the interquartile range from the box. A value of zero causes the whiskers to extend to the data extremes.
这决定了多远的图晶须延长从包装盒中，并简单地通过参数coef到adjboxStats()。如果range是积极的，晶须延伸到最极端的不超过range倍的四分位数范围从包装盒中的数据点。零值，使晶须延伸到的数据极端。
参数：doReflect
logical indicating if the MC should also be computed on the reflected sample -x, and be averaged, see mc.
逻辑MC也可以反映样品-x计算，并进行平均，mc。
参数：width
a vector giving the relative widths of the boxes making up the plot.
一个向量给的框构成的图的相对宽度。
参数：varwidth
if varwidth is TRUE, the boxes are drawn with widths proportional to the square-roots of the number of observations in the groups.
如果varwidth是TRUE，包装盒上绘制宽度比例的平方根的若干意见组中的。
参数：notch
if notch is TRUE, a notch is drawn in each side of the boxes. If the notches of two plots do not overlap this is "strong evidence" that the two medians differ (Chambers et al., 1983, p. 62). See boxplot.stats for the calculations used.
如果notch是TRUE，一个凹口，在每一侧的框绘制。如果两个图的缺口不重叠，这是“强有力的证据”，这两个位数不同（Chambers等。，1983年，页62）。见boxplot.stats使用的计算。
参数：outline
if outline is not true, the outliers are not drawn (as points whereas S+ uses lines). </table>
如果outline是不正确的，没有画出的离群值（如百分点，而S +使用线）。 </ TABLE>
参数：names
group labels which will be printed under each boxplot.
组标签将被印在每一个盒形图。
参数：boxwex
a scale factor to be applied to all boxes. When there are only a few groups, the appearance of the plot can be improved by making the boxes narrower.
一个比例因子被应用到所有框。当有只有几组，通过使框窄，能够提高外观的图。
参数：staplewex
staple line width expansion, proportional to box width.
钉书机线的宽度扩张，框的宽度成正比。
参数：outwex
outlier line width expansion, proportional to box width.
离群线的宽度扩展，框的宽度成正比。
参数：plot
if TRUE (the default) then a boxplot is produced. If not, the summaries which the boxplots are based on are returned.
如果TRUE（默认值），然后产生一个盒形图。如果没有，返回该盒形图是基于摘要。
参数：border
an optional vector of colors for the outlines of the boxplots. The values in border are recycled if the length of border is less than the number of plots.
一个可选的向量颜色的盒状图的轮廓。中的值border循环再造的长度border是小于号图。
参数：col
if col is non-null it is assumed to contain colors to be used to colour the bodies of the box plots. By default they are in the background colour.
如果col是不空，它被假定为包含要使用的颜色机构的箱线图的颜色。默认情况下，它们中的背景颜色。
参数：log
character indicating if x or y or both coordinates should be plotted in log scale.
字符表示如果x或y两个坐标绘制在对数刻度。
参数：pars
a list of (potentially many) more graphical parameters, e.g., boxwex or outpch; these are passed to bxp (if plot is true); for details, see there.
许多潜在的更多的图形参数，例如，boxwex或outpch的列表;这些都传递给bxp（如果plot是真实的）;的详细信息，请参阅。
参数：horizontal
logical indicating if the boxplots should be horizontal; default FALSE means vertical boxes.
逻辑的盒状图应是水平的，默认的FALSE是指垂直框。
参数：add
logical, if true add boxplot to current plot.
逻辑，如果是真的盒形图到当前的图。
参数：at
numeric vector giving the locations where the boxplots should be drawn, particularly when add = TRUE; defaults to 1:n where n is the number of boxes.
数字矢量给予的盒状图应绘制的地方，特别是当add = TRUE;默认为1:n其中n的箱数。
Details
详细信息----------Details----------
The generic function adjbox currently has a default method (adjbox.default) and a formula interface (adjbox.formula).
通用功能adjbox目前有一个默认的方法（adjbox.default）和公式接口（adjbox.formula）。
If multiple groups are supplied either as multiple arguments or via a formula, parallel boxplots will be plotted, in the order of the arguments or the order of the levels of the factor (see factor).
如果有多个团体提供多个参数，或通过一个公式，平行的盒状图绘制中的参数顺序的顺序水平的因素（见factor）。
Missing values are ignored when forming boxplots.
形成盒状图时，遗漏值将被忽略。
Extremes of the upper and whiskers of the adjusted boxplots are computed using the medcouple (mc()), a robust measure of skewness. For details, cf. TODO
极端的上部和晶须的调整后的盒状图计算使用的medcouple（mc()），一个强大的措施的偏度。有关详细信息，比照。 TODO
值----------Value----------
A list with the following components:
Alist以下组件：
参数：stats
a matrix, each column contains the extreme of the lower whisker, the lower hinge, the median, the upper hinge and the extreme of the upper whisker for one group/plot. If all the inputs have the same class attribute, so will this component.
一个矩阵，每一列都包含在极端情况下晶须，下铰链，中位数，上铰链和极端上晶须为一组/图。如果所有的输入具有相同的类属性，所以将这个组件。
参数：n
a vector with the number of observations in each group.
与观测值的数量在各组的向量。
参数：coef
a matrix where each column contains the lower and upper extremes of the notch.
一个矩阵，其中的每一列包含的凹口的下部和上部的极端。
参数：out
the values of any data points which lie beyond the extremes of the whiskers.
在于超越极端的晶须任何数据点的值。
参数：group
a vector of the same length as out whose elements indicate to which group the outlier belongs.
满分的长度相同，其元素表示离群值属于哪个组的向量。
参数：names
a vector of names for the groups.
的矢量的组的名称。
注意----------Note----------
The code and documentation only slightly modifies the code of boxplot.default, boxplot.formula and boxplot.stats
代码和文档只稍微修改代码的boxplot.default，boxplot.formula和boxplot.stats
（作者）----------Author(s)----------
R Core Development Team, slightly adapted by Tobias Verbeke
参考文献----------References----------
An adjusted boxplot for skewed distributions, in: Antoch, J., ed. (2004). Proceedings in Computational Statistics 2004; Heidelberg: Springer-Verlag, 1933–1940.
An Adjusted Boxplot for Skewed Distributions, Technical Report TR-06-11, KU Leuven, Section of Statistics, Leuven. <br> http://wis.kuleuven.be/stat/robust/Papers/TR0611.pdf
参见----------See Also----------
The medcouple, mc; boxplot.
的medcouple，mc的boxplot。
实例----------Examples----------
if(getRversion() >= "2.9.0" && require("boot")) {
### Hubert and Vandervieren (2006), p. 10, Fig. 4.[＃Hubert和Vandervieren（2006年），页。图10，图4。]
data(coal, package = "boot")
coaldiff <- diff(coal$date)
op <- par(mfrow = c(1,2))
boxplot(coaldiff, main = "Original Boxplot")
adjbox(coaldiff, main = "Adjusted Boxplot")
par(op)
}
### Hubert and Vandervieren (2006), p. 11, Fig. 6. -- enhanced[＃Hubert和Vandervieren（2006年），页。 11，图6。 - 增强]
op <- par(mfrow = c(2,2), mar = c(1,3,3,1), oma = c(0,0,3,0))
with(condroz, {
boxplot(Ca, main = "Original Boxplot")
adjbox (Ca, main = "Adjusted Boxplot")
boxplot(Ca, main = "Original Boxplot [log]", log = "y")
adjbox (Ca, main = "Adjusted Boxplot [log]", log = "y")
})
mtext("'Ca' from data(condroz)",
outer=TRUE, font = par("font.main"), cex = 2)
par(op)
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-9-27 22:05:54
