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

esensmap (esensmap-4.0) [xmmsas_20230412_1735-21.0.0]


esensmap creates a sensitivity map, providing upper limits to detect a point source over given background. In each image pixel, it includes the vignetting corrected source count rate (cts s$^{-1}$) that corresponds to the minimum detection likelihood as specified in the parameter mlmin. From version 4.0 on, energy conversion factors (ECFs[*] in units of $10^{11}$ cts cm$^2$ erg$^{-1}$) are accepted via the parameter ecf to produce sensitivity maps in flux units (erg cm$^{-2}$ s$^{-1}$). The task parameter outunit determines whether to write count-rate maps (outunit=rate), flux maps (outunit=flux), or both (outunit=both).

eboxdetect-like Poisson mode

The task may either be called for individual energy bands or combinations of energy bands and instruments. The upper limits are derived by assuming Poissonian count statistics in each 3 $\times$ 3 pixel detection cell, using the exposure and background values read from the input images. It is assumed that 30 % of the PSF fall into the detection cell. Likelihoods are calculated as a function of raw source and background counts via the incomplete gamma function as described for eboxdetect. This simple upper limit calculation is meant as a reference point for a more detailed assessment of the sensitivity of the detection process to be determined through Monte Carlo simulations.

In the case of multiple input energy bands, the upper limits are calculated for the combined images. I.e. they refer to the detection sensitivity which would be achieved by adding up the photons observed in the individual bands (not identical to the sensitivity in a combined source-detection fit). Pixels outside of the detection mask as well as pixels with zero exposure time are assigned a sensitivity value of –1.0. This also holds for pixels where – potentially arising from a failure of the spline fit in the esplinemap backgound task – zero or negative values occur in the input background maps.

emldetect-like DeltaC mode

Version 4.0 introduces a DeltaC approach that is based on emldetect-like Cash statistic. It can be activated via the task parameter statistic=deltac and employs a likelihood test comparing the detection likelihood of background plus source emission with pure background emission. The log-likelihood ratio can be expressed via the Cash statistic $C$ as $\Delta C = C(\textrm{background}) -
C(\textrm{background}+\textrm{source})$. This quantity, which follows a $\chi^2$ distribution approximately, is minimised in the emldetect source fit. Free parameters of this fit are the count rate in each input image, the source position, and, optionally, the source extent. The total detection likelihood is derived from the sum of the individual $\Delta C$ values (for more details, see for example Rosen et al. 2016, A&A 590, A1; Traulsen et al. 2019, A&A 624, A77).

The new esensmap mode adapts a simplified version of this emldetect approach, which was developed in the EU funded ARCHES[*] project. It uses background and exposure map(s) of an observation to determine the limiting count rate at a given total detection likelihood (parameter mlmin) in each of the exposed pixels, which are supplied as detection mask(s). If data of several instruments and/or energy bands are provided, the output sensitivity map gives the combined all-EPIC broad-band limits for $n$ degrees of freedom, where $n$ is the number of input images plus 3 (for source position and extent), similar to the combined fit performed by emldetect. To compute $\Delta C$, the point-spread function (PSF) in each image pixel is interpolated from a grid of PSFs spanning different off-axis angles across the field of view. The parameter doff controls the off-axis steps. It defaults to 12 arcsec. Mid-band energies, at which the PSFs are obtained, are to be provided via the parameter energies. Parameter ecut controls the half size of the box within the PSF is evaluated, by default 15 arcsec (cf. the emldetect parameter ecut).

Since the EPIC PSFs are essentially rotationally symmetric, the azimuthal dependence of the PSF shapes (i.e., their orientation angle) is ignored for the sake of computational efficiency. This approximation leads to deviations from the true sensitivity of the order of several percent at the detector edges, where the PSFs are not covered completely (i.e. where the mask fraction is significantly smaller than one). Sensitivity values in these areas come with larger uncertainties anyway, as the source detection process itself.

XMM-Newton SOC -- 2023-04-16