Chandra X-Ray Observatory
Skip to the navigation links
Last modified: September 2014

AHELP for CIAO 4.9 Sherpa v1


Context: models


The XSpec convolution models *Experimental*.


The sherpa_contrib.xspec.xsconvolve module provides an *experimental* interface to the X-Spec convolution models. Please contact the CXC HelpDesk if you have problems with these models.

Convolution components apply a convolution operator to an input model flux calculated from a source (additive) model, as modified by other components (multiplicative factors or other convolution operators). They differ from multiplicative components, which only apply a bin-wise multiplicative factor, by allowing transformations of the flux across energy bins.

Commands to create convolution models

Name Description
load_xscflux calculate flux
load_xsgsmooth gaussian smoothing
load_xsireflect reflection from ionized material
load_xskdblur convolve with the laor model shape
load_xskdblur2 convolve with the laor2 model shape
load_xskerrconv accretion disk line shape with BH spin as free parameter
load_xslsmooth lorentzian smoothing
load_xspartcov partial covering
load_xsrdblur convolve with the diskline model shape
load_xsreflect reflection from neutral material
load_xssimpl comptonization of a seed spectrum
load_xszashift Redshift an additive model
load_xsmshift Redshift a multiplicative model

Loading the X-Spec convolution models

To use these model, the xsconvolve module from the CIAO contributed package must be installed. The relevant load routine can then be loaded with a command like

sherpa> from sherpa_contrib.xspec.xsconvolve import load_xscflux

or all models loaded by saying

sherpa> from sherpa_contrib.xspec.xsconvolve import *

The load command can then be used to create a component in the same manner as load_conv, namely

sherpa> load_zashift("zas")
sherpa> set_source( * zas( +
sherpa> zas.redshift = 0.23

which applies a local absorption model to the redshifted power law and gaussian componente.


  • This is an experimental release of the convolution models; please take care when using this model.
  • The convolution models can be applied to any 1D model, not just the X-Spec models.
  • Sherpa does not have an equivalent of the extend command in X-Spec.

XSpec version

This information is taken from the XSpec User's Guide. Version 12.8.0k of the XSpec models is supplied with CIAO 4.6.

Changes in the scripts 4.6.6 (September 2014) release

The sherpa_contrib.xspec.xsconvolve module is new in this release.

About Contributed Software

This script is not an official part of the CIAO release but is made available as "contributed" software via the CIAO scripts page. Please see this page for installation instructions - such as how to ensure that the parameter file is available.


For a list of known bugs and issues with the XSPEC models, please visit the XSPEC bugs page.

See Also

absorptionedge, absorptiongaussian, absorptionlorentz, absorptionvoigt, accretiondisk, atten, bbody, bbodyfreq, beta1d, beta2d, blackbody, box1d, box2d, bpl1d, bremsstrahlung, brokenpowerlaw, ccm, const1d, const2d, cos, delta1d, delta2d, dered, devaucouleurs2d, disk2d, edge, emissiongaussian, emissionlorentz, emissionvoigt, erf, erfc, exp, exp10, fm, gauss1d, gauss2d, hubblereynolds, jdpileup, linebroad, list_model_components, list_models, lmc, load_xscflux, load_xsgsmooth, load_xsireflect, load_xskdblur, load_xskdblur2, load_xskerrconv, load_xslsmooth, load_xspartcov, load_xsrdblur, load_xsreflect, load_xssimpl, load_xszashift, load_xszmshift, log, log10, logabsorption, logemission, logparabola, lorentz1d, lorentz2d, models, normbeta1d, normgauss1d, normgauss2d, opticalgaussian, poisson, polynom1d, polynom2d, polynomial, powerlaw, powlaw1d, recombination, scale1d, scale2d, schechter, seaton, sersic2d, shell2d, sigmagauss2d, sin, sm, smc, sqrt, stephi1d, steplo1d, tablemodel, tan, xgal, xs, xsabsori, xsacisabs, xsagauss, xsapec, xsbapec, xsbbody, xsbbodyrad, xsbexrav, xsbexriv, xsbkn2pow, xsbknpower, xsbmc, xsbremss, xsbvapec, xsbvvapec, xsc6mekl, xsc6pmekl, xsc6pvmkl, xsc6vmekl, xscabs, xscemekl, xscevmkl, xscflow, xscompbb, xscompls, xscompmag, xscompps, xscompst, xscomptb, xscompth, xscomptt, xsconstant, xscplinear, xscutoffpl, xscyclabs, xsdisk, xsdiskbb, xsdiskir, xsdiskline, xsdiskm, xsdisko, xsdiskpbb, xsdiskpn, xsdust, xsedge, xseplogpar, xseqpair, xseqtherm, xsequil, xsexpabs, xsexpdec, xsexpfac, xsezdiskbb, xsgabs, xsgadem, xsgaussian, xsgnei, xsgrad, xsgrbm, xsheilin, xshighecut, xshrefl, xskerrbb, xskerrd, xskerrdisk, xslaor, xslaor2, xslogpar, xslorentz, xslyman, xsmeka, xsmekal, xsmkcflow, xsnei, xsnotch, xsnpshock, xsnsa, xsnsagrav, xsnsatmos, xsnsmax, xsnsmaxg, xsnsx, xsnteea, xsnthcomp, xsoptxagn, xsoptxagnf, xspcfabs, xspegpwrlw, xspexmon, xspexrav, xspexriv, xsphabs, xsplabs, xsplcabs, xsposm, xspowerlaw, xspshock, xspwab, xsraymond, xsredden, xsredge, xsrefsch, xsrnei, xssedov, xssirf, xssmedge, xsspexpcut, xsspline, xssrcut, xssresc, xssss_ice, xsstep, xsswind1, xstbabs, xstbgrain, xstbvarabs, xsuvred, xsvapec, xsvarabs, xsvbremss, xsvequil, xsvgadem, xsvgnei, xsvmcflow, xsvmeka, xsvmekal, xsvnei, xsvnpshock, xsvphabs, xsvpshock, xsvraymond, xsvrnei, xsvsedov, xsvvapec, xsvvgnei, xsvvnei, xsvvnpshock, xsvvpshock, xsvvrnei, xsvvsedov, xswabs, xswndabs, xsxion, xszagauss, xszbabs, xszbbody, xszbremss, xszdust, xszedge, xszgauss, xszhighect, xszigm, xszpcfabs, xszphabs, xszpowerlw, xszredden, xszsmdust, xsztbabs, xszvarabs, xszvfeabs, xszvphabs, xszwabs, xszwndabs, xszxipcf

Last modified: September 2014
Smithsonian Institute Smithsonian Institute

The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory. 60 Garden Street, Cambridge, MA 02138 USA.   Email: Smithsonian Institution, Copyright © 1998-2017. All rights reserved.