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

ebadpixupdate (ebadpixupdate-1.11) [xmmsas_20230412_1735-21.0.0]

Replacing bad pixels instead of adding new ones

In the calibrated events lists generated by the pipeline, the events found to be on a bad pixel have already been removed. That operation is of course irreversible.

But epchain and emchain allow to generate events lists in which all events flagged for rejection (including those on a bad pixel) are still present. In that case the bad pixel flagging is reversible. Note that this is not completely true for MOS, because emevents by default removes the bright pixels and reanalyses events, so that a double event including a bright pixel will be changed into a single plus the (flagged) bright pixel. That behaviour may be suppressed (analysepatterns=N) in which case entire events are flagged, as PN does.

The overwrite=Y option may be used to replace the existing bad pixels with the new ones instead of adding the new bad pixels to the old ones. This means the events will be unflagged and the bad pixel lists reset, for all CCDs declared in ccds or corresponding to the tables in badpixtables.

The bright pixels previously declared on-board (BADFLAG=1) will not be removed from the list of bad pixels by the overwrite=Y option (the list of on-board bright pixels will be incremented). The corresponding pixels were removed on-board, so they cannot be recovered. Nevertheless, if the list of on-board bright pixels written by the PPS or emchain was wrong, the replaceonboard=Y option allows to replace them and reset the CLOSE_TO_ONBOARD_BADPIX flag. The other bad pixels will be incremented, unless overwrite=Y as well.

Use those option with caution. The program will try to check that the events flagged previously were not already removed, but this is not fool proof. In a non-interactive context, the forcereplace=Y option should be used to prevent activating the checks.

XMM-Newton SOC -- 2023-04-16