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


eimsimreduce (eimsim-2.4.2) [xmmsas_20211130_0941-20.0.0]


Generate some `reliability' histograms

This function may be performed alone by calling the script with entrystage and finalstage=`reliability'.

It is desirable to discard detections for which the probability $P_\mathrm{null}$ is high that the detection arose by a chance fluctuation of the background. It is assumed here that any detection scheme called by eimsim will calculate this probability and store it in the DETEC_PNULL column of the output source list. Generally one would expect that the detection scheme to implement a cutoff in the value of $P_\mathrm{null}$, sources falling above this cutoff being discarded. The purpose of the function is to check that the calculation of $P_\mathrm{null}$ works as expected. This is done by comparing the column DETEC_PNULL values to the number $N_\mathrm{false}$ of false detections. In fact $N_\mathrm{false}$ is plotted as a function of DETEC_PNULL. How does this work? Well, the average number of false detections should be proportional to the probability of detection from background fluctuations - at least for the situation in which the `real' sources are relatively sparse, and thus unable to muddy the waters. A histogram of $N_\mathrm{false}$ against $P_\mathrm{null}$ should therefore give a straight line of slope 1 on a log-log plot.

The following histogram columns are calculated:

The DETEC_PNULL bins are calculated such that they have equal widths in $\log_{10}$ space. DPNUL_MID is also the geometric mean of the bin boundaries, not the arithmetic mean.

XMM-Newton SOC -- 2021-11-30