wiki:SAS

Version 15 (modified by Daniel Kahn gillmor, 20 years ago) ( diff )

--

Note: SAS depends on HEASOFT

Fernando asked the 'makers' of SAS whether it should 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

a clickable version of the link above.

Carlos The installation will be tested using the (FC3) RedHat Source/Binaries.

The intallation requires five tar.gz archives.

The first two tar.gz archives are common to all operating systems:

    * xmmsas_20050815_1803-common-doc.tar.gz
    * xmmsas_20050815_1803-common-config.tar.gz 

and the other three are OS specific:

    * xmmsas_20050815_1803-platform-bin.tar.gz
    * xmmsas_20050815_1803-platform-libextra.tar.gz
    * cal3.177_patch_platform.tar.gz 

where platform is a string describing your operating system.

The two xmmsas_20050815_1803-common-*.tar.gz archives are available under a subdirectory named Common.

The xmmsas_20050815_1803-platform-*.tar.gz archives and the cal3.177_patch_platform.tar.gz archive can be found under the specific operating system directory.

The file cal3.177_patch_platform.tar.gz corresponds to a Patch to SAS 6.5.0 introduced November 2nd, 2005.

Software Dependancies/Requirements

SAOImage ds9:
SAOImage DS9 is an astronomical imaging and data visualization application used by SAS.

    * Version 3.0.3 or later
    * Each version of ds9 requires the xpa software, which can be obtained from the same 
      site as ds9. For ds9 3.0.3 the required xpa version is 2.1.6. Notice that XPA is not part of ds9.
    * Warning: xpa 2.1.6 does not work on Red Hat 9 and Fedora Core 1. 
      For these systems please download xpa 2.1.6-2. 


cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ sudo apt-cache search ds9
saods9 - image display tool for astronomy
cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$


Grace:
Grace is a plotting tool based on X11 and Motif, used by SAS for 2D plots display and graphical selection.

    * Version 5.1.18 or later 

cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ sudo apt-cache search grace
grace - An XY plotting tool
grace6 - An XY plotting tool
cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$

Will test using grace6.


Heasoft:
Some SAS tasks require FTOOLS to be installed either individually or as part of the HEASOFT software.

We recommend the installation of HEASOFT version 6.0 (HEADAS), since SAS 6.5.0 was built with that version (except for Mac OS X where version 5.3 was used). 

Will test using Heasoft 6.04.


Perl:
Some SAS tasks require perl. However, the perl version in your machine does not need to match necessarily the one used to build SAS.
The perl binary installed in your system must be adapted to work with SAS as /usr/local/bin/perl, either as a real binary or as a soft link to any other perl (typically in /usr/bin/perl).
On some GNU/Linux distributions you may have to create a symbolic link as:
ln -s /usr/bin/perl /usr/local/bin/perl 

Installation

  1. Created sas directory under /usr/local/:
    cdelacruz@metis:/usr/local$ sudo mkdir sas
    
  2. Unpacked there the four tar.gz archives that you downloaded:
    cdelacruz@metis:/usr/local/sas$ sudo gzip -d *.gz
    cdelacruz@metis:/usr/local/sas$ sudo tar xf xmmsas_20050815_1803-common-config.tar
    cdelacruz@metis:/usr/local/sas$ sudo tar xf xmmsas_20050815_1803-common-doc.tar 
    cdelacruz@metis:/usr/local/sas$ sudo tar xf xmmsas_20050815_1803-i686-pc-linux-gnu-fc3-bin.tar
    cdelacruz@metis:/usr/local/sas$ sudo tar xf xmmsas_20050815_1803-i686-pc-linux-gnu-fc3-libextra.tar
    
  3. Ran the script configure_install:
    ./configure_install 
    cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ sudo ./configure_install
    
    Checking for the RELEASE file: OK
    Checking we are in the top directory: OK
    Checking for the SAS setup scripts: OK
    Checking whether perl is located in the right place or not: You need perl in /usr/local/bin - Abort
    cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ which perl
    /usr/bin/perl
    cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ ls
    
  4. created a symbolic link to eliminate the install script error:
    ln -s /usr/bin/perl /usr/local/bin/perl 
    cdelacruz@metis:/usr/local/bin$ sudo ln -s /usr/bin/perl /usr/local/bin/perl
    
    cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ sudo ./configure_install 
    Checking for the RELEASE file: OK
    Checking we are in the top directory: OK
    Checking for the SAS setup scripts: OK
    Checking whether perl is located in the right place or not: It is
    
    The installation of xmmsas_20050815_1803 seems to be OK
    
    Writing setup.sh : Done
    Writing setup.csh: Done
    
    cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$
    
  5. Ran the setup environment script:
    . /top_dir/xmmsas_20050815_1803/setsas.sh (sh/bash/ksh)
    
    source /top_dir/xmmsas_20050815_1803/setsas.csh (csh/tcsh)
    

The setsas.[c]sh scripts take care of all the details required to setup properly the environment to run SAS, except for the SAS_CCFPATH, the SAS_ODF and the SAS_CCF environment variables, which depend on where the XMM-Newton data to be analyzed have been placed.

allow execution of setup scripts:

cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ sudo chmod 755 setsas.sh
cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ sudo chmod 755 setsas.csh


cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ ./setsas.sh

sasversion:- XMM-Newton SAS release and build information:

SAS release: xmmsas_20050815_1803-6.5.0
Compiled on: Tue Aug 16 10:00:06 CEST 2005
Compiled by: sasbuild@localhost.localdomain
Platform   : Fedora Core release 3 (Heidelberg)

SAS-related environment variables that are set:

SAS_DIR = /usr/local/sas/xmmsas_20050815_1803
SAS_PATH = /usr/local/sas/xmmsas_20050815_1803

Do not forget to define SAS_CCFPATH, SAS_CCF and SAS_ODF
cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$

Need to define the following for testing:

define SAS_CCFPATH, SAS_CCF and SAS_ODF

  1. Added the 'sasenv' alias to the .bashrc file:
    ### SAS Environment ###
    alias sas=". /usr/local/sas/xmmsas_20050815_1803/setsas.sh"
    
  2. Install patch:

move archive to the respective SAS 6.5.0 top installation directory and unpack it.

cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ sudo tar xf cal3.177_patch_fc3.tar

ran the patch_script shell script:

cdelacruz@metis:/usr/local/sas/xmmsas_20050815_1803$ sudo ./patch_script
Patch already applied - Exit

Testing

Marc Audard suggested installing the calibration files for testing.

  1. Directory created under /usr/local/sas/CCF
    cdelacruz@metis:/usr/local/sas$ sudo mkdir CCF 
    cdelacruz@metis:/usr/local/sas$ cd CCF
    
  2. Download the files from here
Note: See TracWiki for help on using the wiki.