Revision History | |
---|---|
Revision 0.0 | May 2006 |
First draft |
Table of Contents
To simplify the explanation, we suppose that we install
SAXO in your
. We need to
create 2 directories:${HOME}
${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 theses directories, there is no need to
re-install SAXO again! In that
case, you only have to link
to the appropriate
directory:${HOME}
/SAXO_DIR
$
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: 782 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 (55 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
Create your
directory...${HOME}
/SAXO_DIR
$
cd
${HOME}
$
mkdir
SAXO_DIR
$
cd
SAXO_DIR
... and download it the latest version of the sources tar file: SAXO_SRC_20060828.tar.gz (5.5M Mb). This tar.gz file could also be downloaded with
$
wget
http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20060828.tar.gz
$
curl
-O
http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20060828.tar.gz
Untar the file
$
cd
${HOME}
/SAXO_DIR$
tar
xvfz
SAXO_SRC_20060828.tar.gz
$
rm
SAXO_SRC_20060828.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
theses files in
${HOME}
/My_IDL
. This is the easiest solution
but it could be inconvenient if your ${HOME}
disk space is limited.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
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.