load_arf

Context: sl.sherpa

Syntax

load_arf( [id], filename|ARFCrate; [resp_id=1], [bkg_id=NULL] );

The load_arf command loads an ARF (effective area) from a FITS file or an ARFCrate. The ARF may be set as the response file for any available source or background dataset. Additionally, more than one ARF may be associated with a dataset.

id - the id of the dataset to use; if not given, uses the default dataset id (id=1 by default, see "ahelp get_default_id")
filename|ARFCrate - the name of the file (with path) or ARFCrate which contains the ARF data
resp_id - the id of the response, if multiple responses exist for the dataset; default is id=1
bkg_id - the id of the background, if the response is a background response; default=NULL

The load_bkg_arf command ("ahelp load_bkg_arf") may instead be used to load the background ARF. It uses the default background and response ids, which is adequate for most simple analysis sessions.

Example 1

sherpa> load_arf("arf.fits");

Load arf.fits and assign it as the first ARF for the source dataset. This basic case could also have been done with the load_bkg_arf command ("ahelp load_bkg_arf")

Example 2

sherpa> load_arf(1, "source.arf"; resp_id=2);

The file source.arf is loaded as the second ARF (the resp_id is 2) assigned to the dataset with id=1.

Example 3

sherpa> load_arf("arf.fits"; resp_id=1, bkg_id=2);

Load a background response on the second background (bkg_id=2) of a PHA data set. The ARF is loaded from a file and uses the default dataset id.

Example 4

sherpa> arfcr = read_arf("3c273.arf");
sherpa> load_arf(arfcr);

The ARF is read into an ARFCrate (named "arfcr") from the file 3c273.arf. The ARF is then loaded into Sherpa from the crate, using the default options.

Bugs

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