View source: R/plot_robust_pca.R
| plot_cell_map | R Documentation |
Shows which cells of the data deviate from a macropca() or cellpca()
fit: one row
per observation, the variables (wavelengths) along the horizontal axis,
and the flagged cells colored red when the observed value is higher than
the fit and blue when it is lower. A strip on the right shows the outlier
type of each observation, and a panel on top the share of flagged cells
at each wavelength over the mean spectrum, with the most flagged regions
labeled, which shows which emission lines hold the cellwise outliers.
plot_cell_map(
object,
rows = NULL,
columns = NULL,
resolution = c(200, 400),
order = c("data", "od", "cluster"),
profile = TRUE,
spectra = NULL,
threshold = 0.1,
labels = 5,
lines = NULL,
tol = 0.1,
title = NULL,
wavelength = NULL,
xlab = NULL,
ylab = NULL,
base_size = 11
)
object |
An object returned by |
rows, columns |
Optional indices or names of the rows and columns to show. Default is all. |
resolution |
The maximum numbers of rows and columns of blocks.
Default is |
order |
The order of the rows: |
profile |
If |
spectra |
Optional spectra whose mean is drawn behind the profile (a data frame or matrix with the variables of the model, other columns being ignored, or a single named spectrum). Default is the data imputed by the fit. |
threshold |
The share of flagged observations above which channels form a flagged region. Default is 0.1. |
labels |
The number of flagged regions labeled in the profile. Default is 5; use 0 for none. |
lines |
Optional line list returned by |
tol |
The largest distance, in nm, between a region and a line it matches. Default is 0.1. |
title |
The plot title. Default is "MacroPCA cell map" or "cellPCA cell map". |
wavelength |
Optional ( |
xlab, ylab |
The axis titles of the map. Default are
|
base_size |
The size of the text, in points. Default is 11. |
Resolution. Spectra have many more cells than a plot has pixels, so
adjacent cells are combined into blocks: the numbers of rows and columns
of blocks are at most resolution, and a map smaller than that shows
every cell. Channels are combined only within a detector segment, and the
gaps between segments stay empty. The map fills the plot area, whatever
the numbers of observations and variables.
Colors. A flagged cell with standardized residual r has an
intensity that grows with \log(|r|/c), from 0.25 at the flagging
cut-off c to 1 at 10c and beyond. The color of a block is the
mean of these signed intensities over its cells (0 for cells that are not
flagged), on a square-root scale so that blocks with a few flagged cells
remain visible: pale blocks have few or mixed flagged cells, saturated
blocks many cells that deviate strongly in the same direction.
Order. With order = "cluster", the observations are sorted by a
hierarchical clustering (Ward's method) of their flagged cells, at the
column resolution of the map, so that observations that deviate in the
same regions form bands (for example, a batch or a type of matrix).
Profile. The top panel shows, for each variable, the share of the
(shown) observations whose cell is flagged: above zero when higher than
the fit, below zero when lower. The mean spectrum is drawn in grey
behind it, rescaled, to show whether the flagged channels are on emission
lines, on the continuum or in noise. It is the mean of spectra or, by
default, of the data imputed by the fit; it is left out when this mean
is close to zero, as for centered data (then give the raw spectra in
spectra). The dashed lines are at threshold, and the labels flagged
regions with the largest share (see flagged_regions()) are labeled with
their peak wavelength, or with the emission line they match.
A patchwork (ggplot2) object.
Christian L. Goueguel
flagged_regions(), macropca(), plot_outlier_map()
data(forageLIBS)
# the 380-430 nm window (Ca II H and K lines), faster than all the channels
wl <- suppressWarnings(as.numeric(names(forageLIBS)))
spectra <- forageLIBS[which(wl > 380 & wl < 430)]
set.seed(1)
fit <- macropca(center(spectra), ncomp = 3)
if (requireNamespace("patchwork", quietly = TRUE)) {
plot_cell_map(fit, order = "cluster")
# the Ca II H and K lines
plot_cell_map(fit, wavelength = c(390, 400), order = "od")
}
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.