| Qn {robustbase} | R Documentation |
Compute the robust scale estimator Qn, an efficient alternative to the MAD.
By default, Qn(x1, .., xn) is the k-th
order statistic (a quantile) of the choose(n, 2) absolute
differences abs(x[i] - x[j]),
(for 1 <= i < j <= n),
where by default (originally only possible value) k = choose(n\%/\% 2 + 1, 2)
which is about the first quartile (25% quantile) of these
pairwise differences. See the references for more.
Qn(x, constant = NULL, finite.corr = is.null(constant) && missing(k), k = choose(n %/% 2 + 1, 2), warn.finite.corr = TRUE) s_Qn(x, mu.too = FALSE, ...)
x |
numeric vector of observations. |
constant |
number by which the result is multiplied; the default
achieves consistency for normally distributed data. Note that until
Nov. 2010, “thanks” to a typo in the very first papers, a slightly
wrong default constant, 2.2219, was used instead of the correct one
which is equal to If you need the old slightly off version for historical
reproducibility, you can use Note that the relative difference is only about 1 in 1000, and that the correction should not affect the finite sample corrections for n <= 9. |
finite.corr |
logical indicating if the finite sample bias
correction factor should be applied. Defaults to |
k |
integer, typically half of n, specifying the “quantile”, i.e., rather the
order statistic that |
warn.finite.corr |
logical indicating if a |
mu.too |
logical indicating if the |
... |
potentially further arguments for |
As the (default, consistency) constant needed to be corrected, the finite sample correction has been based on a much more extensive simulation, and on a 3rd or 4th degree polynomial model in 1/n for odd or even n, respectively.
Qn() returns a number, the Qn robust scale
estimator, scaled to be consistent for σ^2 and
i.i.d. Gaussian observations, optionally bias corrected for finite
samples.
s_Qn(x, mu.too=TRUE) returns a length-2 vector with location
(μ) and scale; this is typically only useful for
covOGK(*, sigmamu = s_Qn).
Original Fortran code:
Christophe Croux and Peter Rousseeuw rousse@wins.uia.ac.be.
Port to C and R: Martin Maechler, maechler@R-project.org
Rousseeuw, P.J. and Croux, C. (1993) Alternatives to the Median Absolute Deviation, Journal of the American Statistical Association 88, 1273–1283. doi: 10.2307/2291267
Christophe Croux and Peter J. Rousseeuw (1992) A class of high-breakdown scale estimators based on subranges , Communications in Statistics - Theory and Methods 21, 1935–1951; doi: 10.1080/03610929208830889
Christophe Croux and Peter J. Rousseeuw (1992) Time-Efficient Algorithms for Two Highly Robust Estimators of Scale, Computational Statistics, Vol. 1, ed. Dodge and Whittaker, Physica-Verlag Heidelberg, 411–428; available via Springer Link.
About the typo in the constant:
Christophe Croux (2010)
Private e-mail, Fri Jul 16, w/ Subject
Re: Slight inaccuracy of Qn implementation .......
mad for the ‘most robust’ but much less efficient
scale estimator; Sn for a similar faster but less
efficient alternative. Finally, scaleTau2 which some
consider “uniformly” better than Qn or competitors.
set.seed(153)
x <- sort(c(rnorm(80), rt(20, df = 1)))
s_Qn(x, mu.too = TRUE)
Qn(x, finite.corr = FALSE)
## A simple pure-R version of Qn() -- slow and memory-rich for large n: O(n^2)
Qn0R <- function(x, k = choose(n %/% 2 + 1, 2)) {
n <- length(x <- sort(x))
if(n == 0) return(NA) else if(n == 1) return(0.)
stopifnot(is.numeric(k), k == as.integer(k), 1 <= k, k <= n*(n-1)/2)
m <- outer(x,x,"-")# abs not needed as x[] is sorted
sort(m[lower.tri(m)], partial = k)[k]
}
(Qx1 <- Qn(x, constant=1)) # 0.5498463
## the C-algorithm "rounds" to 'float' single precision ..
stopifnot(all.equal(Qx1, Qn0R(x), tol = 1e-6))
## -- compute for different 'k' :
n <- length(x) # = 100 here
(k0 <- choose(floor(n/2) + 1, 2)) # 51*50/2 == 1275
stopifnot(identical(Qx1, Qn(x, constant=1, k=k0)))
nn2 <- n*(n-1)/2
all.k <- 1:nn2
system.time(Qss <- sapply(all.k, function(k) Qn(x, 1, k=k)))
system.time(Qs <- Qn (x, 1, k = all.k))
system.time(Qs0 <- Qn0R(x, k = all.k) )
stopifnot(exprs = {
Qs[1] == min(diff(x))
Qs[nn2] == diff(range(x))
all.equal(Qs, Qss, tol = 1e-15) # even exactly
all.equal(Qs0, Qs, tol = 1e-7) # see 2.68e-8, as Qn() C-code rounds to (float)
})
plot(2:nn2, Qs[-1], type="b", log="y", main = "Qn(*, k), k = 2..n(n-1)/2")