XMM-Newton Data Files Handbook

6.3 Event list structure in the PN Imaging Mode

The naming and structure of the PN Imaging Mode event lists is very similar to that of the corresponding MOS files (see Sect. 6.1 and Table 31). The main differences are:

• The name of the file is REVN_OBSID_EPN_SEEE_ImagingEvts.ds

• the number of EXPOSU$xy$, BADPIX$xy$, DLIMAP$xy$, and STDGTI$xy$ extensions is maximal 12 (equal to the number of PN chips) instead of 7 for MOS.

• DLIMAPxy extension, where xy is the CCD number (01-12):

  The number of rejections of a CCD column (default) or row from the on-board Minimum Ionizing Particle (MIP) rejection algorithm is stored a DLI file (Discarded Lines Image File). One DLI file per CCD is produced and included in the ODF (see Sect. 4.1.5).

• the units for the quantity PI in the EVENTS extension are eV.

• the columns PAT_ID and PAT_SEQ are present in the EVENTS extension.

• an extension DLIMAP$xy$ (=Discarded Line Map) is present if certain lines have been discarded ($xy$ stands for chip number 1-12). This extension is needed to create the exposure map.

• the OFFSETS extension contains column offset values of patched offsets (as applied through the on-board offset table) or anomalous offsets (e.g., as a result of bit flips in the EDU memory or other serendipitous events) as determined by the SAS event processing.

• the EXPOSU$xy$ extension contains the following additional values in the header: MODE, WINDOWX0, WINDOWY0, WINDOWDX, WINDOWDY (left-bottom corner coordinates and length of the science window).

• the STDGTI$xy$ extension contains the standard Good Time Intervals (GTIs) applied to produce the event list. $xy$ as for EXPOSU$xy$.

• In addition, any number of extensions GTI$0xy$ZZ may be included in the events file, written by any non-standard time filtered expression, mainly in evselect. $xy$ is the same as for EXPOSU$xy$ but starting at 00, thus $xy\,=\,00, 01, ..., 11$.
  ZZ is a sequence number in the Data Subspace corresponding to a TIME filter expression. If the event list was filtered using more than one TIME expression, consecutive GTI extensions are added starting with ZZ=02, thus $0xy$02, $0xy$03, etc...

A short description of the column in each of the above extensions is given in Table 32.

Table 32: PN Imaging Mode event list column

Name	Units	Description
BINTABLE EVENT
TIME	SECONDS
RAWX	PIXELS	Event X-coordinate as measured by the detector
RAWY	PIXELS	Event Y-coordinate as measured by the detector
DETX	0.05 ARCSECONDS	Physical camera X detector coordinate
DETY	0.05 ARCSECONDS	Physical camera Y detector coordinate
X	0.05 ARCSECONDS	Sky X detector coordinate
Y	0.05 ARCSECONDS	Sky Y detector coordinate
PHA	CHANNELS	Pulse-Height-Analyser (uncalibrated spectral channel)
PI	CHANNELS	Pulse-Invariant (calibrated spectral channels)
FLAG
PATTERN		Event pattern
PAT_ID
PAT_SEQ	PIXELS	Distance from neighbouring event in same frame & column
CCDNR		CCD identifier (1-12)
TIME_RAW	SECONDS	raw time stamps
BINTABLE OFFSETS
RAWX	PIXELS	Column number of the offset
OFFSETX	CHANNEL	Column offset in ADU
CCDNR		CCD identifier (1-12)
BINTABLE EXPOSU$xy$
TIME	SECONDS	Frame central time
FRACEXP	FRACTION	Fraction of effective time
BINTABLE BADPIX$xy$
RAWX	PIXEL	Bad pixel X-coordinate
RAWY	PIXEL	Bad pixel Y-coordinate
TYPE		1: Hot 2: Flickering 3: Dead
YEXTENT	PIXEL	# of pixel in y column
BADFLAG		1: uplinked bad pixels; 2: CCF origin; 3: file origin
BINTABLE DLMIMAP$xy$		Discarded columns (default) or rows
DLIODF	PIXEL	- identified by the DLI files in the ODF
DLISAS	PIXEL	- identified by the SAS
BINTABLE CALINDEX
TELESCOP		XMM
SCOPE		EMOS[1,2], EPN, RGS[1,2], OM, XRT[1,2,3], XMM
TYPEID		CCF constituent type
ISSUE		Issue number
VALDATE		Start of validity date
VALDATE-END		End of validity date
FNAME		Name of applied calibration file
DATE		Production date of calibration file
FSIZE		File size (bytes)
SUBDATE		Submission date
EXTSEQU		Extension sequence
EXTSEQUID		Extension sequence identifiers
MD5		MD5 signature of constituents
CREATOR		CCF constituent creator
BINTABLE STDGTI$xy$
START		GTI start time
STOP		GTI stop time
BINTABLE GTI$0xy$ZZ		only if additional time filters applied
START		GTI start time
STOP		GTI stop time