View source: R/multipeak_fit.R
| multipeak_fit | R Documentation |
Fitting of multiple spectral lines by the same or different lineshape functions with variable parameters.
multipeak_fit(
x,
peaks,
profiles,
wL = NULL,
wG = NULL,
A = NULL,
wavelength = NULL,
id = NULL,
max_iter = 200,
fixed = NULL,
lock_centers = FALSE,
share_widths = FALSE,
area_ratios = 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; an optional identifier column can be given
with |
peaks |
A numeric vector of the (approximate) peak center wavelengths. |
profiles |
A character vector of the lineshape functions for fitting, one per peak or a single one used for all peaks: "lorentzian", "gaussian", "voigt" (exact) or "pseudo_voigt" (case insensitive). |
wL |
A numeric (single value or one per peak) of the Lorentzian full width at half maximum (initial guess) |
wG |
A numeric (single value or one per peak) of the Gaussian full width at half maximum (initial guess) |
A |
A numeric (single value or one per peak) of 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 ( |
lock_centers |
Keep the separations of |
share_widths |
Share the widths of the lines (see details): |
area_ratios |
The fixed relative areas of the lines, one per peak
( |
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.
All peaks are fitted simultaneously with a common baseline offset:
y = y_0 + \sum_{i} A_i \cdot f_i(x; x_{c,i}, w_i)
The parameters of peak i are named with the suffix _i
(e.g. xc_1, wG_1, A_1). Initial values that are not supplied are
estimated from the data around each peak center. Each peak center is
constrained to lie within the fitted wavelength range.
The lines of a multiplet, or of a fine-structure doublet, are related, and constraints make the fit of overlapping lines much more stable:
lock_centers: the lines keep the separations of their peaks
(accurate wavelengths, such as those of the NIST database) and move
together by one fitted shift, which also absorbs an offset of the
wavelength axis. The shift is listed in tidied as shift (or
shift_1_2, ..., named by its lines, when there are several groups).
share_widths: the lines share their Gaussian and Lorentzian widths,
as lines of the same multiplet have nearly the same Stark width.
area_ratios: the areas of the lines are in fixed ratios, with one
fitted area. In an optically thin plasma in LTE, the ratio of two
lines is g_k A_{ki} \lambda^{-1} \exp(-E_k / k_B T) (energy
units), independent of the temperature for lines from the same upper
level: the relative_intensity of libs_lines(). Self-absorbed lines,
such as resonance lines, break these ratios.
lock_centers and share_widths take TRUE (all lines), a logical
vector (the lines constrained together) or one group label per line
(NA for a line left free), so that, for example, a multiplet can be
constrained while an interfering line of another element is not.
area_ratios gives a ratio per line, NA for a line with a free area.
tidied lists the center, widths and area of every line (named with the
suffix _i), with standard errors propagated from the fitted parameters:
lines that share a parameter have the same width, or centers that differ
by a constant.
A tibble with one row per spectrum and the columns id (or
spectrum), data, fit, tidied and augmented (see peak_fit()).
augmented additionally contains one column per peak (.peak_1, ...)
with the contribution of each fitted line.
Christian L. Goueguel
data(forageLIBS)
mean_spectrum <- colMeans(forageLIBS[-(1:14)])
wl <- as.numeric(names(mean_spectrum))
# the overlapping lines of the K I doublet
doublet <- tibble::as_tibble(as.list(mean_spectrum[wl > 404.1 & wl < 405.0]))
res <- multipeak_fit(doublet, peaks = c(404.414, 404.721), profiles = "gaussian")
res$tidied[[1]]
# the same doublet with the NIST separation of its lines and a common width
res <- multipeak_fit(doublet, peaks = c(404.414, 404.721), profiles = "gaussian",
lock_centers = TRUE, share_widths = TRUE)
res$tidied[[1]]
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.