XMM-Newton Science Analysis System


epevents (epevents-6.55) [xmmsas_20230412_1735-21.0.0]

Files and columns

1. EPIC PN event file with recombined events corrected for gain and CTI effects. The event file consists of:
   • an EVENTS extension with columns TIME, FRAME, RAWX, RAWY, DETX, DETY, PHA, PI, CCDNR, FLAG, PAT_ID, PAT_SEQ and PATTERN (temporarily we also store detailed pattern informations as additional columns PAT_TYP, PAT_IND and PAT_ORI; columns PHA_CTI list the CTI and gain corrected PHA values of each event prior to the split event recombination (to check corresponding CAL functionality))

   • Conversion of detector coordinates to physical camera detector coordinates: For TIMING and BURST mode data the position of the source (given as keyword SRCPOS in RAWY pixel coordinates as written by epframes) is used to calculate the DETY value at the source position.

   • a BADPIX extension (copied if available from input file)

   • an EXPOSURE extension (copied from input file) with new attributes summarizing the pattern analysis: ANALYSED (number of analysed events), SINGLES (number of single events), DOUBLES (number of double events), TRIPLES (number of triple events), QUADRUPL (number of quadruple events), NOTRECEV (number of not recognized events), NOTRECPA (number of not recognized patterns), MAXPAT (maximum pattern size),
     [3] TRAILING (number of trailing events), MIPS (number of MIPs found) and RECPHOTO (number of recognized photons)

2. If withoutoftime=Y then instead a file is created with the same structure as above but consisting of only out-of-time events (instead of the normal events file).
3. If withphotonmap=Y then additionally a file photonmapset is created containing 4 image extensions according to pattern types and energy ranges specified in mappatterntype, lothresh and hithresh.