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


eexpmap (eexpmap-3.37.4) [xmmsas_20070308_1802-6.6.0]

Use Home Page Parameters Home Index

Meta Index / Home Page


Description

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'. The event pattern types for which the quantum efficiency is calculated may be read from input parameter pattern and alternatively (not yet implemented in this version) directly from the data subspace of the input dataset. 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 the parameter useoffset is set to 'true'. Depending on the value of parameter badclean the surroundings of bad pixels and border pixels are also excluded from the instrument maps. The surrounding to be omitted is given by the following grid (pixels with values $\le$ badclean value are omitted):

5 4 3 4 5
4 2 1 2 4
3 1 0 1 2
4 2 1 2 4
5 4 3 4 5

From version 3.29 the parameter badclean has default value 0 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 the the input image has be of the same coordinate type (detector/sky) as the required output image. In the case of sky coordinates, the attitude file generated by 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 (if enabled by parameter usedss) 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. If parameter usedss is set to false, 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 eventfile. 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 parameter usedss and the corrsponding parameter writedss of task evselect are 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 dependend dead-times. In the case of EPIC PN, the keyword TIMEDEL is used. Since the value of TIMEDEL incorporates mode dependend 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.


Use Home Page Parameters Home Index

XMM-Newton SOC/SSC -- 2007-03-08