As with EPIC and RGS datasets, many files are associated with an OM dataset. The INDEX.HTM file, and links therein, are viewable with a web browser and will help you navigate the dataset. The different types of files are discussed in Chapter 3.2; however, since the OM is somewhat different from the other instruments on-board XMM-Newton, we will discuss them in more detail in later sections.
The OM can operate in Imaging, Fast, and Grism mode. Each of these modes has dedicated commands to reprocess the data: omichain, omfchain, and omgchain. These are metatasks that each call several procedures that are used to prepare the data for processing, make and apply flatfield images, and detect sources. The tasks omichain and omfchain also calculate the instrumental magnitudes of sources, find the position of the sources (in equatorial coordinates), and produce a sky image; omgchain produces a spectrum. If you run these chains, it is helpful to inspect the sas_log file to get a detailed list of the performed tasks. These chains rely on filters specified by the user; if no arguments are given, they run on all the files present in the ODF directory. Due to the long file names and the large number of input parameters, users are urged to simply use the chains and not run the chains' individual tasks one at a time.
Most OM data are obtained in Imaging mode. If they were obtained in the Fast mode, there will be an additional event list file corresponding to the Fast window (*FAE.FIT). Reprocessing of data taken in Fast mode using the command line and SAS GUI is discussed in §8.3. Reprocessing OM Grism data is discussed in §8.4.
As always, it is strongly recommended that you keep all reprocessed data in its own directory! SAS places output files in whichever directory it is in when a task is called. Throughout this Guide, it is assumed that the Pipeline Processed data are in the PPS directory, the ODF data (with upper case file names, and uncompressed) are in the directory ODF, and the analysis is taking place in the PROC directory. It is also assumed that the data were prepared for processing (see §5). For example data, we will use observations of the Lockman Hole (Obs ID 0123700101; the same as for the EPIC walk-through) for Image mode, Mkn 421 (Obs ID 0411081601; NOT the same as for the RGS walk-through!) for Fast mode, and BPM 16274 (Obs ID 0125320801) for Grism mode, though any dataset with the appropriate mode will suffice.
Before proceeding with the pipeline, it is appropriate to discuss the artifacts that often affect OM images. These can affect the accuracy of a measurement by, for example, increasing the background level. Some of these can be seen in Fig. 8.1.
Further, artifacts also can contaminate grism data. Due to this mode's complexity, users are urged to be very careful when working with grism data, and should refer to the SOC's website on this topic.
Users should also keep in mind some differences between OM data and X-ray data. Unlike EPIC and RGS, there are no good time intervals (GTIs) in OM data; an entire exposure is either kept or rejected. Also, OM exposures only provide direct energy information when in grism mode, and the flat field response of the detector is assumed to be unity.
For detailed descriptions of PP data nomenclature, file contents, and which tasks can be used to view them, see Tables 3.2 and 3.3.
If you simply want a quick look at your data, sky images and source lists are in *SIMAGE*.FTZ and *SWSRLI*.FTZ, respectively. Further, there are low resolution sky images for each filter; they follow the nomenclature:
So for example, P0123700101OMX000RSIMAGV000.FTZ is the final low resolution sky image in the V filter. To see what files have been summed to make the final image, search for the keyword XPROC0 in the FITS header. For our example image, this would be
XPROC0 = 'ommosaic imagesets=''product/P0123700101OMS004SIMAGE1000.FIT produc&' CONTINUE 't/P0123700101OMS415SIMAGE1000.FIT product/P0123700101OMS416SIMAGE10&' CONTINUE '00.FIT product/P0123700101OMS417SIMAGE1000.FIT product/P0123700101O&' CONTINUE 'MS418SIMAGE1000.FIT'' mosaicedset=product/P0123700101OMX000RSIMAGV0&' CONTINUE '00.FIT exposuremap=no exposure=1000 # (ommosaic-1.11.7) [xmmsas_200&' CONTINUE '61026_1802-6.6.0]'
The source list file (*SWSRLI*.FTZ) also contains useful information for the user; the column names are listed in Table 8.1.
|RA||RA of the detected source|
|DEC||Dec of the detected source|
|RATE||extracted count rate|
|RATE_ERR||error estimate on the count rate|
|SIGNIFICANCE||Significance of the detection (in )|
|MAG||Brightness of the source in magnitude|
|MAGERR||uncertainty on the magnitude|
Please note that calling any of the repipelining tasks will initiate
processing on all OM data of that particular mode; currently, only
omichain will accept parameters to limit processing to a
specific filter or exposure.
To rerun the pipeline on all exposures and filters from the command line, type
Alternatively, to run the pipeline from the SAS GUI,
This produces numerous files, including images and regions for each exposure and each filter. If we are interested in the sources detected in the mosaicked V band image, we could run omichain with the appropriate flags from the command line typing:
Alternatively, we can do it with the SAS GUI:
The output files can be used immediately for analysis, though users are strongly urged to examine the output for consistancy first (see §8.2.2). The chains apply all necessary corrections, so no further processing or filtering needs to be done. Please note that the chains do not produce output files with exactly the same names as those in the PPS directory (they also produce some files which are not included in the PPS directory at all.) Table 8.2 lists the file ID equivalences between repipelined and PPS files.
|EVLIST||none||Fast mode events list|
|FIMAG_||FIMAG_||combined full-frame image|
|FSIMAG||FSIMAG||combined full-frame sky image|
|HSIMAG||HSIMAG||full-frame HIRES sky image mosaic|
|IMAGE_||IMAGE_||image from any filter or Grism|
|IMAGE_||IMAGEF||Fast mode image|
|LSIMAG||LSIMAG||full-frame LORES sky image mosaic|
|OBSMLI||OBSMLI||combined observation source list|
|REGION||SWSREG||sources region file|
|REGION||SFSREG||Fast mode sources region file|
|REGION||SGSREG||Grism ds9 regions|
|RIMAGE||GIMAGE||Grism rotated image|
|RSIMAG||RSIMAG||default mode sky mosaic|
|SIMAGE||SIMAGE||sky aligned image|
|SIMAGE||SIMAGF||Fast mode sky aligned image|
|SIMAGE||none||Grism sky aligned image|
|SPCREG||SPCREG||Grism ds9 spectrum regions|
|SPECLI||SPECLI||Grism specra list|
|SPECTR||SPECTR||source extracted spectra|
|SWSRLI||SFSRLI||Fast mode sources list|
|SWSRLI||SGSRLI||Grism sources list|
|TIMESR||TIMESR||Fast mode source timeseries|
|TSHPLT||TSHPLT||tracking history plot|
|TSTRTS||TSTRTS||tracking star timeseries|
While the output from the chains is ready for analysis, OM does have some
peculiarities, as discussed in §8.1. While these
usually have only an aesthetic effect, they can also affect source brightness
measurements, since they increase the background. In light of this,
users are strongly encouraged to verify the consistency of the data prior to
analysis. There are a few ways to do this. Users can examine
the combined source list with fv, which will let them see if interesting
sources have been detected in all the filters where they are visible. Users can
also overlay the image source list on to the sky image with implot by
downloading the relevant files to the user's local machine. This can also be done
with ds9 or gaia by using slconv to change source lists
into region files and downloading the relevant files to your local machine.
The task slconv allows users to set the regions radii in arcseconds to a constant
value or scale them to header keywords, such as RATE. By default, ds9 region
files have suffixes of .reg; gaia region files have suffixes of .gaia.
In the example below, we make a region file from the source list for the
mosaicked, V-band sky image.
To make a ds9 region file from a source list from the command line, type:
The mosaicked, V-band sky image, P0123700101OMS000RSIMAGV.FIT, with the region file from slconv overlayed, is shown in Fig. 8.1. There clearly are spurious detections; these can be removed by hand, or by rerunning omichain with a different background-level threshold or source significance.
The repipelining task for OM data taken in fast mode is omfchain.
It produces images of the detected sources, extracts events related to the sources
and the background, and extracts the corresponding light curves. At present, unlike
omichain, omfchain does not allow for keywords to specify filters
or exposures; calling this task will process all fast mode data.
To run the pipeline on fast mode data on the command line, type
Alternatively, omfchain can be run from the GUI:
There are two types of output files: those that start with f are intermediate images or time series files; those that start with p are products. The output files are are described in Table 8.2.
To demonstrate some of these output files, we have rerun the pipeline on the example dataset. The processed image in sky-coordinates from one exposure, P0411081601OMS006SIMAGE1000.FIT, is shown in Fig. 8.2 (left). The background-subtracted light curve produced automatically by the task, F0411081601OMS006TIMESR1000.PS, is shown in Fig. 8.2 (right).
The repipelining task for OM data taken in grism mode is omgchain.
It produces images of the detected sources and background, extracts source
spectra and region files, and makes source lists and postscript and PDF plots.
At present, unlike omichain, omgchain does not allow for keywords
to specify filters or exposures; calling this task will process all grism mode data.
To run the pipeline on fast mode data on the command line, type
Alternatively, omgchain can be run from the GUI:
There are two types of output files: those that start with g are
intermediate or auxiliary files and source lists; those that start with
p are products. The output files are are described in Table 8.2.
To demonstrate some of these output files, we have rerun the pipeline on the example dataset. The processed image, rotated to align with the columns of the image (p0125320801OMS005RIMAGE0000.FIT), is shown in Fig. 8.3 (left). Two region files are overlayed: p0125320801OMS005REGION0001.ASC, which corresponds to the sources detected in this rotated image (green), and p0125320801OMS005SPCREG0001.ASC, which corresponds to the sources in the spectra list file (red) and indicates the locations of the zero and first orders. The task omgchain automatically extracted the spectrum of the red region (p0125320801OMS005SPECTR0000.FIT); this is shown in Fig. 8.3 (right).
The correct correlation of zero and first orders is crucial for grism analysis. Users should inspect the rotated image with fv or ds9 and verify the identification of the orders by overlaying the *SPCREG* region file, as shown in Fig. 8.3 (left); the *SPECLI* file also contains this informtaion. If users are interested in all source detections, the region file can also be overlayed and the full source list examined. Users should also examine the spectra plots automatically produced by omgchain, for both the source and background, making sure they are reasonable. For improved source detection, the parameter nsigma can be changed.