Index: trunk/SRC/Documentation/xmldoc/firststeps.html
===================================================================
--- trunk/SRC/Documentation/xmldoc/firststeps.html	(revision 77)
+++ trunk/SRC/Documentation/xmldoc/firststeps.html	(revision 78)
@@ -3,111 +3,27 @@
    <title>
     First steps with SAXO
-  </title><link rel="stylesheet" href="firststeps.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><meta name="keywords" content="idl, SAXO"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="d0e3"></a>
+  </title><link rel="stylesheet" href="firststeps.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.69.1"><meta name="keywords" content="idl, SAXO"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="d0e3"></a>
     First steps with <span class="application">SAXO</span>
-  </h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">S&eacute;bastien</span> <span class="surname">Masson</span></h3><code class="email">&lt;<a href="mailto:smasson@lodyc.jussieu.fr">smasson@lodyc.jussieu.fr</a>&gt;</code></div><div class="author"><h3 class="author"><span class="firstname">Fran&ccedil;oise</span> <span class="surname">Pinsard</span></h3></div></div></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="2"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.0</td><td align="left">29 July 2005</td></tr><tr><td align="left" colspan="2">First draft</td></tr><tr><td align="left">Revision 0.1</td><td align="left">29 August 2005</td></tr><tr><td align="left" colspan="2">last japanese version!</td></tr></table></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#install_saxo">1. 
-      Install <span class="application">SAXO</span>
-    </a></span></dt><dd><dl><dt><span class="sect2"><a href="#get_saxo">1.1. 
-	Get <span class="application">SAXO</span> source files from this web page
-      </a></span></dt><dt><span class="sect2"><a href="#create_saxo_env">1.2. 
-	Create <span class="application">SAXO</span> environment
-      </a></span></dt><dt><span class="sect2"><a href="#generate_init">1.3. 
-	Generate your init.pro file
-      </a></span></dt></dl></dd><dt><span class="sect1"><a href="#first_plots">2. 
+  </h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">S&eacute;bastien</span> <span class="surname">Masson</span></h3><code class="email">&lt;<a href="mailto:smasson@lodyc.jussieu.fr">smasson@lodyc.jussieu.fr</a>&gt;</code></div><div class="author"><h3 class="author"><span class="firstname">Fran&ccedil;oise</span> <span class="surname">Pinsard</span></h3></div></div></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="2"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.0</td><td align="left">29 July 2005</td></tr><tr><td align="left" colspan="2">First draft</td></tr><tr><td align="left">Revision 0.1</td><td align="left">29 August 2005</td></tr><tr><td align="left" colspan="2">last japanese version!</td></tr><tr><td align="left">Revision 0.2</td><td align="left">May 2006</td></tr><tr><td align="left" colspan="2">split with getsaxo</td></tr></table></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#first_plots">1. 
       First plots...
-    </a></span></dt><dd><dl><dt><span class="sect2"><a href="#start_with_init">2.1. 
+    </a></span></dt><dd><dl><dt><span class="sect2"><a href="#start_with_init">1.1. 
 	Start idl session: <strong class="userinput"><code><span><strong class="command">@init</strong></span></code></strong>
-      </a></span></dt><dt><span class="sect2"><a href="#basic_plots">2.2. 
+      </a></span></dt><dt><span class="sect2"><a href="#basic_plots">1.2. 
 	basic plots...
-      </a></span></dt></dl></dd><dt><span class="sect1"><a href="#gridded_data">3. 
+      </a></span></dt></dl></dd><dt><span class="sect1"><a href="#gridded_data">2. 
       Explore gridded data (model outputs and observations)
-    </a></span></dt><dd><dl><dt><span class="sect2"><a href="#load_grid">3.1. 
+    </a></span></dt><dd><dl><dt><span class="sect2"><a href="#load_grid">2.1. 
 	Load the data grid
-      </a></span></dt><dt><span class="sect2"><a href="#plt">3.2. 
+      </a></span></dt><dt><span class="sect2"><a href="#plt">2.2. 
 	horizontal plots and maps
-      </a></span></dt><dt><span class="sect2"><a href="#pltz">3.3. 
+      </a></span></dt><dt><span class="sect2"><a href="#pltz">2.3. 
 	vertical sections
-      </a></span></dt><dt><span class="sect2"><a href="#pltt">3.4. 
+      </a></span></dt><dt><span class="sect2"><a href="#pltt">2.4. 
 	hovmoellers and time series
-      </a></span></dt><dt><span class="sect2"><a href="#plt1d">3.5. 
+      </a></span></dt><dt><span class="sect2"><a href="#plt1d">2.5. 
 	1D plots
-      </a></span></dt></dl></dd></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="install_saxo"></a>1.&nbsp;
-      Install <span class="application">SAXO</span>
-    </h2></div></div></div><p>
-	<span class="application">SAXO</span> needs at least <span class="trademark">IDL 6.0</span>&#8482;.
-	<em><span class="remark"><span class="application">SAXO</span> can be used with the 7 minutes demo-mode (within the limitations of this mode: impossible to save data and create a file).</span></em>
-    </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="get_saxo"></a>1.1.&nbsp;
-	Get <span class="application">SAXO</span> source files from this web page
-      </h3></div></div></div><p>
-	Two tar.gz files are available:
-	</p><div class="itemizedlist"><ul type="disc"><li><a href="http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_RD_20060124.tar.gz" target="_top">SAXO_RD_20060124.tar.gz</a> (3M) contains the latest version of the source files</li><li><a href="http://www.lodyc.jussieu.fr/~smasson/SAXO/DATA/TestsData_20050601.tar.gz" target="_top">TestsData_20050601.tar.gz</a> (237M) contains only the <span class="application">NetCDF</span> files used by the test programs</li></ul></div><p>
-	Those tar.gzip files could also be downloaded with 
-	</p><div class="variablelist"><dl><dt><span class="term"><span><strong class="command">wget</strong></span></span></dt><dd><pre class="screen">
-  <code class="prompt">$</code> <strong class="userinput"><code>wget http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_RD_20060124.tar.gz</code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code>wget http://www.lodyc.jussieu.fr/~smasson/SAXO/DATA/TestsData_20050601.tar.gz</code></strong>
-	  </pre></dd><dt><span class="term"><span><strong class="command">curl</strong></span></span></dt><dd><pre class="screen">
-  <code class="prompt">$</code> <strong class="userinput"><code>curl -O http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_RD_20060124.tar.gz</code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code>curl -O http://www.lodyc.jussieu.fr/~smasson/SAXO/DATA/TestsData_20050601.tar.gz</code></strong>
-	  </pre></dd></dl></div><p>
-      </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="create_saxo_env"></a>1.2.&nbsp;
-	Create <span class="application">SAXO</span> environment
-      </h3></div></div></div><p>
-	To simplify the explanation, we suppose that <span class="application">SAXO</span> is installed in <code class="envar">$HOME</code>. 
-	We need to create 2 directories:
-	</p><div class="itemizedlist"><ul type="disc"><li>SAXO_DIR that will contain the source files of <span class="application">SAXO</span>. It should not be modified by the user to simplify later updates</li><li>MY_IDL that will contain user personal files (including modified <span class="application">SAXO</span> files, if needed).</li></ul></div><p>
-      </p><p>
-	</p><pre class="screen">
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd <code class="envar">$HOME</code></strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mkdir My_IDL</strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mkdir SAXO_DIR</strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mv SAXO_RD_*.tar.gz SAXO_DIR</strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd SAXO_DIR</strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">tar xvfz SAXO_RD_*.tar.gz</strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">rm SAXO_RD_*.tar.gz</strong></span></code></strong>
-	</pre><p>
-      </p><p>
-	If you also downloaded the data tests files (<code class="filename">TestsData_20050601.tar.gz</code>), You may install this tar.gz file in 
-	</p><div class="itemizedlist"><ul type="disc"><li>MY_IDL. This is the easiest solution but it could be unconvenient if your <code class="envar">$HOME</code> disk space is limited.</li><li>Any other Directory of your choice. In that case, when using IDL, you will need to define the variable <code class="varname">iodir</code> 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 <a href="#generate_init" title="1.3.&nbsp;&#xA;Generate your init.pro file&#xA;      "><a href="#generate_init" title="1.3.&nbsp;&#xA;Generate your init.pro file&#xA;      ">Section&nbsp;1.3, &#8220;
-	Generate your init.pro file
-      &#8221;</a></a>) or directly within IDL with the following commad: <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">iodir = "the chosen directory"</strong></span></code></strong></li></ul></div><p>
-	</p><pre class="screen">
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd <code class="envar">$HOME</code></strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mv TestsData_20050601.tar.gz "CHOSEN_DIR"</strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd "CHOSEN_DIR"</strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">tar xvfz TestsData_20050601.tar.gz</strong></span></code></strong>
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">rm TestsData_20050601.tar.gz</strong></span></code></strong>
-	</pre><p>
-      </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="generate_init"></a>1.3.&nbsp;
-	Generate your init.pro file
-      </h3></div></div></div><p>
-	To use <span class="application">SAXO</span>, we need to build an idl script that we usually call "<code class="filename">init.pro</code>". This file contains a set of IDL commands and default definitions (paths and variables of the common files) that are necessary to <span class="application">SAXO</span>. Once it has ben created, <code class="filename">init.pro</code> should the first executed command when starting IDL session.
-      </p><p>
-	</p><pre class="screen">
-  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd <code class="envar">$HOME</code>/SAXO_DIR</strong></span></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><p>
-	You must then answer several questions:
-
-	</p><div class="itemizedlist"><ul type="disc"><li>give the path of $<code class="envar">HOME</code>/My_IDL</li><li>give the path of $<code class="envar">HOME</code>/SAXO_DIR</li><li>compatibility with the old version: No (except if you want to use old programs)</li><li>give a default path for the data directory</li><li>give a default path for the postscript directory</li><li>give a default path for the images directory</li><li>give a default path for the animation directory</li><li>number of accessible printer and their configuration</li><li>default color table</li><li>default page orientation (portrait/landscape)</li><li>default page size</li><li>default window size</li><li>postscript archiving options</li><li>name of the init file (<code class="filename">init.pro</code>)</li></ul></div><p>
-	</p><pre 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><p>
-	There is an example of the kind of <a href="idlfiles/init_example.pro" target="_top"> <code class="filename">init.pro</code></a> you should get.
-      </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="first_plots"></a>2.&nbsp;
+      </a></span></dt></dl></dd></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="first_plots"></a>1.&nbsp;
       First plots...
-    </h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="start_with_init"></a>2.1.&nbsp;
+    </h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="start_with_init"></a>1.1.&nbsp;
 	Start idl session: <strong class="userinput"><code><span><strong class="command">@init</strong></span></code></strong>
       </h3></div></div></div><p>
@@ -140,7 +56,7 @@
 	As an IDL session using <span class="application">SAXO</span> must always start with <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">@init</strong></span></code></strong>, it could be convenient to define the environment variable <code class="envar">IDL_STARTUP</code> to <code class="filename"><code class="envar">$HOME</code>/My_IDL/init.pro</code>. In that way, init.pro will automatically been execuded when starting IDL. This can be done with the following command:
       </p><div class="variablelist"><dl><dt><span class="term"><span><strong class="command">csh</strong></span></span></dt><dd><pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>setenv <code class="envar">IDL_STARTUP</code> <code class="filename"><code class="envar">$HOME</code>/My_IDL/init.pro</code></code></strong></pre></dd><dt><span class="term"><span><strong class="command">ksh</strong></span></span></dt><dd><pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>export <code class="envar">IDL_STARTUP</code>=<code class="filename"><code class="envar">$HOME</code>/My_IDL/init.pro</code></code></strong></pre></dd></dl></div><p>
-      </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="basic_plots"></a>2.2.&nbsp;
+      </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="basic_plots"></a>1.2.&nbsp;
 	basic plots...
-      </h3></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="basic_splot"></a>2.2.1.&nbsp;
+      </h3></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="basic_splot"></a>1.2.1.&nbsp;
 	splot
       </h4></div></div></div><p>
@@ -235,12 +151,12 @@
   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">    , small <span class="inlinemediaobject"><img src="images/callouts/1.png" alt="1"></span> = [1, 2, 2], /noerase <span class="inlinemediaobject"><img src="images/callouts/2.png" alt="2"></span></strong></span></code></strong> <a href="figpng/basic_splot3.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a>
 	</pre><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><img src="images/callouts/1.png" alt="1" border="0"></td><td valign="top" align="left"><p>
-		the <code class="computeroutput">small</code> keyword is a 3 elements vector which define how we devide the page in in which case we should make the plot: [number of columns, number of rows, case number]. The case numbering is starting at 1, from top to bottom and left to right.
+		the <code class="computeroutput">small</code> keyword is a 3 elements vector which defines how we devide the page and in which case we should make the plot: [number of columns, number of rows, case number]. The case numbering is starting at 1, from top to bottom and left to right.
 	      </p></td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/2.png" alt="2" border="0"></td><td valign="top" align="left">
 		you must put <code class="computeroutput">/norease</code> otherwise the second plot will be done in a new window.
 	      </td></tr></table></div></div><p>
-      </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="basic_contour"></a>2.2.2.&nbsp;
+      </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="basic_contour"></a>1.2.2.&nbsp;
 	scontour
       </h4></div></div></div><p>
-	Following <span><strong class="command"><a href="#basic_splot" title="2.2.1.&nbsp;&#xA;splot&#xA;      ">splot</a></strong></span> example, we provide <span><strong class="command">scontour</strong></span> as a "super <span><strong class="command">contour</strong></span>". 
+	Following <span><strong class="command"><a href="#basic_splot" title="1.2.1.&nbsp;&#xA;splot&#xA;      ">splot</a></strong></span> example, we provide <span><strong class="command">scontour</strong></span> as a "super <span><strong class="command">contour</strong></span>". 
 	</p><pre class="screen">
   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">z = dist(n)</strong></span></code></strong>
@@ -271,9 +187,9 @@
 		</pre><p>
 	    </p></td></tr></table></div></div><p>
-	<span><strong class="command">scontour</strong></span> is compatible with the positioning method associated with the <code class="computeroutput">small</code> keyword. See for example the test file <a href="idlfiles/tst_basic.pro" target="_top"><code class="filename">tst_basic.pro</code></a>:
+	<span><strong class="command">scontour</strong></span> is compatible with the positioning method associated with the <code class="computeroutput">small</code> keyword. See for example the test file <a href="../../Tests/tst_basic.pro" target="_top"><code class="filename">tst_basic.pro</code></a>:
 	</p><pre class="screen">
   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">tst_basic</strong></span></code></strong> <a href="figpng/tst_basic.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a>
 	</pre><p>
-      </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="tvplus"></a>2.2.3.&nbsp;
+      </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="tvplus"></a>1.2.3.&nbsp;
 	  Quick look at 2D arrays: tvplus
 	</h4></div></div></div><p>
@@ -291,13 +207,13 @@
   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xhelp, 'tvplus'</strong></span></code></strong>
 	  </pre><p>
-	</p></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gridded_data"></a>3.&nbsp;
+	</p></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gridded_data"></a>2.&nbsp;
       Explore gridded data (model outputs and observations)
     </h2></div></div></div><p>
       This section briefly describes the main fonctionalities offered by SAXO to explore gridded data on regular or irregular grid.
-    </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="load_grid"></a>3.1.&nbsp;
+    </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="load_grid"></a>2.1.&nbsp;
 	Load the data grid
       </h3></div></div></div><p>
 	As we focus in this section on the gridded data, we must first load the grid informations before reading and plotting the data. Loading the grid independently of the data allow you to reload the grid only when it is strictly necessary and not every time you access the data. In <code class="envar">$HOME</code>/SAXO_DIR/Tests, we provide several examples to load a grid.
-      </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="load_fromdata"></a>3.1.1.&nbsp;
+      </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="load_fromdata"></a>2.1.1.&nbsp;
 	  Easiest solution: load data grid (regular or not) directly from the data file.
 	</h4></div></div></div><p>
@@ -319,5 +235,5 @@
   <code class="computeroutput">% Compiled module: DEFINETRI.</code>
 	  </pre><p>
-	  This <a href="idlfiles/tst_initlev.pro" target="_top"><span><strong class="command">@tst_initlev</strong></span></a> command allows us to define:
+	  This <a href="../../Tests/tst_initlev.pro" target="_top"><span><strong class="command">@tst_initlev</strong></span></a> command allows us to define:
 	  </p><div class="itemizedlist"><ul type="disc"><li>domain dimensions, stored in <code class="varname">jpi, jpj and jpk</code></li><li>points abscissa, stored in 2D array <code class="varname"></code>glamt</li><li>points ordinates, stored in 2D array <code class="varname"></code>gphit</li><li>points depths, stored in 1D array <code class="varname"></code>gdept</li><li>cells corners abscissa, storde in 2D array <code class="varname"></code>glamf</li><li>cells corners ordinates, stored in 2D array <code class="varname"></code>gphif</li><li>cells upper bondary depth, stored in 1D array <code class="varname"></code>gdepw</li><li>land-sea mask, stored in <code class="varname"></code>tmask</li><li>the cells size in the longitudinal direction, stored in 2D array <code class="varname"></code>e1t</li><li>the cells size in the latitudinal direction, stored in 2D array <code class="varname"></code>e2t</li><li>the cells size in the vertical direction, stored in 1D array <code class="varname"></code>e3t</li><li>the triangulation used to fill the land points, stored in <code class="varname"></code>triangles_list</li></ul></div><p>
 
@@ -347,14 +263,14 @@
 	  </pre><p>
 	  We provide other initialization methods/examples
-	  </p><div class="itemizedlist"><ul type="disc"><li><a href="idlfiles/tst_initorca2_short.pro" target="_top">@tst_initorca2_short</a> : ORCA2 example</li><li><a href="idlfiles/tst_initorca05_short.pro" target="_top">@tst_initorca05_short</a> : ORCA05 example</li><li><a href="idlfiles/tst_initlev_stride.pro" target="_top">@tst_initlev_stride</a> : same as @tst_initlev but we skip on point over 2 in x and y direction</li><li><a href="idlfiles/tst_initorca2_short_stride.pro" target="_top">@tst_initorca2_short_stride</a> : ORCA2 with stride</li><li><a href="idlfiles/tst_initorca05_short_stride.pro" target="_top">@tst_initorca05_short_stride</a> : ORCA05 with stride</li><li><a href="idlfiles/tst_initlev_index.pro" target="_top">@tst_initlev_index</a> : in that case we load the grid using points index as axis instead of the longitude/latitude position</li><li><a href="idlfiles/tst_initorca2_index.pro" target="_top">@tst_initorca2_index</a> : load ORCA2 as it see by the model</li><li><a href="idlfiles/tst_initorca05_index.pro" target="_top">@tst_initorca05_index</a> : load ORCA05 as it see by the model</li><li><a href="idlfiles/tst_initlev_index_stride.pro" target="_top">@tst_initlev_index_stride</a> : @tst_initlev_index with stride</li><li><a href="idlfiles/tst_initorca2_index_stride.pro" target="_top">@tst_initorca2_index_stride</a> : ORCA2 in index with stride</li><li><a href="idlfiles/tst_initorca05_index_stride.pro" target="_top">@tst_initorca05_index_stride</a> : ORCA05 in index with stride</li></ul></div><p>
-	</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="load_meshmask"></a>3.1.2.&nbsp;
+	  </p><div class="itemizedlist"><ul type="disc"><li><a href="../../Tests/tst_initorca2_short.pro" target="_top">@tst_initorca2_short</a> : ORCA2 example</li><li><a href="../../Tests/tst_initorca05_short.pro" target="_top">@tst_initorca05_short</a> : ORCA05 example</li><li><a href="../../Tests/tst_initlev_stride.pro" target="_top">@tst_initlev_stride</a> : same as @tst_initlev but we skip on point over 2 in x and y direction</li><li><a href="../../Tests/tst_initorca2_short_stride.pro" target="_top">@tst_initorca2_short_stride</a> : ORCA2 with stride</li><li><a href="../../Tests/tst_initorca05_short_stride.pro" target="_top">@tst_initorca05_short_stride</a> : ORCA05 with stride</li><li><a href="../../Tests/tst_initlev_index.pro" target="_top">@tst_initlev_index</a> : in that case we load the grid using points index as axis instead of the longitude/latitude position</li><li><a href="../../Tests/tst_initorca2_index.pro" target="_top">@tst_initorca2_index</a> : load ORCA2 as it see by the model</li><li><a href="../../Tests/tst_initorca05_index.pro" target="_top">@tst_initorca05_index</a> : load ORCA05 as it see by the model</li><li><a href="../../Tests/tst_initlev_index_stride.pro" target="_top">@tst_initlev_index_stride</a> : @tst_initlev_index with stride</li><li><a href="../../Tests/tst_initorca2_index_stride.pro" target="_top">@tst_initorca2_index_stride</a> : ORCA2 in index with stride</li><li><a href="../../Tests/tst_initorca05_index_stride.pro" target="_top">@tst_initorca05_index_stride</a> : ORCA05 in index with stride</li></ul></div><p>
+	</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="load_meshmask"></a>2.1.2.&nbsp;
 	  Load the grid from OPA <code class="filename">meshmask</code> file
 	</h4></div></div></div><p>
-	  When the grid is really irregular (its abscissa and ordinate cannot be descried by a vector), loading the grid directly from the data forces us to make an approximation when computing the grid corners position and the cells size. In that case, it can be preferable to load the grid from the meshmask file created by OPA. As OPA use a Arakawa-C discretization, loading the grid from the meshmask will also define all parameters related to the U, V and F grids (glam[uv],gphi[uv], e[12][uvf]). Note that, when using a simple <a href="#load_fromdata" title="3.1.1.&nbsp;&#xA;  Easiest solution: load data grid (regular or not) directly from the data file.&#xA;">grid definition from the data itself</a> (with <code class="filename">initncdf</code> or <code class="filename">computegrid</code>), adding the keyword /FULLCGRID leads also to the definition of all U, V and F grids parameters. There is the examples to load ORCA grids from OPA meshmask.
-	  </p><div class="itemizedlist"><ul type="disc"><li><a href="idlfiles/tst_initorca2.pro" target="_top">@tst_initorca2</a> : ORCA2</li><li><a href="idlfiles/tst_initorca05.pro" target="_top">@tst_initorca05</a> : ORCA05</li><li><a href="idlfiles/tst_initorca2_stride.pro" target="_top">@tst_initorca2_stride</a> : ORCA2 with stride</li><li><a href="idlfiles/tst_initorca05_stride.pro" target="_top">@tst_initorca05_stride</a> : ORCA05 with stride</li><li><a href="idlfiles/tst_initorca2_index.pro" target="_top">@tst_initorca2_index</a> : load ORCA2 as it see by the model</li><li><a href="idlfiles/tst_initorca05_index.pro" target="_top">@tst_initorca05_index</a> : load ORCA05 as it see by the model</li><li><a href="idlfiles/tst_initorca2_index_stride.pro" target="_top">@tst_initorca2_index_stride</a> : ORCA2 in index with stride</li><li><a href="idlfiles/tst_initorca05_index_stride.pro" target="_top">@tst_initorca05_index_stride</a> : ORCA05 in index with stride</li></ul></div><p>
-	</p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plt"></a>3.2.&nbsp;
+	  When the grid is really irregular (its abscissa and ordinate cannot be descried by a vector), loading the grid directly from the data forces us to make an approximation when computing the grid corners position and the cells size. In that case, it can be preferable to load the grid from the meshmask file created by OPA. As OPA use a Arakawa-C discretization, loading the grid from the meshmask will also define all parameters related to the U, V and F grids (glam[uv],gphi[uv], e[12][uvf]). Note that, when using a simple <a href="#load_fromdata" title="2.1.1.&nbsp;&#xA;  Easiest solution: load data grid (regular or not) directly from the data file.&#xA;">grid definition from the data itself</a> (with <code class="filename">initncdf</code> or <code class="filename">computegrid</code>), adding the keyword /FULLCGRID leads also to the definition of all U, V and F grids parameters. There is the examples to load ORCA grids from OPA meshmask.
+	  </p><div class="itemizedlist"><ul type="disc"><li><a href="../../Tests/tst_initorca2.pro" target="_top">@tst_initorca2</a> : ORCA2</li><li><a href="../../Tests/tst_initorca05.pro" target="_top">@tst_initorca05</a> : ORCA05</li><li><a href="../../Tests/tst_initorca2_stride.pro" target="_top">@tst_initorca2_stride</a> : ORCA2 with stride</li><li><a href="../../Tests/tst_initorca05_stride.pro" target="_top">@tst_initorca05_stride</a> : ORCA05 with stride</li><li><a href="../../Tests/tst_initorca2_index.pro" target="_top">@tst_initorca2_index</a> : load ORCA2 as it see by the model</li><li><a href="../../Tests/tst_initorca05_index.pro" target="_top">@tst_initorca05_index</a> : load ORCA05 as it see by the model</li><li><a href="../../Tests/tst_initorca2_index_stride.pro" target="_top">@tst_initorca2_index_stride</a> : ORCA2 in index with stride</li><li><a href="../../Tests/tst_initorca05_index_stride.pro" target="_top">@tst_initorca05_index_stride</a> : ORCA05 in index with stride</li></ul></div><p>
+	</p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plt"></a>2.2.&nbsp;
 	horizontal plots and maps
       </h3></div></div></div><p>
-	  A quick presentation of horizontal plots and maps is shown in <a href="idlfiles/tst_plt.pro" target="_top">tst_plt</a>. After laoding any of the grid (for example with one of the <a href="#load_grid" title="3.1.&nbsp;&#xA;Load the data grid&#xA;      ">above examples</a>). Just try:
+	  A quick presentation of horizontal plots and maps is shown in <a href="../../Tests/tst_plt.pro" target="_top">tst_plt</a>. After laoding any of the grid (for example with one of the <a href="#load_grid" title="2.1.&nbsp;&#xA;Load the data grid&#xA;      ">above examples</a>). Just try:
 	  </p><pre class="screen">
   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">tst_plt</strong></span></code></strong>
@@ -363,8 +279,8 @@
 	  See the results with 
 	  </p><div class="itemizedlist"><ul type="disc"><li><span><strong class="command">@tst_initlev</strong></span> <a href="figpng/tst_plt_lev_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca2</strong></span> <a href="figpng/tst_plt_orca2_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca05</strong></span> <a href="figpng/tst_plt_orca05_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initlev_stride</strong></span> <a href="figpng/tst_plt_lev_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_lev_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca2_stride</strong></span> <a href="figpng/tst_plt_orca2_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca2_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca05_stride</strong></span> <a href="figpng/tst_plt_orca05_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_plt_orca05_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li></ul></div><p>
-	</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="pltz"></a>3.3.&nbsp;
+	</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="pltz"></a>2.3.&nbsp;
 	vertical sections
       </h3></div></div></div><p>
-	  A quick presentation of vertical sections is shown in <a href="idlfiles/tst_pltz.pro" target="_top">tst_pltz</a>. After laoding any of the grid (for example with one of the <a href="#load_grid" title="3.1.&nbsp;&#xA;Load the data grid&#xA;      ">above examples</a>). Just try:
+	  A quick presentation of vertical sections is shown in <a href="../../Tests/tst_pltz.pro" target="_top">tst_pltz</a>. After laoding any of the grid (for example with one of the <a href="#load_grid" title="2.1.&nbsp;&#xA;Load the data grid&#xA;      ">above examples</a>). Just try:
 	  </p><pre class="screen">
   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">tst_pltz</strong></span></code></strong>
@@ -373,8 +289,8 @@
 	  See the results with 
 	  </p><div class="itemizedlist"><ul type="disc"><li><span><strong class="command">@tst_initlev</strong></span> <a href="figpng/tst_pltz_lev_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca2</strong></span> <a href="figpng/tst_pltz_orca2_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_12.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca05</strong></span> <a href="figpng/tst_pltz_orca05_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_12.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initlev_stride</strong></span> <a href="figpng/tst_pltz_lev_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_lev_stride_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca2_stride</strong></span> <a href="figpng/tst_pltz_orca2_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca2_stride_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca05_stride</strong></span> <a href="figpng/tst_pltz_orca05_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltz_orca05_stride_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li></ul></div><p>
-	</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="pltt"></a>3.4.&nbsp;
+	</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="pltt"></a>2.4.&nbsp;
 	hovmoellers and time series
       </h3></div></div></div><p>
-	  A quick presentation of hovmoellers and time series is shown in <a href="idlfiles/tst_pltt.pro" target="_top">tst_pltt</a>. After laoding any of the grid (for example with one of the <a href="#load_grid" title="3.1.&nbsp;&#xA;Load the data grid&#xA;      ">above examples</a>). Just try:
+	  A quick presentation of hovmoellers and time series is shown in <a href="../../Tests/tst_pltt.pro" target="_top">tst_pltt</a>. After laoding any of the grid (for example with one of the <a href="#load_grid" title="2.1.&nbsp;&#xA;Load the data grid&#xA;      ">above examples</a>). Just try:
 	  </p><pre class="screen">
   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">tst_pltt</strong></span></code></strong>
@@ -383,5 +299,5 @@
 	  See the results with 
 	  </p><div class="itemizedlist"><ul type="disc"><li><span><strong class="command">@tst_initlev</strong></span> <a href="figpng/tst_pltt_lev_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca2</strong></span> <a href="figpng/tst_pltt_orca2_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca05</strong></span> <a href="figpng/tst_pltt_orca05_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initlev_stride</strong></span> <a href="figpng/tst_pltt_lev_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_lev_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca2_stride</strong></span> <a href="figpng/tst_pltt_orca2_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca2_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li><li><span><strong class="command">@tst_initorca05_stride</strong></span> <a href="figpng/tst_pltt_orca05_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a> <a href="figpng/tst_pltt_orca05_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result"></span></a></li></ul></div><p>
-	</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plt1d"></a>3.5.&nbsp;
+	</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plt1d"></a>2.5.&nbsp;
 	1D plots
       </h3></div></div></div><p>
Index: trunk/SRC/Documentation/xmldoc/firststeps.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/firststeps.xml	(revision 77)
+++ trunk/SRC/Documentation/xmldoc/firststeps.xml	(revision 78)
@@ -55,138 +55,13 @@
 	<revremark>last japanese version!</revremark>
       </revision>
-    </revhistory>  
+      <revision>
+	<revnumber>0.2</revnumber>
+	<date>May 2006</date>
+	<revremark>split with getsaxo</revremark>
+      </revision>
+     </revhistory>  
   </articleinfo>
   
-  <sect1 id="install_saxo">
-    <title>
-      Install <application>SAXO</application>
-    </title>
-    <para>
-	<application>SAXO</application> needs at least <trademark>IDL 6.0</trademark>.
-	<remark><application>SAXO</application> can be used with the 7 minutes demo-mode (within the limitations of this mode: impossible to save data and create a file).</remark>
-    </para>
-    <sect2 id="get_saxo">
-      <title>
-	Get <application>SAXO</application> source files from this web page
-      </title>
-      <para>
-	Two tar.gz files are available:
-	<itemizedlist>
-	  <listitem><simpara><ulink url="http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_RD_&date;.tar.gz">SAXO_RD_&date;.tar.gz</ulink> (&szsrc;) contains the latest version of the source files</simpara></listitem>
-	  <listitem><simpara><ulink url="http://www.lodyc.jussieu.fr/~smasson/SAXO/DATA/TestsData_&date2;.tar.gz">TestsData_&date2;.tar.gz</ulink> (&szdata;) contains only the <application>NetCDF</application> files used by the test programs</simpara></listitem>
-	</itemizedlist>
-	Those tar.gzip files could also be downloaded with 
-	<variablelist>
-	  <varlistentry><term><command>wget</command></term>
-	  <listitem><screen>
-  <prompt>$</prompt> <userinput>wget http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_RD_&date;.tar.gz</userinput>
-  <prompt>$</prompt> <userinput>wget http://www.lodyc.jussieu.fr/~smasson/SAXO/DATA/TestsData_&date2;.tar.gz</userinput>
-	  </screen></listitem>
-	  </varlistentry>
-	  <varlistentry><term><command>curl</command></term>
-	  <listitem><screen>
-  <prompt>$</prompt> <userinput>curl -O http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_RD_&date;.tar.gz</userinput>
-  <prompt>$</prompt> <userinput>curl -O http://www.lodyc.jussieu.fr/~smasson/SAXO/DATA/TestsData_&date2;.tar.gz</userinput>
-	  </screen></listitem>
-	  </varlistentry>
-	</variablelist>
-      </para>
-    </sect2>
-    
-    <sect2 id="create_saxo_env">
-      <title>
-	Create <application>SAXO</application> environment
-      </title>
-      <para>
-	To simplify the explanation, we suppose that <application>SAXO</application> is installed in <envar>$HOME</envar>. 
-	We need to create 2 directories:
-	<itemizedlist>
-	  <listitem><simpara>SAXO_DIR that will contain the source files of <application>SAXO</application>. It should not be modified by the user to simplify later updates</simpara></listitem>
-	  <listitem><simpara>MY_IDL that will contain user personal files (including modified <application>SAXO</application> files, if needed).</simpara></listitem>
-	</itemizedlist>
-      </para>
-      <para>
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>cd <envar>$HOME</envar></command></userinput>
-  <prompt>$</prompt> <userinput><command>mkdir My_IDL</command></userinput>
-  <prompt>$</prompt> <userinput><command>mkdir SAXO_DIR</command></userinput>
-  <prompt>$</prompt> <userinput><command>mv SAXO_RD_*.tar.gz SAXO_DIR</command></userinput>
-  <prompt>$</prompt> <userinput><command>cd SAXO_DIR</command></userinput>
-  <prompt>$</prompt> <userinput><command>tar xvfz SAXO_RD_*.tar.gz</command></userinput>
-  <prompt>$</prompt> <userinput><command>rm SAXO_RD_*.tar.gz</command></userinput>
-	</screen>
-      </para>
-      <para>
-	If you also downloaded the data tests files (<filename>TestsData_&date2;.tar.gz</filename>), You may install this tar.gz file in 
-	<itemizedlist>
-	  <listitem><simpara>MY_IDL. This is the easiest solution but it could be unconvenient if your <envar>$HOME</envar> disk space is limited.</simpara></listitem>
-	  <listitem><simpara>Any other Directory of your choice. In that case, when using IDL, you will need to define the variable <varname>iodir</varname> 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 <link linkend="generate_init"><xref linkend="generate_init"/></link>) or directly within IDL with the following commad: <prompt>&promptidl;</prompt> <userinput><command>iodir = "the chosen directory"</command></userinput></simpara></listitem>
-	</itemizedlist>
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>cd <envar>$HOME</envar></command></userinput>
-  <prompt>$</prompt> <userinput><command>mv TestsData_&date2;.tar.gz "CHOSEN_DIR"</command></userinput>
-  <prompt>$</prompt> <userinput><command>cd "CHOSEN_DIR"</command></userinput>
-  <prompt>$</prompt> <userinput><command>tar xvfz TestsData_&date2;.tar.gz</command></userinput>
-  <prompt>$</prompt> <userinput><command>rm TestsData_&date2;.tar.gz</command></userinput>
-	</screen>
-      </para>
-    </sect2>
-    
-    <sect2 id="generate_init">
-      <title>
-	Generate your init.pro file
-      </title>
-      <para>
-	To use <application>SAXO</application>, we need to build an idl script that we usually call "<filename>init.pro</filename>". This file contains a set of IDL commands and default definitions (paths and variables of the common files) that are necessary to <application>SAXO</application>. Once it has ben created, <filename>init.pro</filename> should the first executed command when starting IDL session.
-      </para>
-      <para>
-	<screen format="linespecific">
-  <prompt>$</prompt> <userinput><command>cd <envar>$HOME</envar>/SAXO_DIR</command></userinput>
-  <prompt>$</prompt> <userinput><command>idl</command></userinput>
-  <computeroutput>IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</computeroutput>
-<!--
-  <computeroutput>Installation number: 35411.</computeroutput>
-  <computeroutput>Licensed for personal use by Jean-Philippe BOULANGER only.</computeroutput>
-  <computeroutput>All other use is strictly prohibited.</computeroutput>
--->
-  <prompt>&promptidl;</prompt> <userinput><command>buildinit</command></userinput>
-  <computeroutput>% Compiled module: BUILDINIT.</computeroutput>
-	</screen>
-	You must then answer several questions:
-<!--	<itemizedlist mark='opencircle'> -->
-	<itemizedlist>
-	  <listitem><simpara>give the path of $<envar>HOME</envar>/My_IDL</simpara></listitem>
-	  <listitem><simpara>give the path of $<envar>HOME</envar>/SAXO_DIR</simpara></listitem>
-	  <listitem><simpara>compatibility with the old version: No (except if you want to use old programs)</simpara></listitem>
-	  <listitem><simpara>give a default path for the data directory</simpara></listitem>
-	  <listitem><simpara>give a default path for the postscript directory</simpara></listitem>
-	  <listitem><simpara>give a default path for the images directory</simpara></listitem>
-	  <listitem><simpara>give a default path for the animation directory</simpara></listitem>
-	  <listitem><simpara>number of accessible printer and their configuration</simpara></listitem>
-	  <listitem><simpara>default color table</simpara></listitem>
-	  <listitem><simpara>default page orientation (portrait/landscape)</simpara></listitem>
-	  <listitem><simpara>default page size</simpara></listitem>
-	  <listitem><simpara>default window size</simpara></listitem>
-	  <listitem><simpara>postscript archiving options</simpara></listitem>
-	  <listitem><simpara>name of the init file (<filename>init.pro</filename>)</simpara></listitem>
-	</itemizedlist>
-	<screen format="linespecific">
-   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
-   <computeroutput>% Compiled module: XMANAGER.</computeroutput>
-   <computeroutput>% Compiled module: LOADCT.</computeroutput>
-   <computeroutput>% Compiled module: FILEPATH.</computeroutput>
-   <computeroutput>% Compiled module: PATH_SEP.</computeroutput>
-   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
-   <computeroutput>% Compiled module: STRSPLIT.</computeroutput>
-   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
-   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
-   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
-   <prompt>&promptidl;</prompt> <userinput><command>exit</command></userinput>
-	</screen>
-	There is an example of the kind of <ulink url="idlfiles/init_example.pro"> <filename>init.pro</filename></ulink> you should get.
-      </para>
-      
-    </sect2>
-  </sect1>
+
   
   <sect1 id="first_plots">
@@ -375,5 +250,5 @@
 	    <callout arearefs="small">
 	      <para>
-		the <computeroutput>small</computeroutput> keyword is a 3 elements vector which define how we devide the page in in which case we should make the plot: [number of columns, number of rows, case number]. The case numbering is starting at 1, from top to bottom and left to right.
+		the <computeroutput>small</computeroutput> keyword is a 3 elements vector which defines how we devide the page and in which case we should make the plot: [number of columns, number of rows, case number]. The case numbering is starting at 1, from top to bottom and left to right.
 	      </para>
 	    </callout>
Index: trunk/SRC/Documentation/xmldoc/getsaxo.css
===================================================================
--- trunk/SRC/Documentation/xmldoc/getsaxo.css	(revision 78)
+++ trunk/SRC/Documentation/xmldoc/getsaxo.css	(revision 78)
@@ -0,0 +1,1 @@
+.screen	        { background-color: lavender}
Index: trunk/SRC/Documentation/xmldoc/getsaxo.html
===================================================================
--- trunk/SRC/Documentation/xmldoc/getsaxo.html	(revision 78)
+++ trunk/SRC/Documentation/xmldoc/getsaxo.html	(revision 78)
@@ -0,0 +1,150 @@
+<html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>
+    Get SAXO
+  </title><link rel="stylesheet" href="getsaxo.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.69.1"><meta name="keywords" content="idl, SAXO"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="d0e1"></a>
+    Get <span class="application">SAXO</span>
+  </h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">S&eacute;bastien</span> <span class="surname">Masson</span></h3><code class="email">&lt;<a href="mailto:smasson@lodyc.jussieu.fr">smasson@lodyc.jussieu.fr</a>&gt;</code></div><div class="author"><h3 class="author"><span class="firstname">Fran&ccedil;oise</span> <span class="surname">Pinsard</span></h3><code class="email">&lt;<a href="mailto:fplod@lodyc.jussieu.fr">fplod@lodyc.jussieu.fr</a>&gt;</code></div></div></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="2"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.0</td><td align="left">May 2006</td></tr><tr><td align="left" colspan="2">First draft</td></tr></table></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#create_saxo_env">1. 
+      Create <span class="application">SAXO</span> environment
+    </a></span></dt><dt><span class="sect1"><a href="#get_saxo_files">2. 
+      Get <span class="application">SAXO</span> files
+    </a></span></dt><dd><dl><dt><span class="sect2"><a href="#saxo_local">2.1. 
+	If you work at IDRIS or LOCEAN
+      </a></span></dt><dt><span class="sect2"><a href="#saxo_svn">2.2. 
+	If <span class="application"> Subversion (svn)</span> is installed on your machine
+      </a></span></dt><dt><span class="sect2"><a href="#saxo_tar">2.3. 
+	Get <span class="application">SAXO</span> from a tar file
+      </a></span></dt></dl></dd><dt><span class="sect1"><a href="#generate_init">3. 
+	Generate your init.pro file
+      </a></span></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="create_saxo_env"></a>1.&nbsp;
+      Create <span class="application">SAXO</span> environment
+    </h2></div></div></div><p>
+      To simplify the explanation, we suppose that we install <span class="application">SAXO</span> in your <code class="filename"><code class="envar">${HOME}</code></code>. 
+      We need to create 2 directories:
+      </p><div class="itemizedlist"><ul type="disc"><li><code class="filename"><code class="envar">${HOME}</code>/SAXO_DIR</code> that will contain the source files of <span class="application">SAXO</span>. It should not be modified by the user to simplify later updates</li><li><code class="filename"><code class="envar">${HOME}</code>/My_IDL</code> that will contain user personal files (including modified <span class="application">SAXO</span> files, if needed).</li></ul></div><p>
+    </p><p>
+      </p><pre class="screen">
+  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="envar">${HOME}</code></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><p>
+    </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="get_saxo_files"></a>2.&nbsp;
+      Get <span class="application">SAXO</span> files
+    </h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="saxo_local"></a>2.1.&nbsp;
+	If you work at IDRIS or LOCEAN
+      </h3></div></div></div><p>
+	<span class="application">SAXO</span> is already installed at
+	</p><div class="itemizedlist"><ul type="disc"><li>IDRIS, on rhodes: <code class="filename">/home/rech/eee/reee217/SAXO_DIR</code></li><li>LOCEAN: <code class="filename">/usr/home/smasson/SAXO_DIR</code></li></ul></div><p>
+	If you can access one of theses directories, there is no need to re-install <span class="application">SAXO</span> again! In that case, you only have to link <code class="filename"><code class="envar">${HOME}</code>/SAXO_DIR</code> to the appropiate directory:
+	</p><div class="variablelist"><dl><dt><span class="term"><span><strong class="command">IDRIS</strong></span></span></dt><dd><pre 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><code class="envar">${HOME}</code>/SAXO_DIR</code></em></code></strong>
+	  </pre></dd><dt><span class="term"><span><strong class="command">LOCEAN</strong></span></span></dt><dd><pre 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><code class="envar">${HOME}</code>/SAXO_DIR</code></em></code></strong>
+	  </pre></dd></dl></div><p>
+      </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="saxo_svn"></a>2.2.&nbsp;
+	If <a href="http://subversion.tigris.org/" target="_top"><span class="application"> Subversion (svn)</span></a> is installed on your machine
+      </h3></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="saxo_svn_users"></a>2.2.1.&nbsp;
+	  Regular users
+	</h4></div></div></div><p>
+	The <span class="bold"><strong>complete</strong></span> latest revision (source + tests data files: ~750 Mb) can be checked out with the following command executed in your <code class="envar">${HOME}</code>:
+	</p><pre 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><p>
+      </p><p>
+	The latest revision of the <span><strong class="command">source files</strong></span> (~25 Mb) can be checked out with the following command:
+	</p><pre 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><p>
+      </p><p>
+	The latest revision of the <span><strong class="command">NetCDF data files</strong></span> (~725 Mb) used by the test programs can be checked out with the following command:
+	</p><pre 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><p>
+      </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="saxo_svn_contributors"></a>2.2.2.&nbsp;
+	  Contributors
+	</h4></div></div></div><p>
+	<span><strong class="command">Contributors</strong></span> should better use the following command :
+	</p><pre 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://<em class="replaceable"><code>login</code></em>@forge.ipsl.jussieu.fr/ipsl/forge/projets/saxo/svn/trunk/</code></em> <em class="parameter"><code>SAXO_DIR</code></em></code></strong>
+	</pre><p>
+      </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="saxo_tar"></a>2.3.&nbsp;
+	Get <span class="application">SAXO</span> from a tar file
+      </h3></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="saxo_src_tar"></a>2.3.1.&nbsp;
+	  Get <span class="application">SAXO</span> source files (... Mb)
+	</h4></div></div></div><p>
+	  Create your <code class="filename"><code class="envar">${HOME}</code>/SAXO_DIR</code> directory...
+	  </p><pre class="screen">
+  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="envar">${HOME}</code></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><p>
+	  ... and download it the latest version of the sources tar file: <a href="http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_DIR_*.tar.gz" target="_top">SAXO_DIR_*.tar.gz</a> ( Mb). This tar.gzip file could also be downloaded with 
+	</p><div class="variablelist"><dl><dt><span class="term"><span><strong class="command">wget</strong></span></span></dt><dd><pre class="screen">
+  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">wget</strong></span> <em class="parameter"><code>http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_DIR_*.tar.gz</code></em></code></strong>
+	  </pre></dd><dt><span class="term"><span><strong class="command">curl</strong></span></span></dt><dd><pre 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://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_DIR_*.tar.gz</code></em></code></strong>
+	  </pre></dd></dl></div><p>	
+	Untar the file
+	</p><pre class="screen">
+  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="envar">${HOME}</code>/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_DIR_*.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_DIR_*.tar.gz</code></em></code></strong>
+	</pre><p>
+	</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="saxo_data_tar"></a>2.3.2.&nbsp;
+	  Get <span class="application">SAXO</span> tests data files (... Mb)
+	</h4></div></div></div><p>
+	If you want to use the tests programs, you need to download the data tests files (<code class="filename">TestsData_*.tar.gz</code>), You may download theses files in 
+	</p><div class="itemizedlist"><ul type="disc"><li><code class="filename"><code class="envar">${HOME}</code>/My_IDL</code>. This is the easiest solution but it could be unconvenient if your <code class="envar">${HOME}</code> disk space is limited.</li><li>any other Directory of your choice. In that case, when using IDL, you will need to define the variable <code class="varname">iodir</code> 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 <a href="#generate_init" title="3.&nbsp;&#xA;Generate your init.pro file&#xA;      "><a href="#generate_init" title="3.&nbsp;&#xA;Generate your init.pro file&#xA;      ">Section&nbsp;3, &#8220;
+	Generate your init.pro file
+      &#8221;</a></a>) or directly within IDL with the following commad: <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">iodir = "the chosen directory"</strong></span></code></strong></li></ul></div><p>
+	</p><pre class="screen">
+  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="envar">${HOME}</code></code></em></code></strong>
+  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">mkdir</strong></span> <em class="parameter"><code>"CHOSEN_DIR"</code></em></code></strong>
+  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code>"CHOSEN_DIR"</code></em></code></strong>
+	</pre><p>
+	Download the files through thoses links...
+	</p><div class="itemizedlist"><ul type="disc"><li><a href="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_1x1.nc" target="_top">http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_1x1.nc</a> (49 Mb)</li><li><a href="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc" target="_top">http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc</a> (19 Mb)</li><li><a href="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc" target="_top">http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc</a> (264 Mb)</li><li><a href="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA2.nc" target="_top">http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA2.nc</a> (27 Mb)</li><li><a href="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA05.nc" target="_top">http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA05.nc</a> (2 Mb)</li></ul></div><p>
+	... or with 
+	</p><div class="variablelist"><dl><dt><span class="term"><span><strong class="command">wget</strong></span></span></dt><dd><pre 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/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_1x1.nc</code></em></code></strong>
+  <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/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc</code></em></code></strong>
+  <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/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc</code></em></code></strong>
+  <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/svn/trunk/DATA/micromeshmaskORCA2.nc</code></em></code></strong>
+  <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/svn/trunk/DATA/micromeshmaskORCA05.nc</code></em></code></strong>
+	  </pre></dd><dt><span class="term"><span><strong class="command">curl</strong></span></span></dt><dd><pre 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/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_1x1.nc</code></em></code></strong>
+  <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/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc</code></em></code></strong>
+  <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/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc</code></em></code></strong>
+  <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/svn/trunk/DATA/micromeshmaskORCA2.nc</code></em></code></strong>
+  <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/svn/trunk/DATA/micromeshmaskORCA05.nc</code></em></code></strong>
+	  </pre></dd></dl></div><p>
+	</p></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="generate_init"></a>3.&nbsp;
+	Generate your init.pro file
+      </h2></div></div></div><p>
+	To use <span class="application">SAXO</span>, we need to build an idl script that we usually call "<code class="filename">init.pro</code>". This file contains a set of IDL commands and default definitions (paths and variables of the common files) that are necessary to <span class="application">SAXO</span>. Once it has ben created, <code class="filename">init.pro</code> should the first executed command when starting IDL session.
+      </p><p>
+	</p><pre class="screen">
+  <code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd <code class="envar">${HOME}</code>/SAXO_DIR</strong></span></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><p>
+	You must then answer several questions:
+
+	</p><div class="itemizedlist"><ul type="disc"><li>give the path of <code class="filename"><code class="envar">${HOME}</code>/My_IDL</code></li><li>give the path of <code class="filename"><code class="envar">${HOME}</code>/SAXO_DIR</code></li><li>compatibility with the old version: No (except if you want to use old programs)</li><li>give a default path for the data directory</li><li>give a default path for the postscript directory</li><li>give a default path for the images directory</li><li>give a default path for the animation directory</li><li>number of accessible printer and their configuration</li><li>default color table</li><li>default page orientation (portrait/landscape)</li><li>default page size</li><li>default window size</li><li>postscript archiving options</li><li>name of the init file (<code class="filename">init.pro</code>)</li></ul></div><p>
+	</p><pre 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><p>
+	There is an example of the kind of <a href="idlfiles/init_example.pro" target="_top"> <code class="filename">init.pro</code></a> you should get.
+      </p></div></div></body></html>
Index: trunk/SRC/Documentation/xmldoc/getsaxo.xml
===================================================================
--- trunk/SRC/Documentation/xmldoc/getsaxo.xml	(revision 78)
+++ trunk/SRC/Documentation/xmldoc/getsaxo.xml	(revision 78)
@@ -0,0 +1,286 @@
+<?xml version='1.0' encoding='iso-8859-1'?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+[
+<!ENTITY promptidl "idl&gt;">
+<!ENTITY numb1 '<inlinemediaobject><imageobject><imagedata fileref="images/callouts/1.png" format="PNG"/></imageobject><textobject><phrase>1</phrase></textobject></inlinemediaobject>'>
+<!ENTITY numb2 '<inlinemediaobject><imageobject><imagedata fileref="images/callouts/2.png" format="PNG"/></imageobject><textobject><phrase>2</phrase></textobject></inlinemediaobject>'>
+<!ENTITY showfig '<inlinemediaobject><imageobject><imagedata fileref="images/showfig.png" format="PNG"/></imageobject><textobject><phrase>show result</phrase></textobject></inlinemediaobject>'>
+]>
+
+
+<article lang="en">
+  <title>
+    Get <application>SAXO</application>
+  </title>
+  
+  <articleinfo>
+    <authorgroup>
+      <author><firstname>Sébastien</firstname><surname>Masson</surname><email>smasson@lodyc.jussieu.fr</email></author>
+      <author><firstname>Françoise</firstname><surname>Pinsard</surname><email>fplod@lodyc.jussieu.fr</email></author>
+    </authorgroup>
+    <keywordset>
+      <keyword>idl</keyword>
+      <keyword>SAXO</keyword>
+    </keywordset>
+    <revhistory>
+      <revision>
+	<revnumber>0.0</revnumber>
+	<date>May 2006</date>
+	<revremark>First draft</revremark>
+      </revision>
+    </revhistory>  
+  </articleinfo>
+
+  <!--	1st part -->
+
+  <sect1 id="create_saxo_env">
+    <title>
+      Create <application>SAXO</application> environment
+    </title>
+    <para>
+      To simplify the explanation, we suppose that we install <application>SAXO</application> in your <filename class='directory'><envar>${HOME}</envar></filename>. 
+      We need to create 2 directories:
+      <itemizedlist>
+	<listitem><simpara><filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> that will contain the source files of <application>SAXO</application>. It should not be modified by the user to simplify later updates</simpara></listitem>
+	<listitem><simpara><filename class='directory'><envar>${HOME}</envar>/My_IDL</filename> that will contain user personal files (including modified <application>SAXO</application> files, if needed).</simpara></listitem>
+      </itemizedlist>
+    </para>
+    <para>
+      <screen format="linespecific">
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar></parameter></userinput>
+  <prompt>$</prompt> <userinput><command>mkdir</command> <parameter>My_IDL</parameter></userinput>
+      </screen>
+    </para>
+  </sect1>
+
+  <!--	2nd part -->
+
+ <sect1 id="get_saxo_files">
+    <title>
+      Get <application>SAXO</application> files
+    </title>
+
+  <!--	2.1 -->
+
+    <sect2 id="saxo_local">
+      <title>
+	If you work at IDRIS or LOCEAN
+      </title>
+      <para>
+	<application>SAXO</application> is already installed at
+	<itemizedlist>
+	  <listitem><simpara>IDRIS, on rhodes: <filename class='directory'>/home/rech/eee/reee217/SAXO_DIR</filename></simpara></listitem>
+	  <listitem><simpara>LOCEAN: <filename class='directory'>/usr/home/smasson/SAXO_DIR</filename></simpara></listitem>
+	</itemizedlist>
+	If you can access one of theses directories, there is no need to re-install <application>SAXO</application> again! In that case, you only have to link <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> to the appropiate directory:
+	<variablelist>
+	  <varlistentry><term><command>IDRIS</command></term>
+	  <listitem><screen>
+  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/home/rech/eee/reee217/SAXO_DIR</parameter> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput>
+	  </screen></listitem>
+	  </varlistentry>
+	  <varlistentry><term><command>LOCEAN</command></term>
+	  <listitem><screen>
+  <prompt>$</prompt> <userinput><command>ln</command> <option>-s</option> <parameter>/usr/home/smasson/SAXO_DIR</parameter> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput>
+	  </screen></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+
+  <!--	2.2 -->
+
+    <sect2 id="saxo_svn">
+      <title>
+	If <ulink url="http://subversion.tigris.org/"><application> Subversion (svn)</application></ulink> is installed on your machine
+      </title>
+ <!--	2.2.1 -->
+      <sect3 id="saxo_svn_users">
+	<title>
+	  Regular users
+	</title>
+      <para>
+	The <emphasis role="bold">complete</emphasis> latest revision (source + tests data files: ~750 Mb) can be checked out with the following command executed in your <envar>${HOME}</envar>:
+	<screen format="linespecific">
+  <prompt>$</prompt> <userinput><command>svn</command> <option>checkout</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/</parameter> <parameter>SAXO_DIR</parameter></userinput>
+	</screen>
+      </para>
+      <para>
+	The latest revision of the <command>source files</command> (~25 Mb) can be checked out with the following command:
+	<screen format="linespecific">
+  <prompt>$</prompt> <userinput><command>svn</command> <option>checkout</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/SRC</parameter> <parameter>SAXO_DIR/SRC</parameter></userinput>
+	</screen>
+      </para>
+      <para>
+	The latest revision of the <command>NetCDF data files</command> (~725 Mb) used by the test programs can be checked out with the following command:
+	<screen format="linespecific">
+  <prompt>$</prompt> <userinput><command>svn</command> <option>checkout</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA</parameter> <parameter>SAXO_DIR/DATA</parameter></userinput>
+	</screen>
+      </para>
+      </sect3>
+<!--	2.2.2 -->
+      <sect3 id="saxo_svn_contributors">
+	<title>
+	  Contributors
+	</title>
+      <para>
+	<command>Contributors</command> should better use the following command :
+	<screen  format="linespecific">
+  <prompt>$</prompt> <userinput><command>svn</command> <option>checkout</option> <parameter>svn+ssh://<replaceable>login</replaceable>@forge.ipsl.jussieu.fr/ipsl/forge/projets/saxo/svn/trunk/</parameter> <parameter>SAXO_DIR</parameter></userinput>
+	</screen>
+      </para>
+      </sect3>
+    </sect2>
+
+  <!--	2.3 -->
+
+    <sect2 id="saxo_tar">
+      <title>
+	Get <application>SAXO</application> from a tar file
+      </title>
+  <!--	2.3.1 -->
+      <sect3 id="saxo_src_tar">
+	<title>
+	  Get <application>SAXO</application> source files (... Mb)
+	</title>
+	<para>
+	  Create your <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename> directory...
+	  <screen format="linespecific">
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar></parameter></userinput>
+  <prompt>$</prompt> <userinput><command>mkdir</command> <parameter>SAXO_DIR</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter>SAXO_DIR</parameter></userinput>
+	  </screen>
+	  ... and download it the latest version of the sources tar file: <ulink url="http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_DIR_&date;.tar.gz">SAXO_DIR_&date;.tar.gz</ulink> (&szsrc; Mb). This tar.gzip file could also be downloaded with 
+	<variablelist>
+	  <varlistentry><term><command>wget</command></term>
+	  <listitem><screen>
+  <prompt>$</prompt> <userinput><command>wget</command> <parameter>http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_DIR_&date;.tar.gz</parameter></userinput>
+	  </screen></listitem>
+	  </varlistentry>
+	  <varlistentry><term><command>curl</command></term>
+	  <listitem><screen>
+  <prompt>$</prompt> <userinput><command>curl</command> <option>-O</option> <parameter>http://www.lodyc.jussieu.fr/~smasson/SAXO/SRC/SAXO_DIR_&date;.tar.gz</parameter></userinput>
+	  </screen></listitem>
+	  </varlistentry>
+	</variablelist>	
+	Untar the file
+	<screen format="linespecific">
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar>/SAXO_DIR</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>tar</command> <option>xvfz</option> <parameter>SAXO_DIR_*.tar.gz</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>rm</command> <parameter>SAXO_DIR_*.tar.gz</parameter></userinput>
+	</screen>
+	</para>
+
+      </sect3>
+  <!--	2.3.2 -->
+      <sect3 id="saxo_data_tar">
+	<title>
+	  Get <application>SAXO</application> tests data files (... Mb)
+	</title>
+	<para>
+	If you want to use the tests programs, you need to download the data tests files (<filename>TestsData_&date2;.tar.gz</filename>), You may download theses files in 
+	<itemizedlist>
+	  <listitem><simpara><filename class='directory'><envar>${HOME}</envar>/My_IDL</filename>. This is the easiest solution but it could be unconvenient if your <envar>${HOME}</envar> disk space is limited.</simpara></listitem>
+	  <listitem><simpara>any other Directory of your choice. In that case, when using IDL, you will need to define the variable <varname>iodir</varname> 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 <link linkend="generate_init"><xref linkend="generate_init"/></link>) or directly within IDL with the following commad: <prompt>&promptidl;</prompt> <userinput><command>iodir = "the chosen directory"</command></userinput></simpara></listitem>
+	</itemizedlist>
+	<screen format="linespecific">
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter><envar>${HOME}</envar></parameter></userinput>
+  <prompt>$</prompt> <userinput><command>mkdir</command> <parameter>"CHOSEN_DIR"</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>cd</command> <parameter>"CHOSEN_DIR"</parameter></userinput>
+	</screen>
+	Download the files through thoses links...
+	<itemizedlist>
+	  <listitem><simpara><ulink url="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_1x1.nc"></ulink> (49 Mb)</simpara></listitem>
+	  <listitem><simpara><ulink url="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc"></ulink> (19 Mb)</simpara></listitem>
+	  <listitem><simpara><ulink url="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc"></ulink> (264 Mb)</simpara></listitem>
+	  <listitem><simpara><ulink url="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA2.nc"></ulink> (27 Mb)</simpara></listitem>
+	  <listitem><simpara><ulink url="http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA05.nc"></ulink> (2 Mb)</simpara></listitem>
+	</itemizedlist>
+	... or with 
+	<variablelist>
+	  <varlistentry><term><command>wget</command></term>
+	  <listitem><screen>
+  <prompt>$</prompt> <userinput><command>wget</command> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_1x1.nc</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>wget</command> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>wget</command> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>wget</command> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA2.nc</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>wget</command> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA05.nc</parameter></userinput>
+	  </screen></listitem>
+	  </varlistentry>
+	  <varlistentry><term><command>curl</command></term>
+	  <listitem><screen>
+  <prompt>$</prompt> <userinput><command>curl</command> <option>-O</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_1x1.nc</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>curl</command> <option>-O</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>curl</command> <option>-O</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>curl</command> <option>-O</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA2.nc</parameter></userinput>
+  <prompt>$</prompt> <userinput><command>curl</command> <option>-O</option> <parameter>http://forge.ipsl.jussieu.fr/saxo/svn/trunk/DATA/micromeshmaskORCA05.nc</parameter></userinput>
+	  </screen></listitem>
+	  </varlistentry>
+	</variablelist>
+	</para>
+      </sect3>
+    </sect2>
+  </sect1>
+  <!--	3 -->
+    <sect1 id="generate_init">
+      <title>
+	Generate your init.pro file
+      </title>
+      <para>
+	To use <application>SAXO</application>, we need to build an idl script that we usually call "<filename>init.pro</filename>". This file contains a set of IDL commands and default definitions (paths and variables of the common files) that are necessary to <application>SAXO</application>. Once it has ben created, <filename>init.pro</filename> should the first executed command when starting IDL session.
+      </para>
+      <para>
+	<screen format="linespecific">
+  <prompt>$</prompt> <userinput><command>cd <envar>${HOME}</envar>/SAXO_DIR</command></userinput>
+  <prompt>$</prompt> <userinput><command>idl</command></userinput>
+  <computeroutput>IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</computeroutput>
+<!--
+  <computeroutput>Installation number: 35411.</computeroutput>
+  <computeroutput>Licensed for personal use by Jean-Philippe BOULANGER only.</computeroutput>
+  <computeroutput>All other use is strictly prohibited.</computeroutput>
+-->
+  <prompt>&promptidl;</prompt> <userinput><command>buildinit</command></userinput>
+  <computeroutput>% Compiled module: BUILDINIT.</computeroutput>
+	</screen>
+	You must then answer several questions:
+<!--	<itemizedlist mark='opencircle'> -->
+	<itemizedlist>
+	  <listitem><simpara>give the path of <filename class='directory'><envar>${HOME}</envar>/My_IDL</filename></simpara></listitem>
+	  <listitem><simpara>give the path of <filename class='directory'><envar>${HOME}</envar>/SAXO_DIR</filename></simpara></listitem>
+	  <listitem><simpara>compatibility with the old version: No (except if you want to use old programs)</simpara></listitem>
+	  <listitem><simpara>give a default path for the data directory</simpara></listitem>
+	  <listitem><simpara>give a default path for the postscript directory</simpara></listitem>
+	  <listitem><simpara>give a default path for the images directory</simpara></listitem>
+	  <listitem><simpara>give a default path for the animation directory</simpara></listitem>
+	  <listitem><simpara>number of accessible printer and their configuration</simpara></listitem>
+	  <listitem><simpara>default color table</simpara></listitem>
+	  <listitem><simpara>default page orientation (portrait/landscape)</simpara></listitem>
+	  <listitem><simpara>default page size</simpara></listitem>
+	  <listitem><simpara>default window size</simpara></listitem>
+	  <listitem><simpara>postscript archiving options</simpara></listitem>
+	  <listitem><simpara>name of the init file (<filename>init.pro</filename>)</simpara></listitem>
+	</itemizedlist>
+	<screen format="linespecific">
+   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
+   <computeroutput>% Compiled module: XMANAGER.</computeroutput>
+   <computeroutput>% Compiled module: LOADCT.</computeroutput>
+   <computeroutput>% Compiled module: FILEPATH.</computeroutput>
+   <computeroutput>% Compiled module: PATH_SEP.</computeroutput>
+   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
+   <computeroutput>% Compiled module: STRSPLIT.</computeroutput>
+   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
+   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
+   <computeroutput>% Compiled module: CW_FIELD.</computeroutput>
+   <prompt>&promptidl;</prompt> <userinput><command>exit</command></userinput>
+	</screen>
+	There is an example of the kind of <ulink url="idlfiles/init_example.pro"> <filename>init.pro</filename></ulink> you should get.
+      </para>
+      
+    </sect1>
+
+
+
+
+  
+</article>
Index: trunk/SRC/Documentation/xmldoc/idlfiles/init_example.pro
===================================================================
--- trunk/SRC/Documentation/xmldoc/idlfiles/init_example.pro	(revision 77)
+++ trunk/SRC/Documentation/xmldoc/idlfiles/init_example.pro	(revision 78)
@@ -58,48 +58,4 @@
 ;========================================================
 ;
-; default definitions of many other common parameters...
-jpiglo = 1L
-jpjglo = 1L
-jpkglo = 1L
-jpidta = jpiglo
-jpjdta = jpjglo
-jpkdta = jpjglo
-jpi = 1L
-jpj = 1L
-jpk = 1L
-jpt = 1L
-time = 0L
-ixminmesh = -1L
-ixmaxmesh = -1L
-iyminmesh = -1L
-iymaxmesh = -1L
-izminmesh = -1L
-izmaxmesh = -1L
-ixmindta = 0L
-ixmaxdta = jpidta-1
-iymindta = 0L
-iymaxdta = jpjdta-1
-izmindta = 0L
-izmaxdta = jpkdta-1
-key_gridtype = 'C'
-key_partialstep = 0L
-key_onearth = 1L
-key_shift = 0L
-key_periodic = 0L
-key_yreverse = 0L
-key_zreverse = 0L
-key_stride = [1, 1, 1]
-lon1 = 0
-lon2 = 1
-lat1 = 0
-lat2 = 1
-vert1 = 0
-vert2 = 1
-valmask = 1.e20
-vargrid = 'T'
-varname = ''
-varexp = ''
-varunit = ''
-vardate= '0'
 @updateold
 ;
Index: trunk/SRC/Documentation/xmldoc/makehtml.sh
===================================================================
--- trunk/SRC/Documentation/xmldoc/makehtml.sh	(revision 77)
+++ trunk/SRC/Documentation/xmldoc/makehtml.sh	(revision 78)
@@ -10,5 +10,5 @@
 ndate2=${ndate2%.tar.gz}
 # figures lists
-cd ~/SAXO_RD/Documentation/xmldoc/figpng
+cd ~/SAXO_RD/SRC/Documentation/xmldoc/figpng
 
 #
@@ -110,6 +110,6 @@
 done
 ##
-cd ~/SAXO_RD/Documentation/xmldoc
-szsrc=$( ls -lh ~/SAXO_RD/SAXO_RD_${ndate}.tar.gz | awk '{print $5}' )
+cd ~/SAXO_RD/SRC/Documentation/xmldoc
+szsrc=$( ls -lh ~/SAXO_RD/SRC/SAXO_RD_${ndate}.tar.gz | awk '{print $5}' )
 szdata=$( ls -lh ~/IDL/TestsData_${ndate2}.tar.gz | awk '{print $5}' )
 sed -e s/"\&date\;"/${ndate}/g \
