Nothing
#' @title Multiplicative Signal Correction
#'
#' @author Christian L. Goueguel
#'
#' @description
#' This function performs multiplicative scatter/signal correction (MSC) on an
#' input data of spectra. It corrects for multiplicative and additive effects
#' in the spectral data by regressing against a reference spectrum.
#'
#' @details
#' Each spectrum \eqn{\textbf{x}_i} is regressed against the reference spectrum,
#' \eqn{\textbf{x}_i = a_i + b_i \textbf{x}_{ref} + \textbf{e}_i}, and corrected as
#' \eqn{(\textbf{x}_i - a_i) / b_i}. When `window` is given, the regression and
#' correction are carried out separately in each spectral window (piecewise MSC);
#' variables outside all windows are left unchanged.
#'
#' To correct new spectra consistently, pass the returned `reference` as `xref`.
#'
#' @param x A numeric matrix or data frame containing the input spectra.
#' Each row represents a sample, and each column represents a spectral variable.
#' @param xref An optional numeric vector representing the reference spectrum.
#' If `NULL` (default), the mean or median of `x` is used as the reference.
#' @param drop_offset A logical value indicating whether the additive offset
#' \eqn{a_i} should be removed from the spectra (default is `TRUE`). If `FALSE`,
#' only the multiplicative effect is corrected: \eqn{\textbf{x}_i / b_i}.
#' @param robust A logical value indicating whether the median (`TRUE`, default)
#' or the mean (`FALSE`) of `x` is used as `xref`.
#' @param window An optional list of numeric vectors specifying the column indices of
#' spectral windows. If provided, MSC is performed separately for each window.
#' @param drop_na A logical value indicating whether to remove spectra (rows)
#' containing missing values. If `TRUE` (the default), such rows are removed.
#' @param drop.offset,drop.na `r lifecycle::badge("deprecated")` Use `drop_offset` and `drop_na`.
#'
#' @return A list with the following components:
#' \item{`correction`}{The corrected spectra.}
#' \item{`offset`}{The intercepts/offsets \eqn{a_i} (a matrix with one column per window when `window` is given).}
#' \item{`slope`}{The multiplicative scatter factors/slopes \eqn{b_i} (a matrix with one column per window when `window` is given).}
#' \item{`reference`}{The reference spectrum used.}
#'
#' @export msc
#'
#' @examples
#' data(forageLIBS)
#' spectra <- forageLIBS[-(1:14)] # the spectral channels
#' res <- msc(spectra)
#' res$correction[1:3, 1:4]
msc <- function(
x,
xref = NULL,
drop_offset = TRUE,
robust = TRUE,
window = NULL,
drop_na = TRUE,
drop.offset = deprecated(), drop.na = deprecated()) {
drop_offset <- renamed_arg(drop.offset, drop_offset, "msc", "drop.offset", "drop_offset")
drop_na <- renamed_arg(drop.na, drop_na, "msc", "drop.na", "drop_na")
if (missing(x)) {
stop("Missing 'x' argument.")
}
x <- as_numeric_matrix(x, "x")
if (!is.null(xref) && (!is.numeric(xref) || length(xref) != ncol(x))) {
stop("'xref' must be a numeric vector of the same length as the number of columns in 'x'.")
}
if (!is.logical(drop_offset)) {
stop("'drop_offset' must be a logical value (TRUE or FALSE).")
}
if (!is.logical(robust)) {
stop("'robust' must be a logical value (TRUE or FALSE).")
}
if (!is.logical(drop_na)) {
stop("'drop_na' must be a logical value (TRUE or FALSE).")
}
if (drop_na) {
x <- x[stats::complete.cases(x), , drop = FALSE]
} else if (anyNA(x)) {
stop("'x' contains missing values; set 'drop_na = TRUE' to remove them.")
}
if (nrow(x) < 1) {
stop("'x' has no complete spectra.")
}
if (is.null(xref)) {
xref <- if (robust) col_medians(x) else colMeans(x)
}
xref <- as.numeric(xref)
if (is.null(window)) {
window <- list(seq_len(ncol(x)))
} else {
if (!is.list(window)) {
window <- list(window)
}
ok <- vapply(window, function(w) is.numeric(w) && length(w) >= 2 &&
all(w %in% seq_len(ncol(x))), logical(1))
if (!all(ok)) {
stop("'window' must be a list of column index vectors, each of length >= 2.")
}
}
sx <- x
offset <- slope <- matrix(NA_real_, nrow(x), length(window))
for (k in seq_along(window)) {
w <- window[[k]]
r <- xref[w]
rc <- r - mean(r)
if (sum(rc^2) == 0) {
stop("The reference spectrum is constant within a window.")
}
xw <- x[, w, drop = FALSE]
b <- drop(sweep(xw, 1, rowMeans(xw)) %*% rc) / sum(rc^2)
a <- rowMeans(xw) - b * mean(r)
sx[, w] <- if (drop_offset) (xw - a) / b else xw / b
offset[, k] <- a
slope[, k] <- b
}
if (length(window) == 1) {
offset <- drop(offset)
slope <- drop(slope)
}
res <- list(
"correction" = as_tbl(sx, colnames(x)),
"offset" = offset,
"slope" = slope,
"reference" = xref
)
return(res)
}
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.