XMM-Newton SAS Home Page
XMM-Newton Science Analysis System


especget (especget-1.54) [xmmsas_20230412_1735-21.0.0]

ARF options

By default, an ARF will be created which has been corrected for the area lost by the gaps between CCDs and by bad pixels. This latter correction relies on a list of bad pixels being present in the header of the eventset specified in the table parameter. These corrections may be turned off by specifying withbadpixcorr=no. The ARF generation stage can itself be turned off by setting witharfset=no.

If the spatial selection has been specified in sky coordinates (X/Y) then arfgen needs to internally convert these into detector coordinates. The default conversion uses attitude information taken from the header of the newly created spectrum. On rare occasions this can cause a problem and so the option exists, (useodfatt=yes), to use the raw attitude files stored in the ODF directory pointed to by the environment parameter SAS_ODF.

The extendedsource option tells arfgen to produce the ARF relevant for an extended source. The distinction between the ARF needed for a point-like and extended source is rather subtle. In practice, for an extended source the ARF has no correction for encircled energy, the mirror vignetting is averaged over the whole source area and area lost due to bad pixels and chip gaps is not convolved with the Point Spread Function (PSF). All of these effects are toggled by the extendedsource parameter.

To calculate the effective area curve arfgen averages over a grid known as a detector map, which by default has five by five elements. In certain cases, such as a narrow annulus or large complicated region, this is insufficient to sample the region and can result in a null ARF or BACKSCAL value being returned. To avoid this the number of bins may be specified on the command line using the parameters detxbins and detybins.

See the arfgen documentation for further details.

XMM-Newton SOC -- 2023-04-16