read_vald: Stark Widths from VALD3 and Kurucz Line Lists

View source: R/stark_line_lists.R

read_valdR Documentation

Stark Widths from VALD3 and Kurucz Line Lists

Description

Reads the quadratic Stark damping constants of a line list saved from the Vienna Atomic Line Database (VALD3) or from the line lists of R. L. Kurucz, as a table of Stark widths in the format of starkb_lines(), for stark_width() and electron_density(). These line lists give a width for many lines that STARK-B does not have, but a cruder one.

Usage

read_vald(
  file,
  species = NULL,
  wavelength = NULL,
  temperature = c(2500, 5000, 10000, 20000, 40000)
)

read_kurucz(
  file,
  species = NULL,
  wavelength = NULL,
  temperature = c(2500, 5000, 10000, 20000, 40000)
)

Arguments

file

The path to the line list: an extract saved from VALD3 for read_vald(), a Kurucz line list for read_kurucz().

species

An optional character vector of the species to keep, in spectroscopic notation, such as c("Ca II", "Mg I"). By default all the species of the file are kept.

wavelength

An optional numeric vector of length 2: the wavelength range to keep, in nm.

temperature

The temperatures (K) at which the widths are tabulated. Default is 2500 to 40 000 K; stark_width() interpolates between them.

Details

Files. The data of VALD3 are free, but need a registration: request an "Extract All", "Extract Element" or "Extract Stellar" list from the VALD website or its email service, in the short or the long format, with any wavelength unit (Å, nm or cm^{-1}), medium and energy unit, and give the saved file to read_vald(). The long format also gives the designations of the levels (lower and upper). The line lists of Kurucz are free to download from kurucz.harvard.edu: the whole list (gfall*.dat, in air above 200 nm, or gfallvac*.dat, in vacuum) or the list of one ion (such as atoms/2001/gf2001.pos for Ca II), in the 160-column format of these files. The wavenumber files (gfallwn*.dat) are not read. The wavelengths are kept in the medium of the file: in air, they match those of nist_lines() above 200 nm.

Widths. Both line lists give, for each line, the decimal logarithm of the quadratic Stark damping constant \gamma at 10 000 K per electron: the full width at half maximum of the Lorentzian profile in angular frequency (rad s^{-1}), divided by the electron density (cm^{-3}). The full width at half maximum in wavelength is

w = \frac{\lambda^2}{2 \pi c} \gamma N_e

It is tabulated at the density 10^{17} cm^{-3} (the width is proportional to it) and at each of temperature, scaled as (T / 10^4\,\mathrm{K})^{1/6}, the temperature dependence of the quadratic Stark width in the impact approximation (Gray, 2005). The shift is not given: it is set to zero. Lines without a Stark constant (zero in the file) are left out, and a line listed several times (as its isotopic or hyperfine components) is kept once.

Accuracy. Most of these constants come from approximate formulas rather than from calculations such as those of STARK-B, and the temperature law is approximate too: prefer STARK-B (starkb_lines()) or measured widths (stark_table()) when they exist, and use these for the other lines. A table of several species needs species in stark_width() and electron_density().

When you use these data, cite the line list and the references of the constants, given in the source column (the reference codes of VALD are described in the BibTeX file that comes with each extract).

Value

A tibble in the format of starkb_lines(), with one row per line and temperature: species, wavelength (nm), upper and lower (the level designations, empty when the file does not give them), perturber ("electron"), temperature, density (10^{17} cm^{-3}), width (nm), shift (0) and source (the line list, the logarithm of the constant and its references).

Author(s)

Christian L. Goueguel

References

  • Ryabchikova, T., Piskunov, N., Kurucz, R.L., Stempels, H.C., Heiter, U., Pakhomov, Yu., Barklem, P.S. (2015). A major upgrade of the VALD database. Physica Scripta, 90(5):054005. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1088/0031-8949/90/5/054005")}

  • Kurucz, R.L. Atomic line lists, kurucz.harvard.edu/linelists.html.

  • Gray, D.F. (2005). The Observation and Analysis of Stellar Photospheres, 3rd edition. Cambridge University Press.

See Also

starkb_lines(), stark_table(), stark_width(), electron_density()

Examples

# two lines of a VALD3 "Extract Element" list, short format (made-up
# references)
file <- tempfile(fileext = ".txt")
writeLines(c(
  "                                            Damping parameters    Lande",
  "Elm Ion       WL_air(A) Excit(eV) log(gf)   Rad.  Stark    Waals  factor References",
  "'Ca 2',       3933.6630,   0.0000,  0.135, 8.170,-6.270,  -7.760, 1.170,'   1 K10   Ca+  '",
  "'Ca 2',       3968.4690,   0.0000, -0.180, 8.160,-6.270,  -7.760, 1.330,'   1 K10   Ca+  '"
), file)
ca <- read_vald(file)
ca
stark_width(ca, wavelength = 393.366, temperature = 9000, density = 5e16)

# the same line in the 160-column format of the Kurucz line lists
kurucz <- tempfile(fileext = ".pos")
writeLines(paste0(
  "   393.3663  0.111 20.01       0.000  0.5 4s 2S        25414.400  1.5 4p 2P",
  "       8.17 -6.27 -7.76K10 "
), kurucz)
read_kurucz(kurucz, temperature = c(5000, 20000))

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