Throughout this Primer, data from the HEASARC archive are used to illustrate how to run tasks for each instrument on XMM-Newton; new users are encouraged to use these sample data, though in should be noted that any data from the relevant instrument will do. Information about the example datasets are in Table 6.1.
Instrument | Chapter | ObsID | Object |
EPIC | 7 | 0123700101 | Lockman Hole |
EPIC (Timing mode) | 7.4 | 0122700101 | G21.5-09 |
RGS | 8 | 0153950701 | Mkn 421 |
OM (Image mode) | 9.2 | 0123700101 | Lockman Hole |
OM (Fast mode) | 9.3 | 0411081601 | Mkn 421 |
OM (Grism mode) | 9.4 | 0125320801 | BPM 16274 |
Regardless of which instrument you are interested in, one task is necessary to prepare the data for processing, odfingest. To demonstrate odfingest, and a host of other tasks in §7, we will use the Lockman Hole data with ObsID 0123700101, though any dataset will work equally well.
To begin, either run anonymous Hera by clicking on the ``H'' next to the dataset
in the archive (see §4), or download the dataset from the HEASARC
archive and initialize standard Hera (see §4.1 and §
4.2, respectively). Select all the zipped files in
the ODF directory and unzip them; multiple files can be selected at once by holding
the shift or control key, and right-clicking on the selected files will bring up a
menu with the option to unzip them. (This takes a long time.)
The task odfingest extends the Observation Data File (ODF) summary
file with data extracted from the instrument housekeeping data files and
the calibration database. It is required for reprocessing the ODF data with
the pipeline tasks, as well as for many other tasks, and it is only necessary to
run it once on any dataset. If for some
reason odfingest must be rerun, you must first delete the earlier
file it produced. This file largely follows the naming convention
described in §5.3.3, but has SUM.SAS appended to it.
Hera will automatically set the environment parameter SAS_ODF
to the SUM.SAS file in the active dataset's ODF directory, if one exists.
If there is no SUM.SAS file, the SAS_ODF variable maintains its default
value (the dataset's ODF directory).
To run odfingest, first make sure that the ODF directory is highlighted in the GUI. Then,
The command and parameters will be echoed and dialog from the task will be shown
in the Command Window. The warnings can be ignored. The prompt will return when
it is complete. (Please note that while tasks can be run from the Command Window
as well as the GUI, due to network security issues, you cannot use the standard
linux commands to navigate between directories, move files, etc. in the Command
Window.)
At this point, the data is ready to be repipelined and analyzed. Data from the EPIC camera is discussed in §7, the RGS is in §8, and the OM is in §9. It is strongly recommended that all reprocessed data be kept in its own directory, and all the following chapters will assume that tasks are being called from the PROC directory.
To make PROC, select and right-click on the ObsID directory; the option to create a new directory will be in the menu. Please note that new directories will always be placed in the directory that was highlighted when the command was given, and similarly, all processing and analysis tasks that are called will be run from (and place output in) whichever directory is highlighted. So if you flip between directories often, it is a good idea to verify you are where you want to be before calling a task.