The sherpa.astro.xspec module
Support for XSPEC models.
Sherpa supports versions 12.12.1, 12.12.0, 12.11.1, 12.11.0, 12.10.1, 12.10.0, 12.9.1, and 12.9.0 of XSPEC 1, and can be built against the model library or the full application. There is no guarantee of support for older or newer versions of XSPEC.
To be able to use most routines from this module, the HEADAS environment
variable must be set. The
get_xsversion function can be used to return the
XSPEC version - including patch level - the module is using:
>>> from sherpa.astro import xspec >>> xspec.get_xsversion() '12.11.1'
The XSPEC model library is initalized so that the cosmology parameters
are set to H_0=70, q_0=0.0, and lambda_0=0.73 (they can be changed with
The other settings - for example for the abundance and cross-section
tables - follow the standard rules for XSPEC. For XSPEC versions prior
to 12.10.1, this means that the abundance table uses the ‘angr’
setting and the cross sections the ‘bcmc’ setting (see
set_xsxsect for full details). As of XSPEC 12.10.1, the values
are now taken from the user’s XSPEC configuration file - either
for these settings. The default value for the photo-ionization table
in this case is now ‘vern’ rather than ‘bcmc’.
The default chatter setting - used by models to inform users of issues - was set to 0 (which hid the messages) until Sherpa 4.14.0, when it was changed to 10 (to match XSPEC).
The additive 2, multiplicative 3, and convolution 4 models
from the XSPEC model library are supported, except for the
model 5, since it requires use of information from the XFLT keywords
in the data file).
XSPEC parameters have soft and hard limits but they are different to the Sherpa meaning:
the XSPEC hard limit is more-like a Sherpa parameter with the same soft and hard limits;
and it is possible to change the hard limits.
This document describes the base classes for XSPEC models, and the utility routines - such as querying and retrieving the abundance table information. The models provided by XSPEC are described in The sherpa.astro.xspec module.
XSBaseParameter(modelname, name, val[, min, ...])
An XSPEC parameter.
XSParameter(modelname, name, val[, min, ...])
An XSPEC parameter where you exceed the hard limits.
The base class for XSPEC models.
The base class for XSPEC additive models.
The base class for XSPEC multiplicative models.
The base class for XSPEC convolution models.
Evaluate a model and pass it to an XSPEC convolution model.
XSTableModel(filename[, name, parnames, ...])
Interface to XSPEC table models.
Return the X-Spec abundance setting or elemental abundance.
Return the chatter level used by X-Spec.
Return the X-Spec cosmology settings.
Return the path to the files describing the XSPEC models.
Return the path to the model data files.
Return the state of the XSPEC module.
Return the version of the X-Spec model library in use.
Return the cross sections used by X-Spec models.
Return the X-Spec model setting.
read_xstable_model(modelname, filename[, etable])
Create a XSPEC table model.
Set the elemental abundances used by X-Spec models.
Set the chatter level used by X-Spec.
set_xscosmo(h0, q0, l0)
Set the cosmological parameters used by X-Spec models.
Set the path to the files describing the XSPEC models.
Restore the state of the XSPEC module.
Set the cross sections used by X-Spec models.
Set a X-Spec model setting.