XMM-Newton Science Analysis System


emframes (emframes-5.11) [xmmsas_20230412_1735-21.0.0]

Output Files

1. frames file with additional rows and following items:
   • general keywords OBS_MODE, OBJECT, OBSERVER, RA_OBJ, DEC_OBJ, RA_NOM, DEC_NOM, REVOLUT taken from summary file, FILTER (taken from the HK), EXPIDSTR (taken from the original file name in the ODF), DATAMODE (deduced from DATATYPE in event list) and SUBMODE (Guest Observer mode, CCD 1 only) in the primary header (for PRODUCT: EPIC event list)
   • columns FRAME, NPIXEL, NBELOW, NABOVE, GATTIFLG, FIFOOVF and header propagated from auxiliary file
   • NVALID column updated (for emevents)
   • REAL*8 column TIME (s) (for emevents)
   • INTEGER*2 column FLAG (for emevents)
   • INTEGER*2 column GATTIVAL (for emevents)
   • REAL*4 column CRRATIO (dead-time fraction for emevents)
   • CCD specific keywords propagated from event list file
   • keyword CCDMODE expliciting CCD operating mode
   • keyword GAIN_CCD (when set to LOW, the PHA values are approximately divided by 10, and the data is not suitable for scientific use)
   • keyword FRMTIME (ms) (frame integration time, for PRODUCT: EPIC event list)
   • keywords TSTART, TSTOP, TELAPSE, ONTIME and LIVETIME (start and end times, exposure duration, sum of good time intervals and dead-time corrected on time), TIMEUNIT, TIMESYS, MJDREF, TIMEREF, TASSIGN, TIMEZERO and CLOCKAPP (origin and nature of times)
   • keywords ATT_SRC, ORB_RCNS, TFIT_RPD, TFIT_DEG, TFIT_RMS, TFIT_PFR set by the OAL.
   • keywords SRC_RAWX and SRC_RAWY (source position on CCD in Timing mode), with associated SRC_RA and SRC_DEC (source coordinates) if manually set
   • keyword GATTI_ON (boolean indicating whether the GATTI was on or off, for PRODUCT: EPIC event list and arfgen, rmfgen)
   • keywords CRPATi expliciting “cosmic-ray” patterns (for emevents)
   • keywords detailing which subroutines were activated
   • comment lines with names of input files
2. events file with same structure as in input, added FILTER keyword, modified FRAME column and possibly deleted rows (in case frames were renumbered).
3. GTI file specific to that CCD/node (for evselect, [2]), if writegtiset=yes. The GTI extension is called STDGTInn, where nn is the CCD number + 10 times the CCD node (as in evlistcomb). Keywords are copied from the frames file.
4. Temporary copy of the input auxiliary file (emframes.temp), normally removed by the task on exit.