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

eexpmap (eexpmap-4.12.1) [xmmsas_20230412_1735-21.0.0]


Using CCF data on the spatial quantum efficiency, filter transmission, mirror vignetting, and field of view, instrument maps containing the spatial efficiency of the instrument are constructed. Quantum efficiency, filter transmission, and vignetting are evaluated assuming an event energy which corresponds to the mean of the PI channel boundaries specified by the command line parameters pimin and pimax (note, that, depending on the source spectrum, this may introduce errors if very wide [pimin,pimax] intervals are used; create narrow band exposure maps instead and weight appropriately). Alternatively, the PI channel boundaries will be read directly from the data subspace extension of the input image (not yet implemented). The inclusion of the telescope vignetting in the exposure calculation can be switched off, if withvignetting is set to 'false'. Bad pixels as listed in the bad pixel extension of the input file are excluded from the instrument maps. EPIC PN offset columns (as specified in the offsets extension of the photon event list) are set to zero in the exposure map, if they had been removed from the input reference EPIC image. Depending on flag selections in the image, the surroundings of bad pixels and border pixels are also excluded from the instrument maps.

From version 4.0 on, the parameter badclean is removed from the parameter list, and the pixels in the neighbourhood of bad pixels, CCD borders, and offset columns are treated according to the flag selections of the input image. The flag selections are read from the DSS keywords of the input image.

From the instrument maps, exposure maps are constructed which may be either output in detector or in sky coordinates (this is the default; see parameter withdetcoords). Note that the input image has to be of the same coordinate type (detector/sky) as the required output image. In the case of sky coordinates, the attitude file generated by the task atthkgen is rebinned. A new attitude bin is started when the change in attitude exceeds the required positional accuracy (parameter attrebin). The integration time is calculated from the good time intervals valid for each chip and is corrected for subsequent time selections performed by the user. The exposure falling in each time bin is obtained from the exposure extension of the input dataset.

An attitude histogram is created from the rebinned attitude file, and for each attitude bin, the corresponding exposure values are finally projected onto the sky and 'accumulated' into the respective sky image pixels. The resulting exposure maps will thus contain the exposure (in units of seconds) for a particular EPIC sky image.

The following filters are read from the data subspace keywords of the input images and are taken into account for the calculation of the exposure maps: TIME range filters, GTI filters, CCDNR range filters, FLAG range filters, FLAG bit-mask filters. The task tries to determine the exposure time by looking for GTI extensions in the input image of the form STDGTInn, STDGTIn, STDGT, or GTI. If no GTI extension is found, the exposure time is taken from the EXPOSURE keyword. No merging of multiple gti is performed in the usedss=false case but the first set of GTI extensions in the sequence above is used. Note that the task expects the gti information in an extension of the input image whereas the BADPIX and EXPOSURE extensions are read from the input event file. The usedss=false setting is mainly useful for the processing of non-SAS-derived input datasets. In the case of SAS-derived images it is strongly advised that the parameter writedss of task evselect is set to true. For EPIC MOS input images, the effective frame time is taken from the column TIMEDEL of the EXPOSURE extensions in order to correct for mode dependent dead-times. In the case of EPIC PN, the keyword TIMEDEL is used. Since the value of TIMEDEL incorporates mode dependent corrections for out-of-time events, a keyword OOTCORR=true is written to EPN exposure maps in order to avoid double correction by emldetect. The keyword OOTFRAC contains the ratio between the keywords TIMEDEL/FRAMETIM.

Task eexpmap supports the calculation of several exposure maps in different energy bands in one run of the task. The exposure maps are used in the EPIC detection chain by the tasks emask, esplinemap, eboxdetect, emldetect, ewavelet, and esensmap.

XMM-Newton SOC -- 2023-04-16