ds: Direct Standardization

View source: R/transfer.R

dsR Documentation

Direct Standardization

Description

Transfers spectra from a secondary instrument to the primary instrument, on which the calibration model was built, by direct standardization (DS; Wang et al., 1991): a linear map of the whole secondary spectrum onto the whole primary spectrum, estimated on transfer samples measured on both instruments.

Usage

ds(x1, x2, ncomp = NULL, tol = 1e-08)

Arguments

x1

The spectra of the transfer samples on the primary instrument: a numeric matrix or data frame, one spectrum per row.

x2

The spectra of the same samples, in the same order, on the secondary instrument.

ncomp

The number of singular vectors of the secondary spectra kept. By default, all those with a singular value above tol times the largest.

tol

The relative tolerance on the singular values. Default is 1e-8.

Details

With the transfer spectra centered by the mean of each instrument, \textbf{X}_1 \approx \textbf{X}_2 \textbf{F}, and the transfer matrix is \textbf{F} = \textbf{X}_2^{+} \textbf{X}_1, where \textbf{X}_2^{+} is the pseudo-inverse of the secondary spectra, truncated to their first ncomp singular vectors. A new secondary spectrum is transferred as \bar{x}_1 + (x_2 - \bar{x}_2) \textbf{F}.

With as many components as the transfer samples allow (ncomp = NULL), the transfer spectra are reproduced exactly, and the noise of the secondary spectra is amplified: fewer components give a smoother, more robust transfer. Unlike pds(), DS mixes all wavelengths, so it corrects global differences of the response but needs more transfer samples. The transfer matrix (p \times p) is kept in factored form, as ncomp columns of each factor.

Value

An object of class specproc_transfer. Use predict() to transfer secondary spectra.

Author(s)

Christian L. Goueguel

References

  • Wang, Y., Veltkamp, D.J., Kowalski, B.R. (1991). Multivariate instrument standardization. Analytical Chemistry, 63(23):2750-2756.

See Also

pds(), sst(), slope_bias(), predict.specproc_transfer()

Examples

data(forageLIBS)
wl <- suppressWarnings(as.numeric(names(forageLIBS)))
spectra <- as.matrix(forageLIBS[which(wl > 760 & wl < 780)])  # the K I lines
# a second instrument, with a shifted and less sensitive response
secondary <- 0.8 * cbind(spectra[, -1], spectra[, ncol(spectra)]) + 50
transfer <- ds(spectra[1:30, ], secondary[1:30, ], ncomp = 10)
transfer
# the other samples, measured on the secondary, transferred to the primary
transferred <- predict(transfer, secondary[31:368, ])
mean(abs(transferred - spectra[31:368, ])) / mean(spectra)

specProc documentation built on Nov. 20, 2026, 5:11 p.m.