Last modified: December 2025

URL: https://cxc.cfa.harvard.edu/sherpa/ahelp/set_xsabund.html
AHELP for CIAO 4.18 Sherpa

set_xsabund

Context: modeling

Synopsis

Set the elemental abundances used by X-Spec models.

Syntax

set_xsabund(abundance: str)

No return value.

Description

Set the abundance table used in the X-Spec plasma emission and photoelectric absorption models. It is equivalent to the X-Spec abund command [1] .


Examples

Example 1

>>> set_xsabund('lodd')
 Solar Abundance Vector set to lodd:  Lodders, K. ApJ 591, 1220 (2003)

Example 2

>>> set_xsabund('abund.dat')
 Solar Abundance Vector set to file:  User defined abundance vector / no description specified

PARAMETERS

The parameter for this function is:

Parameter Type information Definition
abundance str A file name, format described below, or one of the pre-defined names listed in the Notes section below.

Notes

The pre-defined abundance tables are:

The values for these tables are given at [1] .

Data files should be in ASCII format, containing a single numeric (floating-point) column of the abundance values, relative to Hydrogen.

The screen output of this function is controlled by the X-Spec chatter setting ( `set_xschatter` ).

References

[1] Note that this may refer to a newer version than the compiled version used by Sherpa; use get_xsversion to check.

[2] Anders E. & Ebihara (1982, Geochimica et Cosmochimica Acta 46, 2363)

[3] Anders E. & Grevesse N. (1989, Geochimica et Cosmochimica Acta 53, 197)

[4] Asplund M., Grevesse N., Sauval A.J. & Scott P. (2009, ARAA, 47, 481)

[5] Feldman, U., Mandelbaum, P., Seely, J.L., Doschek, G.A., Gursky H. (1992, ApJSS, 81, 387)

[6] Feldman U.(1992, Physica Scripta 46, 202)

[7] Grevesse, N. & Sauval, A.J. (1998, Space Science Reviews 85, 161)

[8] Lodders, K (2003, ApJ 591, 1220)

[9] Lodders K., Palme H., Gail H.P., Landolt-Börnstein, New Series, vol VI/4B, pp 560–630 (2009)

[10] Wilms, Allen & McCray (2000, ApJ 542, 914)

XSPEC version

CIAO 4.18 comes with support for version 12.14.0k of the XSPEC models. This can be checked with the following:

% python -c 'from sherpa.astro import xspec;
print(xspec.get_xsversion())'
12.14.0k

Bugs

See the bugs pages on the Sherpa website for an up-to-date listing of known bugs.

See Also

info
show_xsabund
modeling
get_xsabund, set_xsabundances