| hotelling_t2 | R Documentation |
Computes Hotelling's T^2 statistic of each sample from its scores
on the first ncomp components of an embedding (such as PCA or PLS scores),
with its limits at one or more confidence levels, for all the samples
together or within groups, with HotellingEllipse::ellipseParam().
Samples beyond a limit are far from the center of the data (or of their
group) given its covariance: candidate outliers.
hotelling_t2(
data,
columns = NULL,
ncomp = 2,
group = NULL,
conf_level = 0.975,
method = "f",
k = deprecated()
)
data |
The embedding: a data frame, a matrix, a |
columns |
The components used: a character vector of column names.
By default, the first |
ncomp |
The number of components, when |
group |
An optional grouping: a column of |
conf_level |
The confidence level(s) of the limits: one or more values between 0 and 1. Default is 0.975. |
method |
The distribution of the limits: |
k |
T^2 is the squared Mahalanobis distance of a sample to the mean of
the scores, with their covariance. Its limit at the confidence level
1 - \alpha, for n samples and k components, is
method = "f" (default): k(n - 1)/(n - k)\, F_{1-\alpha}(k, n -
k), the conventional limit of score plots (Jackson, 1991);
method = "beta": (n - 1)^2/n\, B_{1-\alpha}(k/2, (n - k -
1)/2), the exact distribution for the samples that estimated the mean
and covariance (Tracy, Young and Mason, 1992); the F limit can even
exceed the largest T^2 a sample can reach, (n - 1)^2 / n,
for small n;
method = "new": k(n + 1)(n - 1)/(n(n - k))\, F_{1-\alpha}(k,
n - k), the exact limit for a new sample, independent of the estimates
(larger than the F limit by (n + 1)/n).
Within groups (group), each group gets its own mean, covariance and
limits, which tells whether a sample is typical of its own group rather
than of the whole data set; each group needs more than k + 1 samples.
The statistic uses the k components given, not only the two shown
on a plot: a sample can lie inside the ellipse of two components and
still exceed the limit in k dimensions. Classical estimates are themselves
sensitive to outliers; with many outliers, prefer the robust distances of
robpca().
A tibble with one row per sample: its row number sample, the
group (with group), t2, then for each confidence level (in %, e.g.
97.5) its limit limit_97.5 and whether the sample exceeds it,
outlier_97.5, and the number of samples n of its group (or of the
data).
Christian L. Goueguel
Hotelling, H. (1931). The generalization of Student's ratio. The Annals of Mathematical Statistics, 2(3):360-378.
Tracy, N.D., Young, J.C., Mason, R.L. (1992). Multivariate control charts for individual observations. Journal of Quality Technology, 24(2):88-95.
Jackson, J.E. (1991). A User's Guide to Principal Components. Wiley, New York.
plot_embedding(), q_residuals(), robpca()
if (rlang::is_installed("HotellingEllipse", version = "1.3.0")) {
data(forageLIBS)
# the 380-430 nm window (Ca II H and K lines)
wl <- suppressWarnings(as.numeric(names(forageLIBS)))
spectra <- forageLIBS[which(wl > 380 & wl < 430)]
pca <- stats::prcomp(spectra)
t2 <- hotelling_t2(pca, ncomp = 3)
t2[t2$outlier_97.5, ]
# two limits, with the exact distribution of the calibration samples
hotelling_t2(pca, ncomp = 3, conf_level = c(0.95, 0.99), method = "beta")
}
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.