libs_lines: Candidate Emission Lines for LIBS Spectra

View source: R/libs_lines.R

libs_linesR Documentation

Candidate Emission Lines for LIBS Spectra

Description

Lists the lines of the selected atoms and ions that are expected to be the strongest in a plasma at a given temperature, from the NIST Atomic Spectra Database, to help identify the emission lines of a spectrum.

Usage

libs_lines(
  species,
  wavelength = c(200, 900),
  temperature = 10000,
  top = 20,
  min_relative = 0,
  timeout = 120
)

Arguments

species

A character vector of emitters in spectroscopic notation, such as c("Ca I", "Ca II", "Mg I").

wavelength

A numeric vector of length 2: the wavelength range, in nm. Default is 200 to 900 nm.

temperature

The plasma temperature, in K. Default is 10000.

top

The maximum number of lines kept per species. Default is 20.

min_relative

The minimum relative intensity of the lines kept, between 0 and 1. Default is 0.

timeout

The download timeout, in seconds. Default is 120.

Details

For each species, the lines with a transition probability are retrieved with nist_lines() (and cached for the R session). Their relative intensities in a plasma in local thermodynamic equilibrium at temperature T are

I \propto \frac{g_k A_{ki}}{\lambda} \exp\left(-\frac{E_k}{k_B T}\right)

normalized to the strongest line of the species in the range. The intensities are relative within each species: comparing species would need their concentrations and, between ionization stages, the Saha equation. Self-absorption, which weakens resonance lines, is ignored.

The top strongest lines of each species with a relative intensity of at least min_relative are kept. plot_lines() overlays them on a spectrum, and line_finder() does so interactively.

Value

A tibble with one row per line, sorted by wavelength, and columns species, element, stage (1 for neutral atoms, 2 for singly charged ions, ...), wavelength (nm), relative_intensity, Aki, Ek, gk, accuracy, lower and upper. Species without lines in the range contribute no rows.

Author(s)

Christian L. Goueguel

See Also

plot_lines(), line_finder(), nist_lines()

Examples


# needs an internet connection; gives up after 20 s if NIST does not answer
lines <- try(libs_lines(c("Ca I", "Ca II"), wavelength = c(390, 450), top = 5,
                        timeout = 20))
if (!inherits(lines, "try-error")) lines


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