XMM-Newton Science Analysis System: Users' Guide


next up previous contents
Next: 2.4 Running SAS: Command Line or Graphical User Interface Up: 2.3 Starting a SAS session Previous: 2.3.3 cifbuild


2.3.4 odfingest

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


next up previous contents
Next: 2.4 Running SAS: Command Line or Graphical User Interface Up: 2.3 Starting a SAS session Previous: 2.3.3 cifbuild
European Space Agency - XMM-Newton Science Operations Centre