XMM-Newton Science Analysis Software (SAS)
The Science Analysis Software (SAS) is an extensive suite of software tools developed to process the data collected by the XMM-Newton Observatory.
SAS is released periodically. With each release, new software developments and bug fixes are included with the aim to improve the processing of XMM-Newton data.
For a more detailed description of SAS, go to http://xmm.esac.esa.int/sas/7.0.0/documentation/sas_concise.shtml .
Using SAS
To use SAS, you should run the script 'setsas.sh' in the installation directory. On the CAL Configured Workstations, there is a script, 'sas-shell' in the path that runs that script for you, so all you have to do on a Configured Workstation is run:
sas-shell
That will set some environment variables that will make all of SAS available to you. Here is a link to the complete documentation on all the packages that SAS offers: http://xmm.esac.esa.int/sas/7.0.0/doc/ .
Installing SAS
Dependencies
SAS depends on SAOImage ds9, Grace, HEASOFT, and perl. See http://xmm.esac.esa.int/sas/7.0.0/requirements/ for more information on software dependencies.
OS Support
SAS runs on Linux, but they only supply binary packages for certain releases of Red Hat and SuSE Linux. Fernando asked the 'makers' of SAS whether it would work ok in debian:
Dear Fernando, We do not have (and do not formally support) a specific SASv6.5 for Debian. However, many users have installed SASv6.5 on Debian without problems. It is recommended to try either with the Fedora Core 3 or with the Linux Enterprise 4 version. The helpdesk 'ticket' number 20352, under SASv6.5_Installation folder, direct link: http://xmm.vilspa.esa.es/xmmhelp/SASv6.5_Installation?id=20352;user=guest contains some practical details from one Debian user that can be useful for you as well. He used the Fedora Core 3 distribution. Should you have further problems or questions, please do not hesitate to contact us again Best regards Maria
Step-by-step Installation Guide
First download two Red Hat Fedora Core 3 binaries and two platform independent files:
cd /scratch wget ftp://xmm.vilspa.esa.es/pub/sas/7.0.0/Linux/Fedora/3/xmmsas_20060628_1801-i686-pc-linux-gnu-fc3-bin.tar.gz wget ftp://xmm.vilspa.esa.es/pub/sas/7.0.0/Linux/Fedora/3/xmmsas_20060628_1801-i686-pc-linux-gnu-fc3-libextra.tar.gz wget ftp://xmm.vilspa.esa.es/pub/sas/7.0.0/Common/xmmsas_20060628_1801-common-config.tar.gz wget ftp://xmm.vilspa.esa.es/pub/sas/7.0.0/Common/xmmsas_20060628_1801-common-doc.tar.gz
Move to the installation directory (switching to root if necessary), unpack the archives, and run the configure_install script:
cd /opt/sas tar zxvf /scratch/xmmsas_20060628_1801-common-config.tar.gz tar zxvf /scratch/xmmsas_20060628_1801-common-doc.tar.gz tar xzvf /scratch/xmmsas_20060628_1801-i686-pc-linux-gnu-fc3-bin.tar.gz tar xvzf /scratch/xmmsas_20060628_1801-i686-pc-linux-gnu-fc3-libextra.tar.gz chown -R root:root xmmsas_20060628_1801 cd xmmsas_20060628_1801 ./configure_install
SAS expects perl to be located at /usr/local/bin/perl. If it is not, create a symbolic link:
ln -s /usr/bin/perl /usr/local/bin/perl
And you may need to set the execute bits on some scripts:
chmod 755 /opt/sas/xmmsas_20050815_1803/setsas.sh chmod 755 /opt/sas/xmmsas_20050815_1803/sas-setup.sh
And on the Configured Workstations I created a file in the path, /usr/local/bin/sas-shell, that contains:
#!/bin/bash . /opt/sas/current/setsas.sh exec /bin/bash
The setsas.sh (or sas-shell) script takes care of all the details required to setup properly the environment to run SAS, except for the SAS_CCFPATH, SAS_ODF, and SAS_CCF environment variables, which depend on where the XMM-Newton data to be analyzed have been placed.
And finally, on the Configured Workstations, I installed the "reduced" Calibration Archive in /opt/sas/CCF by running:
rsync -v -a --delete --delete-after --force --include='*.CCF' --exclude='*/' xmm.esac.esa.int::XMM_RED_CCF /opt/sas/CCF chown -R root:root /opt/sas/CCF
