SébastienMassonsmasson@lodyc.jussieu.fr FrançoisePinsardfplod@lodyc.jussieu.fr idl SAXO 0.0 May 2006 First draft 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 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 appropiate directory: IDRIS $ ln -s /home/rech/eee/reee217/SAXO_DIR ${HOME}/SAXO_DIR LOCEAN $ ln -s /usr/home/smasson/SAXO_DIR ${HOME}/SAXO_DIR The complete latest revision (source + tests data files: ~750 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 (~25 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 (~725 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 : $ 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_DIR_&date;.tar.gz (&szsrc; Mb). This tar.gzip file could also be downloaded with wget $ wget http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_DIR_&date;.tar.gz curl $ curl -O http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_DIR_&date;.tar.gz Untar the file $ cd ${HOME}/SAXO_DIR $ tar xvfz SAXO_DIR_*.tar.gz $ rm SAXO_DIR_*.tar.gz If you want to use the tests programs, you need to download the data tests files (TestsData_&date2;.tar.gz), You may download theses files in ${HOME}/My_IDL. This is the easiest solution but it could be unconvenient 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 commad: &promptidl; iodir = "the chosen directory" $ cd ${HOME} $ mkdir "CHOSEN_DIR" $ cd "CHOSEN_DIR" Download the files through thoses links... (49 Mb) (19 Mb) (264 Mb) (27 Mb) (2 Mb) ... or with wget $ wget http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_1x1.nc $ wget http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc $ wget http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc $ wget http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA2.nc $ wget http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA05.nc curl $ curl -O http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_1x1.nc $ curl -O http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc $ curl -O http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc $ curl -O http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA2.nc $ curl -O http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA05.nc 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 ben created, init.pro should the first executed command when starting IDL session. $ cd ${HOME}/SAXO_DIR $ 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.