Afterwards the information extracted from the instruments housekeeping files and from the calibration database have to be appended to the summary file, within ODF. This task is done through the SAS command odfingest, resulting in an extended SAS summary file which will be needed for the subsequent data processing.
Then run:
odfingest
without any additional option. The resulting summary file is produced in the working directory and named as
'REV'_'OBS'_SCX00000SUM.SAS
where 'REV' is the revolution number and 'OBS' is the observation number of the data.
The ODF Summary File is an ASCII file, which can be easily edited. It contains a lot of information necessary to run SAS on the data, including the path to the ODF files (changing the location of the ODF files makes therefore necessary to edit the file accordingly). This file provides all the information about the ODFs. SAS needs to be pointed to it by substituting the current definition of the $SAS_ODF environment variable by the full definition of the summary file, as follows
export SAS_ODF=<Summary_file> [sh, bash, ksh] setenv SAS_ODF <Summary_file> [csh, tcsh]
where in
Summary_file
we need to write the full path and file name of the
summary file.
Write access is not required for the ODF and CCF directories.
Now you are ready for starting the work on the XMM-Newton data. The configuration setting as described above is the recommended one, with a working directory per observation, on which all products of the SAS tasks will be put (unless explicitly stated differently). At this point the working directory should have two files: the calibration index file and the ODF summary file.
All the steps listed above could be contained in a setup script to be called the first time one works on a dataset. The following is an example for such a script to be run on csh/tcsh shells, giving the path to the directory containing the ODF data as the only parameter,
source /top_dir/xmmsas_YYYYMMDD_HHMM/setsas.csh setenv SAS_ODF $1 setenv SAS_CCFPATH /path/to/CCF cifbuild setenv SAS_CCF $PWD/ccf.cif odfingest set sumfile=`ls -1 *SUM.SAS` setenv SAS_ODF $PWD/$sumfile