XMM-Newton Data Files Handbook


next up previous contents
Next: 4.1.2 Observation/slew summary file Up: 4.1 Observation/Slew data science, non-science, and spacecraft files Previous: 4.1 Observation/Slew data science, non-science, and spacecraft files


4.1.1 Identification of individual ODF component files

A typical ODF/SDF directory contains several dozens of files. The purpose of each file can be identified from a combination of file name and content of the FITS header.

The filenames associated with ODFs and SDFs consist of up to 27 characters, followed by a '.' (dot), followed by 3 characters. All characters are upper case. The adopted naming convention is as follows:

RRRR_obsidentif_IIUEEECCMMF.ZZZ

This encoding uniquely specifies the instrument, the type of observation (scheduled or unscheduled), the exposure number, the CCD/OM window identifier, the file type, and the format. Descriptions of the each filename field are listed in Table 1.


Table 1: ODF/SDF component filenames
Field Description
RRRR The revolution (orbit) number
obsidentif The observation identifier, 10 digit: PPPPPPOOLL
  PPPPPP the identifier of the proposal that contains the obs.
  OO identifier of the observations within the proposal
  LL extended identifier (usually 01)
  Notes: For slews the first of the six P is '9'
    For pseudo ODF components of mosaic pointings, the values of LL
    assume values (30+x), where x is the number of the mosaic pointing.
II The instrument, or data source, identifier
  OM optical monitor
  R1 RGS-1
  R2 RGS-2
  M1 EPIC MOS-1
  M2 EPIC MOS-2
  PN EPIC PN
  RM EPIC radiation monitor
  SC Spacecraft
U  
  S Indicates that the observation was scheduled
  U Indicates that the observation was unscheduled
  X not applicable (because not science files)
EEE The exposure number within the observation
  000 file does not correspond to an exposure period
  9XX is used for diagnostic Q dumps (RGS spectroscopy+Q)
CC The CCD identifier/OM Window identifier (2 digits)
    EPIC MOS CCD number (1-7) & CCD read-out mode (0,1)
    EPIC PN CCD number (01-12)
    RGS CCD number (01-09)
    Note: ``00'' is used for multi-CCD files
    OM science window identifier
  00 used for those files not having a corresponding CCD or science window
MM The data contained within the file name
  AT Spacecraft attitude
  AU EPIC or RGS auxiliary
  BU EPIC PN burst
  CC EPIC counting cycle report (auxiliary file)
  CI EPIC MOS compressed timing
  D1 DPP non-periodic Housekeeping
  D2 DPP non-periodic Housekeeping
  DI EPIC MOS or RGS diagnostic
  DL EPIC PN discarded lines data
  DP RGS Digital Pre-Processor non periodic housekeeping
  EC EPIC MOS extra heating configuration non-periodic housekeeping (if II=M1 or M2)
  EC EPIC Radiation Monitor (ERC) count rate (if II=RM)
  En OM engineering where $n=1-7$
  ES EPIC Radiation Monitor (ERC) spectra
  FA OM fast
  HB EPIC high bit rate interface buffer size non-periodic housekeeping
  HC EPIC high bit rate interface configuration non-periodic housekeeping
  HT EPIC MOS high bit rate interface threshold values non-periodic housekeeping
  HT RGS high time resolution
  IM EPIC or OM imaging
  NO EPIC PN noise data
  NP OM non-periodic housekeeping
  OF RGS offset file
  OD EPIC PN offset data
  OV EPIC MOS offset / variance
  P1 Spacecraft housekeeping 1 periodic housekeeping
  P2 Spacecraft housekeeping 2 periodic housekeeping
  P3 Spacecraft Attitude 1 periodic housekeeping
  P4 Spacecraft Attitude 2 periodic housekeeping
  P5 Spacecraft SYS_HK_SID0 periodic housekeeping
  P6 Spacecraft SYS_HK_SID1 periodic housekeeping
  P7 Spacecraft SYS_HK_SID4 periodic housekeeping
  P8 Spacecraft SYS_HK_SID5 periodic housekeeping
  P9 Spacecraft SYS_HK_SID6 periodic housekeeping
  PA EPIC PN additional periodic housekeeping
  PA OM priority field acquisition (auxiliary file)
  PC RGS CCD temperature periodic housekeeping
  PF RGS full periodic housekeeping
  PF OM priority fast (auxiliary file)
  PM EPIC PN main periodic housekeeping
  PT EPIC MOS bright pixel table non-periodic housekeeping
  PE EPIC MOS or OM periodic housekeeping
  RA Raw Attitude file
  RF OM reference frame (auxiliary file)
  RI EPIC MOS reduced imaging
  RO Spacecraft reconstructed orbit
  SP RGS spectroscopy
  SU Summary information
  TC Spacecraft time correlation
  TH OM tracking history (auxiliary file)
  TI EPIC timing
  TM EPIC thermal monitoring limits non-periodic housekeeping
  WD OM priority window data (auxiliary file)
F The file type
  E event list file
  I image file
  X auxiliary file
  H housekeeping
  S spacecraft
  M summary
ZZZ File format (3 characters)
  ASC ASCII file
  ASZ Compressed ASCII file
  FIT FITS file
  FTZ Compressed FITS file
  SAS SAS output (not original ODF constituents)
     

The nature of science ODF/SDF FITS files can also be identified by inspection of the value of the respective binary table(s) extension. This coding is described in Table 2. The Unix convention to indicate multiple files is used; e.g.: M[1,2]IME1 means M1IME1 (MOS1) and M2IME1 (MOS2).


Table 2: Binary table extension name(s) for the ODF/SDF files
File type BINTABLE ...
MOS Imaging Mode Event List File M[1,2]IME1
MOS Timing Mode Event List File M[1,2]TIE1
MOS Auxiliary File M[1,2]AUX1
MOS Periodic Housekeeping File PERIODIC_HK
PN Imaging Mode Event List File PNIME1
PN Timing Mode Event List File PNTIE1
PN Burst Mode PNBUE1
PN Auxiliary File (first extension) PNAUX1
PN Auxiliary File (second extension) PNAUX2
PN Housekeeping (first file) PERIODIC_HK
PN Housekeeping (second file) MAIN_PERIODIC
RGS Spectroscopy Mode Event List File R[1,2]SPE1
RGS High Time Resolution Event List File R[1,2]HTE1
RGS Auxiliary File (first extension) R[1,2]AUX1
RGS Auxiliary File (second extension) R[1,2]AUX2
RGS Periodic Housekeeping Files PERIODIC_HK
OM Imaging Mode Image File OMIMI1
OM Fast Mode Event List File OMFAE1
OM Tracking History Data Auxiliary file OMTHX1
OM Reference Frame Auxiliary File OMRFX1
OM Periodic Housekeeping File OMPEH1
OM Non-Periodic Housekeeping File OMNPH1
Spacecraft Attitude History File SCATS1
Spacecraft Time Correlation File SCTSC1

Finally, the nature of a file can also be identified by the value of the keyword DATATYPE in the binary table header (see Table 3), although in this case only the file type can be unambiguously determined, whereas a degeneracy in the instrument remains.

As mentioned above, the housekeeping files cannot always be uniquely distinguished from their binary table extension. However, they can still be recognised by their file names.


next up previous contents
Next: 4.1.2 Observation/slew summary file Up: 4.1 Observation/Slew data science, non-science, and spacecraft files Previous: 4.1 Observation/Slew data science, non-science, and spacecraft files
European Space Agency - XMM-Newton Science Operations Centre