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

epframes (epframes-8.116) [xmmsas_20211130_0941-20.0.0]


Let us assume we have an observation 0084_0099280101 with three exposures, one TIMING mode exposure PNS008, and two imaging exposures PNS010 (in Small Window Mode) and PNS018 (in Full Frame Mode). Here follow three equivalent calls to epframes:
  epframes set=0084_0099280101_PNS01804IME.FIT eventset=r04.dat gtiset=g04.dat
  epframes set='OAL(EPN,IMAGING,2,4)'          eventset=r04.dat gtiset=g04.dat
  epframes set='ODF(EPN,IMAGING,18,4,S)'       eventset=r04.dat gtiset=g04.dat
This processes CCD 4 of the second IMAGING mode exposure (i.e. PNS018). Diagnostic output images can be created with the additional setting
  epframes ... witheventmap=Y eventmapset=m04.dat
and you can adjust the energy bands with parameters
  epframes ... witheventmap=Y eventmapset=m04.dat \
    nomipthresholdhigh=... nomipthresholdlow=...  \
    softthresholdhigh=...  softthresholdlow=...
If you suspect that your source is not at the nominal position but offset then you may enter for TIMING and BURST modes to get the event times (and later CTI correction in task epevents) correctly:
  epframes ... withsrccoords=Y srcra=... srcdec=...
If you are interested in the setup of the instrument it is suggested to enable the output of additional messages (if SAS_VERBOSITY = 4 or higher), see also Sect.7.2:
  epframes ... showpah=Y showpmh=Y
If you have old PMS (odffixed) data you may wish to set
  epframes ... odfok=N hkok=N
which eliminates a couple of warnings related to missing information in the files that are included and expected in correct (ODS) ODF datasets (this setting should not be used in the GO phase).

XMM-Newton SOC -- 2021-11-30