source: trunk/SRC/Documentation/xmldoc/wiki/GetSaxo @ 352

= 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
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}</code></em></code></strong>
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mkdir</strong></span> <em class="parameter"><code>My_IDL</code></em></code></strong>
      </pre>
}}}

== 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}}} @star@ IPSL: {{{/home/smlod/SAXO_DIR}}} @star@ 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'''{{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">ln</strong></span> <code class="option">-s</code> <em class="parameter"><code>/home/rech/eee/reee217/SAXO_DIR</code></em> <em class="parameter"><code>${HOME}/SAXO_DIR</code></em></code></strong>
          </pre>
}}}

          '''IPSL'''{{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">ln</strong></span> <code class="option">-s</code> <em class="parameter"><code>/home/smlod/SAXO_DIR</code></em> <em class="parameter"><code>${HOME}/SAXO_DIR</code></em></code></strong>
          </pre>
}}}

          '''LOCEAN'''{{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">ln</strong></span> <code class="option">-s</code> <em class="parameter"><code>/usr/home/smasson/SAXO_DIR</code></em> <em class="parameter"><code>${HOME}/SAXO_DIR</code></em></code></strong>
          </pre>
}}}

        
=== 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
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/</code></em> <em class="parameter"><code>SAXO_DIR</code></em></code></strong>
        </pre>
}}}

        The latest revision of the ''source files'' (44 Mb) can be checked out with the following command:
        {{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/SRC</code></em> <em class="parameter"><code>SAXO_DIR/SRC</code></em></code></strong>
        </pre>
}}}

        The latest revision of the ''NetCDF data files'' (728 Mb) used by the test programs can be checked out with the following command:
        {{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA</code></em> <em class="parameter"><code>SAXO_DIR/DATA</code></em></code></strong>
        </pre>
}}}

==== Contributors ====
''Contributors'' should better use the following command (and replace login by their own login):
        {{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>svn+ssh://<code class="replaceable">login</code>@forge.ipsl.jussieu.fr/ipsl/forge/projets/saxo/svn/trunk/</code></em> <em class="parameter"><code>SAXO_DIR</code></em></code></strong>
        </pre>
}}}

=== Get SAXO from a tar file ===

==== Get SAXO source files (5.8M Mb) ====

          Create your {{{${HOME}/SAXO_DIR}}} directory 

          {{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}</code></em></code></strong>
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mkdir</strong></span> <em class="parameter"><code>SAXO_DIR</code></em></code></strong>
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>SAXO_DIR</code></em></code></strong>
          </pre>
}}}

          
 and download it the latest version of the sources tar file: [http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20080321r339.tar.gz SAXO_SRC_20080321r339.tar.gz] (5.8M Mb).

This tar.gz file could also be downloaded with {{{wget}}} or {{{curl}}}
          '''wget'''{{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">wget</strong></span> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20080321r339.tar.gz</code></em></code></strong>
          </pre>
}}}

          '''curl'''{{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">curl</strong></span> <code class="option">-O</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/download/SAXO_SRC_20080321r339.tar.gz</code></em></code></strong>
          </pre>
}}}

                
        Untar the file
        {{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}/SAXO_DIR</code></em></code></strong>
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">tar</strong></span> <code class="option">xvfz</code> <em class="parameter"><code>SAXO_SRC_20080321r339.tar.gz</code></em></code></strong>
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">rm</strong></span> <em class="parameter"><code>SAXO_SRC_20080321r339.tar.gz</code></em></code></strong>
        </pre>
}}}

==== 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 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 [#Create SAXO environment]) or directly within IDL with the following command: idl&gt;iodir = '''''the chosen directory'''''.
           {{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}</code></em></code></strong>
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mkdir</strong></span> <em class="parameter"><code><code class="replaceable">CHOSEN_DIR</code></code></em></code></strong>
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="replaceable">CHOSEN_DIR</code></code></em></code></strong>
        </pre>
}}}

        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
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">wget</strong></span> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz</code></em></code></strong>
          </pre>
}}}

          '''curl'''{{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">curl</strong></span> <code class="option">-O</code> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/saxo/download/SAXO_DATA_20060602.tar.gz</code></em></code></strong>
          </pre>
}}}

        
== 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
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>${HOME}/SAXO_DIR/SRC</code></em></code></strong>
  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">idl</strong></span></code></strong>
  <code class="computeroutput">IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</code>

  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">buildinit</strong></span></code></strong>
  <code class="computeroutput">% Compiled module: BUILDINIT.</code>
        </pre>
}}}

        You must then answer several questions:
 * give the path of {{{${HOME}/My_IDL}}} @star@ give the path of {{{${HOME}/SAXO_DIR}}} @star@ compatibility with the old version: No (except if you want to use old programs) @star@ give a default path for the data directory @star@ give a default path for the postscript directory @star@ give a default path for the images directory @star@ give a default path for the animation directory @star@ number of accessible printer and their configuration @star@ default color table @star@ default page orientation (portrait/landscape) @star@ default page size @star@ default window size @star@ postscript archiving options @star@ name of the init file ({{{init.pro}}}){{{
#!html
<pre xmlns:xl="http://www.w3.org/1999/xlink" class="screen">
   <code class="computeroutput">% Compiled module: CW_FIELD.</code>
   <code class="computeroutput">% Compiled module: XMANAGER.</code>
   <code class="computeroutput">% Compiled module: LOADCT.</code>
   <code class="computeroutput">% Compiled module: FILEPATH.</code>
   <code class="computeroutput">% Compiled module: PATH_SEP.</code>
   <code class="computeroutput">% Compiled module: CW_FIELD.</code>
   <code class="computeroutput">% Compiled module: STRSPLIT.</code>
   <code class="computeroutput">% Compiled module: CW_FIELD.</code>
   <code class="computeroutput">% Compiled module: CW_FIELD.</code>
   <code class="computeroutput">% Compiled module: CW_FIELD.</code>
   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">exit</strong></span></code></strong>
        </pre>
}}}

        There is an example of the kind of [idlfiles/init_example.pro  init.pro] you should get.
      
== After this ==

You are now ready to do your
[wiki:FirstSteps First steps with SAXO].