Get SAXO

svn Id of xml source file : $Id: getsaxo.xml 387 2008-12-05 11:55:40Z pinsard $

Revision History
Revision 0.0May 2006
First draft
Revision 0.1April 2008
migration from DocBook 4.2 to Docbook 5.0

Table of Contents

1. Create SAXO environment
2. Get SAXO files
2.1. If you work at IDRIS, IPSL or LOCEAN
2.2. If ??? is installed on your machine
2.3. Get SAXO from a tar file
3. Generate your init.pro file
4. After this

1.  Create SAXO environment

To simplify the explanation, we suppose that we install SAXO in your ${HOME}. We need to create 2 directories:

  • ${HOME}/SAXO_DIR that will contain the source files of SAXO. It should not be modified by the user to simplify later updates.
  • ${HOME}/My_IDL that will contain user personal files (including modified SAXO files, if needed).

  $ cd ${HOME}
  $ mkdir My_IDL
      

2.  Get SAXO files

2.1.  If you work at IDRIS, IPSL or LOCEAN

SAXO is already installed at

  • IDRIS, on rhodes: /home/rech/eee/reee217/SAXO_DIR
  • IPSL: /home/smlod/SAXO_DIR
  • LOCEAN: /usr/home/smasson/SAXO_DIR

If you can access one of these directories, there is no need to re-install SAXO again! In that case, you only have to link ${HOME}/SAXO_DIR to the appropriate directory:

IDRIS
  $ ln -s /home/rech/eee/reee217/SAXO_DIR ${HOME}/SAXO_DIR
  
IPSL
  $ ln -s /home/smlod/SAXO_DIR ${HOME}/SAXO_DIR
  
LOCEAN
  $ ln -s /usr/home/smasson/SAXO_DIR ${HOME}/SAXO_DIR
  

2.2.  If Subversion (svn) is installed on your machine

2.2.1.  Regular users

The complete latest revision (source + tests data files: 762 Mb) can be checked out with the following command executed in your ${HOME}:

  $ svn checkout http://forge.ipsl.jussieu.fr/saxo/svn/trunk/ SAXO_DIR

The latest revision of the source files (35 Mb) can be checked out with the following command:

  $ svn checkout http://forge.ipsl.jussieu.fr/saxo/svn/trunk/SRC SAXO_DIR/SRC

The latest revision of the NetCDF data files (727 Mb) used by the test programs can be checked out with the following command:

  $ svn checkout http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA SAXO_DIR/DATA

2.2.2.  Contributors

Contributors should better use the following command (and replace login by their own login):

  $ svn checkout svn+ssh://login@forge.ipsl.jussieu.fr/ipsl/forge/projets/saxo/svn/trunk/ SAXO_DIR

2.3.  Get SAXO from a tar file

2.3.1.  Get SAXO source files (5.9M Mb)

Create your ${HOME}/SAXO_DIR directory …

  $ cd ${HOME}
  $ mkdir SAXO_DIR
  $ cd SAXO_DIR
  

… and download it the latest version of the sources tar file: SAXO_SRC_20090723r402.tar.gz (5.9M Mb).

This tar.gz file could also be downloaded with wget or curl

wget
  $ wget http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20090723r402.tar.gz
  
curl
  $ curl -O http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20090723r402.tar.gz
  

Untar the file

  $ cd ${HOME}/SAXO_DIR
  $ tar xvfz SAXO_SRC_20090723r402.tar.gz
  $ rm SAXO_SRC_20090723r402.tar.gz

2.3.2.  Get SAXO tests data files (238M Mb)

If you want to use the tests programs, you need to download the data tests files (SAXO_DATA_20060602.tar.gz), you may download these files in

  • ${HOME}/My_IDL. This is the easiest solution but it could be inconvenient if your ${HOME} disk space is limited.
  • any other directory of your choice. In that case, when using IDL, you will need to define the variable iodir to the directory you choose in order to let IDL find the data tests files. This can be done either through the init.pro file (see Section 3, “ Generate your init.pro file ”) or directly within IDL with the following command:

     idl> iodir = the chosen directory
    

  $ cd ${HOME}
  $ mkdir CHOSEN_DIR
  $ cd CHOSEN_DIR

Download SAXO_DATA_20060602.tar.gz (238M Mb) or with wget or curl

wget
  $ wget http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz
   
curl
  $ curl -O http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz
  

3.  Generate your init.pro file

To use SAXO, we need to build an IDL script that we usually call "init.pro". This file contains a set of IDL commands and default definitions (paths and variables of the common files) that are necessary to SAXO. Once it has been created, init.pro should the first executed command when starting IDL session.

  $ cd ${HOME}/SAXO_DIR/SRC
  $ idl
  IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.

  idl> buildinit
  % Compiled module: BUILDINIT.

You must then answer several questions:

  • give the path of ${HOME}/My_IDL
  • give the path of ${HOME}/SAXO_DIR
  • compatibility with the old version: No (except if you want to use old programs)
  • give a default path for the data directory
  • give a default path for the postscript directory
  • give a default path for the images directory
  • give a default path for the animation directory
  • number of accessible printer and their configuration
  • default color table
  • default page orientation (portrait/landscape)
  • default page size
  • default window size
  • postscript archiving options
  • name of the init file (init.pro)

   % Compiled module: CW_FIELD.
   % Compiled module: XMANAGER.
   % Compiled module: LOADCT.
   % Compiled module: FILEPATH.
   % Compiled module: PATH_SEP.
   % Compiled module: CW_FIELD.
   % Compiled module: STRSPLIT.
   % Compiled module: CW_FIELD.
   % Compiled module: CW_FIELD.
   % Compiled module: CW_FIELD.
   idl> exit

There is an example of the kind of init.pro you should get.

4. After this

You are now ready to do your First steps with SAXO.