RGSRMFSMOOTH (Nov07)         ftools.spectral        RGSRMFSMOOTH (Nov07)



NAME
    RGSRMFSMOOTH -- Smooths an XMM RGS response matrix for an extended source


USAGE
    rgsrmfsmooth [<rmffil> [<imgfil> [<order> [<outfil> [<chatter>
     [<clobber>]]]]]] 

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



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>


PARAMETERS

    rmffil [string]
       The name of the input XMM RGS response file.

    imgfil [string]
       The name  of  the text file  containing the image,  boresight and 
       region size.

    order [int]
       This grating order for this response file.

    outfil [string]
       The name of the output response file.

    chatter [int]
       Hidden  parameter  specifying  the  amount  of  information to be 
       written while the tool runs.

    clobber [bool]
       If clobber = yes then overwrite the output file if a file of this 
       name already exists.