Revision History | |
---|---|
Revision 0.0 | May 2006 |
First draft | |
Revision 0.1 | April 2008 |
migration from DocBook 4.2 to Docbook 5.0 |
Table of Contents
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
SAXO is already installed at
rhodes
: /home/rech/eee/reee217/SAXO_DIR
/home/smlod/SAXO_DIR
/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:
$
ln
-s
/home/rech/eee/reee217/SAXO_DIR
${HOME}/SAXO_DIR
$
ln
-s
/home/smlod/SAXO_DIR
${HOME}/SAXO_DIR
$
ln
-s
/usr/home/smasson/SAXO_DIR
${HOME}/SAXO_DIR
The complete latest revision (source + tests data files: 771 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 (44 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 (728 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
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
http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20090723r402.tar.gz
$
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
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
http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz
$
curl
-O
http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz
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:
${HOME}/My_IDL
${HOME}/SAXO_DIR
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.
You are now ready to do your First steps with SAXO.