XMM-Newton Science Analysis System


ebadpixupdate (ebadpixupdate-1.11) [xmmsas_20230412_1735-21.0.0]

What the task does

• If fromccf=Y, ebadpixupdate loops over all CCDs selected by the ccds parameter and reads all bad pixels for that CCD
• If fromfiles=Y, ebadpixupdate loops over all tables (or files) listed in the badpixtables parameter and reads the corresponding CCD in the header of the table.

In both cases, it flags all events belonging to that CCD and:

1. on a bad pixel, whether bright or dead (ON_BADPIX)
2. next to a dead pixel/line/column (CLOSE_TO_DEADPIX)
3. next to a bright pixel (CLOSE_TO_BRIGHTPIX)

CLOSE_TO means that the bad pixel is immediately next to the main pixel of the event (not diagonal).

As a second step, ebadpixupdate updates the bad pixels extensions (BADPIXnn) appended to the merged events lists, or adds a bad pixel extension if it is missing. This ensures that the bad pixel information will be propagated to the exposure map (by eexpmap) and the effective area (by arfgen). The BADFLAG column is set to 1 for uplinked bad pixels, to 2 for a CCF origin, to 3 for a file origin. For the case where the same bad pixel is present with both origins (e.g. a bad pixel with BADFLAG=3 originally and now present in the CCF) the smaller number is written (BADFLAG=2, CCF origin).