Installation

The procedure for setting up and using this model is as described in the xspec manual:

0) You need to have the heasoft package installed on your machine, but it must be built from source. Local models cannot be installed from a binary installation.

1) untar this directory somewhere in your user area

2) setup your headas environment (eg. 'setenv HEADAS /path/to/architecture', and 'source $HEADAS/headas-init.csh')

3) point the WARMABS_DATA enviroment variable to the directory where the warmabs data files atdbwarmabs.fits, coheatwarmabs.dat and pops.fits are kept (eg, 'setenv WARMABS_DATA $PWD').

4) In addition the WARMABS_POP environment variable must be set to point to the name of the populations file (relative to the WARMABS_DATA location) to be used by the warmabs, multabs and photemis models. For example, the populations for a density 10$^4$ gas illuminated by a $\Gamma$=2 power law are in pops.fits.n04, so to use these do 'setenv WARMABS_POP pops.fits.n04'.

5) Start up xspec, and in response to the prompt type 'initpackage xstarmod lmodel_warmabs.dat <path-to-current-directory>', where <path-to-current-directory> is the full path of the current directory and can be the dot ('.'). Then, after the build is complete type 'lmod xstarmod <path-to-current-directory>' In subsequent sessions you don't neet to do the initpackage step again, just the lmod.

6) Instructions for xspec11:

a) Set the environment variable LMODDIR to the local directory, where you have untarred the package, eg. 'setenv LMODDIR $PWD'

b) make sure this directory is pointed to by your shared object library environment variable, as described in the xspec11 manual, eg. 'setenv LD_LIBRARY_PATH "${LMODDIR}:$LD_LIBRARY_PATH"'

c) rename the lmodel_warmabs.dat file to lmodel.dat, or cat it onto an existing lmodel.dat

d) cd into $LHEASOFT/../spectral/xspec/src/local_mod

e) type hmake

f) cd to the directory where you want to work and start xspec 11.