Variogram.lme(nlme)
Variogram.lme()所属R语言包：nlme
Calculate Semi-variogram for Residuals from an lme Object
计算半变差函数从LME对象的残差
译者：生物统计家园网 机器人LoveR
描述----------Description----------
This method function calculates the semi-variogram for the within-group residuals from an lme fit. The semi-variogram values are calculated for pairs of residuals within the same group. If collapse is different from "none", the individual semi-variogram values are collapsed using either a robust estimator (robust = TRUE) defined in Cressie (1993), or the average of the values within the same distance interval. The semi-variogram is useful for modeling the error term correlation structure.
这种方法函数计算lme适合组内残差半变差。对同一组内的残差计算的半变异函数值。如果collapse从"none"是不同的，个别的半变异函数值使用一个强大的估计（robust = TRUE）中，Cressie（1993），或值的平均值定义在倒塌同样的距离间隔。半变异函数建模误差项相关结构非常有用。
用法----------Usage----------
## S3 method for class 'lme'
Variogram(object, distance, form, resType, data,
na.action, maxDist, length.out, collapse, nint, breaks,
robust, metric, ...)
参数----------Arguments----------
参数：object
an object inheriting from class lme, representing a fitted linear mixed-effects model.
一个对象从lme类代表拟合的线性混合效应模型，继承。
参数：distance
an optional numeric vector with the distances between residual pairs. If a grouping variable is present, only the distances between residual pairs within the same group should be given. If missing, the distances are calculated based on the values of the arguments form, data, and metric, unless object includes a corSpatial element, in which case the associated covariate (obtained with the getCovariate method) is used.
一个可选的数字矢量残留对之间的距离。如果分组变量是存在的，只有对同一组内的残余之间的距离应给予。如果缺少，距离计算的参数值form，data，metric，除非objectcorSpatial元素，在其中情况的相关协变量（与getCovariate方法获得）使用。
参数：form
an optional one-sided formula specifying the covariate(s) to be used for calculating the distances between residual pairs and, optionally, a grouping factor for partitioning the residuals (which must appear to the right of a | operator in form). Default is ~1, implying that the observation order within the groups is used to obtain the distances.
可选片面指定的协变量（S）被用来计算剩余对，并可选择一个分区的残差（必须出现|运营商的权利，在分组因素之间的距离公式form）。默认是~1，这意味着，用于获取的距离内观察组顺序。
参数：resType
an optional character string specifying the type of residuals to be used. If "response", the "raw" residuals (observed - fitted) are used; else, if "pearson", the standardized residuals (raw residuals divided by the corresponding standard errors) are used; else, if "normalized", the normalized residuals (standardized residuals pre-multiplied by the inverse square-root factor of the estimated error correlation matrix) are used. Partial matching of arguments is used, so only the first character needs to be provided. Defaults to "pearson".
一个可选的字符串指定要使用的残差类型。如果"response"，“原始”的残差（观测 - 拟合）;否则，如果"pearson"，标准化残差的（原料残差除以相应的标准误差）;否则，如果 "normalized"，用于归残差（标准化残差估计误差相关矩阵的逆平方根因素预乘）。使用部分匹配的参数，所以才有了第一个字符需要提供。 "pearson"默认。
参数：data
an optional data frame in which to interpret the variables in form. By default, the same data used to fit object is used.
在解释变量form可选的数据框。默认情况下，使用相同的数据，以适应object使用。
参数：na.action
a function that indicates what should happen when the data contain NAs. The default action (na.fail) causes an error message to be printed and the function to terminate, if there are any incomplete observations.
一个函数，它表示数据时，包含NA的，应该发生什么。默认动作（na.fail）导致要打印一个错误信息和功能终止，如果有任何不完整的意见。
参数：maxDist
an optional numeric value for the maximum distance used for calculating the semi-variogram between two residuals. By default all residual pairs are included.
一个可选的数值用于计算之间的两个残差半变差的最大距离。默认情况下，对所有剩余的都包括在内。
参数：length.out
an optional integer value. When object includes a corSpatial element, its semi-variogram values are calculated and this argument is used as the length.out argument to the corresponding Variogram method. Defaults to 50.
一个可选的整型值。当objectcorSpatial元素，其半变异函数值的计算和length.out参数相应的Variogram方法使用此参数。 50默认。
参数：collapse
an optional character string specifying the type of collapsing to be applied to the individual semi-variogram values. If equal to "quantiles", the semi-variogram values are split according to quantiles of the distance distribution, with equal number of observations per group, with possibly varying distance interval lengths. Else, if "fixed", the semi-variogram values are divided according to distance intervals of equal lengths, with possibly different number of observations per interval. Else, if "none", no collapsing is used and the individual semi-variogram values are returned. Defaults to "quantiles".
一个可选的字符串指定的倒塌被应用到个人的半变异函数值的类型。如果等于"quantiles"，半变异函数值分割根据距离分布的分位数，每个组的意见的人数相等，可能不同的距离间隔长度。否则，如果"fixed"，半变异函数值按相同长度的距离间隔，可能具有不同的每个时间间隔的观测数。否则，如果"none"，没有倒塌的使用和个别半变异函数值返回。 "quantiles"默认。
参数：nint
an optional integer with the number of intervals to be used when collapsing the semi-variogram values. Defaults to 20.
倒塌的半变差函数值时要使用可选的整数间隔数。 20默认。
参数：robust
an optional logical value specifying if a robust semi-variogram estimator should be used when collapsing the individual values. If TRUE the robust estimator is used. Defaults to FALSE.
倒塌个人价值时，应使用一个可选的逻辑值，如果指定一个健壮的半变差估计。如果TRUE鲁棒估计。 FALSE默认。
参数：breaks
an optional numeric vector with the breakpoints for the distance intervals to be used in collapsing the semi-variogram values. If not missing, the option specified in collapse is ignored.
一个可选的数字距离间隔断点向量，将用于在倒塌的半变差函数值。如果不缺，指定在collapse选项被忽略。
参数：metric
an optional character string specifying the distance metric to be used. The currently available options are "euclidean" for the root sum-of-squares of distances; "maximum" for the maximum difference; and "manhattan" for the sum of the absolute differences. Partial matching of arguments is used, so only the first three characters need to be provided. Defaults to "euclidean".
一个可选的字符串指定要使用的距离度量。目前可用的选项"euclidean"的距离平方和的根;"maximum"最大的区别;"manhattan"绝对差异的总和。部分参数的匹配使用，所以只有前三个字符需要提供。 "euclidean"默认。
参数：...
some methods for this generic require additional arguments. None are used in this method.
这个通用的一些方法需要额外的参数。没有使用这种方法。
值----------Value----------
a data frame with columns variog and dist representing, respectively, the semi-variogram values and the corresponding distances. If the semi-variogram values are collapsed, an extra column, n.pairs, with the number of residual pairs used in each semi-variogram calculation, is included in the returned data frame. If object includes a corSpatial element, a data frame with its corresponding semi-variogram is included in the returned value, as an attribute "modelVariog". The returned value inherits from class Variogram.
与列variog和dist代表，分别为，半变异函数值和相应的距离数据框。如果倒塌的半变异函数值，一个额外的列，n.pairs，每半变差函数的计算中使用的剩余对数，包括在返回的数据框。 object如果包括corSpatial元素，其相应的半变差的数据框包含在返回的值作为属性"modelVariog"。返回值继承自类Variogram。
作者（S）----------Author(s)----------
Jose Pinheiro and Douglas Bates <a href="mailto:bates@stat.wisc.edu">bates@stat.wisc.edu</a>
参考文献----------References----------
参见----------See Also----------
lme, Variogram, Variogram.default, Variogram.gls, plot.Variogram
lme，Variogram，Variogram.default，Variogram.gls，plot.Variogram
举例----------Examples----------
fm1 <- lme(weight ~ Time * Diet, data=BodyWeight, ~ Time | Rat)
Variogram(fm1, form = ~ Time | Rat, nint = 10, robust = TRUE)
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-2-16 22:05:21
