XMM-Newton Science Analysis System


epframes (epframes-8.116) [xmmsas_20230412_1735-21.0.0]

Examples

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).