= Get SAXO = [[PageOutline]] == 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). {{{ #!html

  $ cd ${HOME}
  $ mkdir My_IDL

}}} == Get SAXO files == === 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''' {{{ #!html

  $ ln -s /home/rech/eee/reee217/SAXO_DIR ${HOME}/SAXO_DIR

}}} '''IPSL''' {{{ #!html

  $ ln -s /home/smlod/SAXO_DIR ${HOME}/SAXO_DIR

}}} '''LOCEAN''' {{{ #!html

  $ ln -s /usr/home/smasson/SAXO_DIR ${HOME}/SAXO_DIR

}}} === If Subversion (svn) is installed on your machine === ==== Regular users ==== The '''complete''' latest revision (source + tests data files: 771 Mb) can be checked out with the following command executed in your ${HOME}: {{{ #!html

  $ 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: {{{ #!html

  $ 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: {{{ #!html

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

}}} ==== Contributors ==== '''Contributors''' should better use the following command (and replace login by their own login): {{{ #!html

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

}}} === Get SAXO from a tar file === ==== Get SAXO source files (5.9M Mb) ==== Create your {{{${HOME}/SAXO_DIR}}} directory … {{{ #!html

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

}}} … and download it the latest version of the sources tar file: [http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20090723r402.tar.gz SAXO_SRC_20090723r402.tar.gz] (5.9M Mb). This tar.gz file could also be downloaded with {{{wget}}} or {{{curl}}} '''wget''' {{{ #!html

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

}}} '''curl''' {{{ #!html

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

}}} Untar the file {{{ #!html

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

}}} ==== 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 [#CreateSAXOenvironment Create SAXO environment]) or directly within IDL with the following command: {{{ #!html

 idl> iodir = the chosen directory

}}} {{{ #!html

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

}}} Download [http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz SAXO_DATA_20060602.tar.gz] (238M Mb) or with {{{wget}}} or {{{curl}}} … '''wget''' {{{ #!html

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

}}} '''curl''' {{{ #!html

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

}}} == 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. {{{ #!html

  $ 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}}}) {{{ #!html

   % 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 [source:/trunk/SRC/Documentation/xmldoc/idlfiles/init_example.pro init.pro] you should get. == After this == You are now ready to do your [wiki:FirstSteps First steps with SAXO].