| peak_fit | R Documentation |
Fitting of a single spectral line by lineshape functions with variable parameters.
peak_fit(
x,
profile = "voigt",
wL = NULL,
wG = NULL,
A = NULL,
wavelength = NULL,
id = NULL,
max_iter = 200,
fixed = NULL,
max.iter = deprecated(),
wlgth.min = deprecated(),
wlgth.max = deprecated()
)
x |
A data frame or tibble of spectra, one spectrum per row. Column
names are the wavelengths (e.g. |
profile |
A character specifying the lineshape function to be used: "lorentzian", "gaussian", "voigt" (exact) or "pseudo_voigt". |
wL |
A numeric specifying the Lorentzian full width at half maximum (initial guess) |
wG |
A numeric specifying the Gaussian full width at half maximum (initial guess) |
A |
A numeric specifying the peak area (initial guess) |
wavelength |
The wavelength range of the fit, |
id |
A character specifying the name of the column holding the spectra id (optional) |
max_iter |
A numeric specifying the maximum number of iteration (200 by default) |
fixed |
The widths held at their given values ( |
max.iter, wlgth.min, wlgth.max |
The function uses minpack.lm::nlsLM, which is based on the Levenberg-Marquardt
algorithm for searching the minimum value of the square of the sum of the residuals.
Each spectrum (row of x) is fitted separately with the model
y = y_0 + A \cdot f(x; x_c, w)
where f is a unit-area Gaussian, Lorentzian, Voigt or pseudo-Voigt profile
(see gaussian_profile(), lorentzian_profile(), voigt_profile() and
pseudo_voigt_profile()). The fitted parameters are y0, xc, A and the
width(s) wG and/or wL (full widths at half maximum). The Voigt profile
is evaluated exactly in C++; the pseudo-Voigt (Thompson-Cox-Hastings)
approximation is faster but accurate to about 1\
Initial values that are not supplied are estimated from the data: the peak
center from the position of the maximum, the width from the full width at
half maximum, and the area from the integrated intensity above the minimum.
The center is constrained to the fitted wavelength range and the widths and
area to positive values. If the fit of a spectrum fails, a warning is issued
and the corresponding fit, tidied and augmented entries are NULL.
The Gaussian and Lorentzian widths of a Voigt profile are strongly
correlated, so a free fit determines the Lorentzian (Stark) width poorly
when the line is narrow. In a LIBS plasma, the Gaussian width is the
instrumental width, combined with the Doppler width in quadrature,
w_G = \sqrt{w_{inst}^2 + w_D^2}, and can be held fixed with
fixed = "wG" and the value of wG. The instrumental width is the width
of a line of a low-pressure lamp (mercury, argon), whose Stark and
Doppler widths are negligible, fitted with a Gaussian profile at a nearby
wavelength; the Doppler width is given by doppler_width(). A fixed width
is listed in tidied without standard error.
A tibble with one row per spectrum and the columns:
id column (or spectrum, the row number, when id = NULL),
data: the fitted data (x, y),
fit: the nls model object, of class specproc_peak_fit (see
tidy() and glance()),
tidied: the estimated parameters with their standard errors,
augmented: the data with fitted values (.fitted) and residuals (.resid).
Christian L. Goueguel
data(forageLIBS)
mean_spectrum <- colMeans(forageLIBS[-(1:14)])
wl <- as.numeric(names(mean_spectrum))
# the H-alpha line of the hydrogen of the samples, Stark-broadened
halpha <- tibble::as_tibble(as.list(mean_spectrum[wl > 653.5 & wl < 659.5]))
res <- peak_fit(halpha, profile = "lorentzian")
res$tidied[[1]]
# a Voigt line whose Gaussian width (instrument and Doppler) is known
x <- seq(395, 397, by = 0.01)
set.seed(1)
y <- voigt_profile(x, y0 = 10, xc = 396, wG = 0.08, wL = 0.05, A = 50) +
rnorm(length(x), sd = 2)
line <- tibble::as_tibble(as.list(stats::setNames(y, x)))
peak_fit(line, profile = "voigt", wG = 0.08, fixed = "wG")$tidied[[1]]
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.