Last modified: December 2024

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

create_rmf

Context: data

Synopsis

Create an RMF.

Syntax

create_rmf(rmflo, rmfhi, startchan=1, e_min=None, e_max=None,
ethresh=None, fname=None, name='delta-rmf')

Description

If fname is set to `None` then this creates a "perfect" RMF, which has a delta-function response (so each channel uniquely maps to a single energy bin), otherwise the RMF is taken from the image data stored in the file pointed to by `fname` .


PARAMETERS

The parameters for this function are:

Parameter Type information Definition
rmflo array The energy bins (low and high, in keV) for the RMF. It is assumed that emfhi_i > rmflo_i, rmflo_j > 0, that the energy bins are either ascending, so rmflo_i+1 > rmflo_i or descending (rmflo_i+1 < rmflo_i), and that there are no overlaps. These correspond to the Elow and Ehigh columns (represented by the ENERG_LO and ENERG_HI columns of the MATRIX block) of the OGIP standard.
rmfhi array The energy bins (low and high, in keV) for the RMF. It is assumed that emfhi_i > rmflo_i, rmflo_j > 0, that the energy bins are either ascending, so rmflo_i+1 > rmflo_i or descending (rmflo_i+1 < rmflo_i), and that there are no overlaps. These correspond to the Elow and Ehigh columns (represented by the ENERG_LO and ENERG_HI columns of the MATRIX block) of the OGIP standard.
startchan int, optional The starting channel number: it should match the offset value for the DataRMF class.
e_min None or array, optional The E_MIN and E_MAX columns of the EBOUNDS block of the RMF. If not set they are taken from rmflo and rmfhi respectively.
e_max None or array, optional The E_MIN and E_MAX columns of the EBOUNDS block of the RMF. If not set they are taken from rmflo and rmfhi respectively.
ethresh number or None, optional Passed through to the DataRMF call. It controls whether zero-energy bins are replaced.
fname None or str, optional If None then a "perfect" RMF is generated, otherwise it gives the name of the two-dimensional image file which stores the response information (the format of this file matches that created by the CIAO tool rmfimg [https://cxc.harvard.edu/ciao/ahelp/rmfimg.html] ).
name str, optional The name of the RMF data set

Changes in CIAO

Changed in CIAO 4.17

Support for startchan values other than 1 has been improved.

Changed in CIAO 4.16

The e_min and e_max values will use the rmflo and rmfhi values if not set.

Added in CIAO 4.11


Bugs

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

See Also

data
create_arf
saving
save_rmf