.help rgsrmfsmooth Nov07 ftools.spectral
.ih
NAME
RGSRMFSMOOTH -- Smooths an XMM RGS response matrix for an extended source
.ih
USAGE
rgsrmfsmooth [<rmffil> [<imgfil> [<order> [<outfil> [<chatter> [<clobber>]]]]]] 

rgsrmfsmooth [rmffile=<rmffile>] [imgfil=<imgfil] [order=<order>] [outfil=<outfil>] 
             [chatter=<chatter>] [clobber=<yes|no>]

.ih
DESCRIPTION

This tool modifies the instrumental response to take into account the
spatial degradation of the resolution when analyzing a
moderately-extended (~1 arcmin) source. This uses the code developed
by Andy Rasmussen of the Columbia University XMM-Newton RGS instrument
team originally for the rgsxsrc convolution model available in xspec
v11. The angular structure function is taken directly from an image (e.g.,
XMM-Newton EPIC, Chandra ACIS etc) where the user provides RA and Dec
(2000) coordinates for the source, position angle of the spacecraft,
and an aperture size suitable for the source.

The file input as the imgfil parameter is a text file giving the image 
filename, boresight, and source size in the following format :

RGS_XSOURCE_IMAGE  <filename of image of source>
RGS_XSOURCE_BORESIGHT  <image boresight in format>
RGS_XSOURCE_EXTRACTION <half-width of region in arcminutes> 

For example :

RGS_XSOURCE_IMAGE </local/data/mymachine/myusername/MOS1.FIT> 
RGS_XSOURCE_BORESIGHT <05:25:02.9 -69:38:30 339.760974> 
RGS_XSOURCE_EXTRACTION  <1.8>

.ih
PARAMETERS
.ls rmffil [string]
The name of the input XMM RGS response file.
.le
.ls imgfil [string]
The name of the text file containing the image, boresight and region size.
.le
.ls order [int]
This grating order for this response file.
.le
.ls outfil [string]
The name of the output response file.
.le
.ls chatter [int]
Hidden parameter specifying the amount of information to be written while
the tool runs.
.le
.ls clobber [bool]
If clobber = yes then overwrite the output file if a file of this name already
exists.
.le

.ih


.endhelp




