SébastienMassonSebastien.Masson_at_locean-ipsl.upmc.fr FrançoisePinsardFrancoise.Pinsard_at_locean-ipsl.upmc.fr IDL SAXO 0.0 May 2006 First draft $Id$ 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 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 theses 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 The complete latest revision (source + tests data files: &szallsvn; 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 (&szsrcsvn; 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 (&szdatasvn; 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 Contributors should better use the following command (and replace login by your own login): $ svn checkout svn+ssh://login@forge.ipsl.jussieu.fr/ipsl/forge/projets/saxo/svn/trunk/ SAXO_DIR 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_&date;.tar.gz (&szsrc; Mb). This tar.gz file could also be downloaded with wget $ wget http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_&date;.tar.gz curl $ curl -O http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_&date;.tar.gz Untar the file $ cd ${HOME}/SAXO_DIR $ tar xvfz SAXO_SRC_&date;.tar.gz $ rm SAXO_SRC_&date;.tar.gz If you want to use the tests programs, you need to download the data tests files (SAXO_DATA_&date2;.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. 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 ) or directly within IDL with the following command: &promptidl; iodir = the chosen directory $ cd ${HOME} $ mkdir CHOSEN_DIR $ cd CHOSEN_DIR Download SAXO_DATA_&date2;.tar.gz (&szdata; Mb) … or with wget $ wget http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_&date2;.tar.gz curl $ curl -O http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_&date2;.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. &promptidl; 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. &promptidl; 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.