Index: trunk/SRC/Documentation/xmldoc/mini_notice.html
===================================================================
--- trunk/SRC/Documentation/xmldoc/mini_notice.html	(revision 163)
+++ trunk/SRC/Documentation/xmldoc/mini_notice.html	(revision 177)
@@ -3,5 +3,5 @@
 <head>
 <meta name="generator" content=
-"HTML Tidy for Mac OS X (vers 1st December 2004), see www.w3.org">
+"HTML Tidy for Mac OS X (vers 1 September 2005), see www.w3.org">
 <meta http-equiv="Content-Type" content=
 "text/html; charset=us-ascii">
@@ -26,6 +26,5 @@
 <h3 class="author"><span class="firstname">S&eacute;bastien</span>
 <span class="surname">Masson</span> <code class=
-"email">&lt;<a href="mailto:Sebastien.Masson_at_locean-ipsl.upmc.fr">
-Sebastien.Masson_at_locean-ipsl.upmc.fr</a>&gt;</code></h3>
+"email">&lt;<a href="mailto:Sebastien.Masson_at_locean-ipsl.upmc.fr">Sebastien.Masson_at_locean-ipsl.upmc.fr</a>&gt;</code></h3>
 </div>
 <div class="author">
@@ -46,5 +45,5 @@
 </div>
 <div><span class="pubdate">svn Id of xml source file : $Id:
-mini_notice.xml 157 2006-08-21 09:01:50Z navarro $<br>
+mini_notice.xml 176 2006-09-13 14:17:41Z smasson $<br>
 <br></span></div>
 <div>
@@ -77,4 +76,18 @@
 <td align="left" colspan="2">HTML to XML/Docbook migration by
 Fran&ccedil;oise Pinsard</td>
+</tr>
+<tr>
+<td align="left">Revision 1.0</td>
+<td align="left">August, 2006</td>
+</tr>
+<tr>
+<td align="left" colspan="2">Major update by Steve Navarro</td>
+</tr>
+<tr>
+<td align="left">Revision 1.1</td>
+<td align="left">September, 2006</td>
+</tr>
+<tr>
+<td align="left" colspan="2">Review by S&eacute;bastien Masson</td>
 </tr>
 </table>
@@ -86,26 +99,98 @@
 <p><b>Table of Contents</b></p>
 <dl>
-<dt><span class="sect1"><a href="#introxxx">1. XXX widget
-functions</a></span></dt>
+<dt><span class="sect1"><a href="#launchxxx">1. Launching
+XXX</a></span></dt>
 <dd>
 <dl>
-<dt><span class="sect2"><a href="#launchxxx">1.1. Launching
-XXX</a></span></dt>
-<dt><span class="sect2"><a href="#wigdets">1.2. Description of XXX
-window</a></span></dt>
+<dt><span class="sect2"><a href="#launch_xxx_1">1.1. <code class=
+"prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span></code></strong></a></span></dt>
+<dt><span class="sect2"><a href="#launch_xxx_2">1.2. <code class=
+"prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>/separate</code></em></code></strong></a></span></dt>
+<dt><span class="sect2"><a href="#launch_xxx_3">1.3. <code class=
+"prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class="parameter"><code>restore
+= 'file.dat'</code></em></code></strong></a></span></dt>
+<dt><span class="sect2"><a href="#launch_xxx_4">1.4. <code class=
+"prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em></code></strong></a></span></dt>
+<dt><span class="sect2"><a href="#launch_xxx_5">1.5. <code class=
+"prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>keywd1 = ...</code></em>, <em class=
+"parameter"><code>keywd2 =
+...</code></em></code></strong></a></span></dt>
+<dt><span class="sect2"><a href="#launch_xxx_6">1.6. <code class=
+"prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>'initgrid'</code></em></code></strong></a></span></dt>
+<dt><span class="sect2"><a href="#launch_xxx_7">1.7. <code class=
+"prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>'initgrid'</code></em>, <em class=
+"parameter"><code>keywd1 = ...</code></em>, <em class=
+"parameter"><code>keywd2 =
+...</code></em></code></strong></a></span></dt>
+<dt><span class="sect2"><a href="#launch_xxx_8">1.8. <code class=
+"prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>'initgrid'</code></em>, <em class=
+"parameter"><code>'arg1, arg2,
+...'</code></em></code></strong></a></span></dt>
 </dl>
 </dd>
-<dt><span class="sect1"><a href="#mouseactions">2. Mouse
+<dt><span class="sect1"><a href="#wigdets">2. Description of XXX
+window</a></span></dt>
+<dd>
+<dl>
+<dt><span class="sect2"><a href="#plottypetxt">2.1. Plot type
+list</a></span></dt>
+<dt><span class="sect2"><a href="#menutxt">2.2. The menu bar made
+up of 3 submenus</a></span></dt>
+<dt><span class="sect2"><a href="#oktxt">2.3. OK
+button</a></span></dt>
+<dt><span class="sect2"><a href="#pagelayouttxt">2.4. Page
+Layout</a></span></dt>
+<dt><span class="sect2"><a href="#variableslisttxt">2.5.
+<span class="guimenuitem">List of variables</span></a></span></dt>
+<dt><span class="sect2"><a href="#fileslisttxt">2.6. <span class=
+"guimenuitem">List of open files</span></a></span></dt>
+<dt><span class="sect2"><a href="#commandtexttxt">2.7. <span class=
+"guimenuitem">Command text</span></a></span></dt>
+<dt><span class="sect2"><a href="#calendartxt">2.8.
+Calendar</a></span></dt>
+<dt><span class="sect2"><a href="#domdeftxt">2.9. Define the
+domain</a></span></dt>
+<dt><span class="sect2"><a href="#specificationstxt">2.10. specify
+your plot</a></span></dt>
+</dl>
+</dd>
+<dt><span class="sect1"><a href="#mouseactions">3. Mouse
 Actions</a></span></dt>
 <dd>
 <dl>
-<dt><span class="sect2"><a href="#mouse">2.1. In the graphics
+<dt><span class="sect2"><a href="#mouse">3.1. In the graphics
 window on a horizontal plot</a></span></dt>
-<dt><span class="sect2"><a href="#multipleplots">2.2. Create
+<dt><span class="sect2"><a href="#multipleplots">3.2. Create
 multiple plots on the same sheet and make them
 interact</a></span></dt>
 </dl>
 </dd>
-<dt><span class="sect1"><a href="#crash">3. What should I do when
+<dt><span class="sect1"><a href="#crash">4. What should I do when
 it breakdown</a></span></dt>
 </dl>
@@ -115,36 +200,71 @@
 <div>
 <div>
-<h2 class="title" style="clear: both"><a name="introxxx" id=
-"introxxx"></a>1.&nbsp;XXX widget functions</h2>
-</div>
-</div>
-</div>
-<div class="sect2" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h3 class="title"><a name="launchxxx" id=
-"launchxxx"></a>1.1.&nbsp;Launching XXX</h3>
-</div>
-</div>
-</div>
-<p>The first command to type is</p>
-<pre class="screen">
-<code class="prompt">idl&gt;</code> <strong class=
-"userinput"><code>@init</code></strong>
+<h2 class="title" style="clear: both"><a name="launchxxx" id=
+"launchxxx"></a>1.&nbsp;Launching XXX</h2>
+</div>
+</div>
+</div>
+<p>There is several ways to launch XXX which we will detail in the
+next sections:</p>
+<pre class="screen">
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span></code></strong>
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>/separate</code></em></code></strong>
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>restore = 'file.dat'</code></em></code></strong>
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em></code></strong>
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>keywd1 = ...</code></em>, <em class=
+"parameter"><code>keywd2 = ...</code></em></code></strong>
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>'initgrid'</code></em></code></strong>
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>'initgrid'</code></em>, <em class=
+"parameter"><code>keywd1 = ...</code></em>, <em class=
+"parameter"><code>keywd2 = ...</code></em></code></strong>
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>'initgrid'</code></em>, <em class=
+"parameter"><code>'arg1, arg2, ...'</code></em></code></strong>
+  
 </pre>
-<p>Afterwards, to work directly with XXX, type:</p>
-<pre class="screen">
-
-<code class="prompt">idl&gt;</code> <strong class=
-"userinput"><code>xxx</code></strong>
-</pre>
-A window will open with 2 lines to complete.
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="launch_xxx_1" id=
+"launch_xxx_1"></a>1.1.&nbsp;<code class="prompt">idl&gt;</code>
+<strong class="userinput"><code><span><strong class=
+"command">xxx</strong></span></code></strong></h3>
+</div>
+</div>
+</div>
+<p>A window will open with 3 parts to consider.</p>
 <div class="figure"><a name="fig_xxx_0101" id="fig_xxx_0101"></a>
-<p class="title"><b>Figure 1. Window xxx 1</b></p>
+<p class="title"><b>Figure&nbsp;1.&nbsp;Window xxx 1</b></p>
 <div class="figure-contents">
-<div class="mediaobjectco"><img border="0" usemap="d0e102" src=
+<div class="mediaobjectco"><img border="0" usemap="d0e204" src=
 "figpng/xxx_0101.png?format=raw" alt="Window xxx 1"><map name=
-"d0e102" id="d0e102">
+"d0e204" id="d0e204">
 <area shape="rect" coords="26,256,485,214">
 <area shape="rect" coords="78,208,433,157">
@@ -156,5 +276,5 @@
 "images/callouts/1.png?format=raw" alt="1" border="0"></td>
 <td valign="top" align="left">
-<p>Data file</p>
+<p>Data file name</p>
 </td>
 </tr>
@@ -163,5 +283,5 @@
 "images/callouts/2.png?format=raw" alt="2" border="0"></td>
 <td valign="top" align="left">
-<p>Init method</p>
+<p>Grid initialization method</p>
 </td>
 </tr>
@@ -170,5 +290,5 @@
 "images/callouts/3.png?format=raw" alt="3" border="0"></td>
 <td valign="top" align="left">
-<p>Init program</p>
+<p>Grid initialization parameters</p>
 </td>
 </tr>
@@ -178,15 +298,15 @@
 </div>
 </div>
-<br class="figure-break">
+<p><br class="figure-break"></p>
 <div class="sect3" lang="en">
 <div class="titlepage">
 <div>
 <div>
-<h4 class="title"><a name="datafiletxt" id="datafiletxt"></a>1.1.1.
-File name</h4>
-</div>
-</div>
-</div>
-<p>the name of the data file. The name can be typed directly in the
+<h4 class="title"><a name="datafiletxt" id=
+"datafiletxt"></a>1.1.1.&nbsp;Data file name</h4>
+</div>
+</div>
+</div>
+<p>The name of the data file. It can be typed directly in the
 window provided, or selected with the help of the <span class=
 "guibutton">browse</span> button.</p>
@@ -197,12 +317,21 @@
 <div>
 <h4 class="title"><a name="initmethodtxt" id=
-"initmethodtxt"></a>1.1.2. Grid initalization method</h4>
-</div>
-</div>
-</div>
-<p>By default, "automatic grid construction with initncdf.pro" is
-checked.</p>
-<p>But you can choose an other grid by checking "grid construction
-with other IDL batch or procedure"</p>
+"initmethodtxt"></a>1.1.2.&nbsp;Grid initialization method</h4>
+</div>
+</div>
+</div>
+<p>For visualising grilled data, you need to <a href=
+"firststeps.html?format=raw#load_grid" target="_top">define the
+grid</a> on which are located the data. By default, "automatic grid
+construction with initncdf.pro" is checked. This means that the
+grid will be defined by using the informations contained in the
+data file (through the IDL prodecure <span><strong class=
+"command">initncdf</strong></span>) without needing any other
+auxillary file. If you checked "grid construction with other IDL
+batch or procedure", this means that you don't want to use the
+default <span><strong class="command">initncdf</strong></span>
+procedure to define the grid and you will provide your own IDL
+procedure or the so-called IDL batch file (a file which is called
+by using @, see IDL documentation).</p>
 </div>
 <div class="sect3" lang="en">
@@ -211,54 +340,218 @@
 <div>
 <h4 class="title"><a name="initprogramtxt" id=
-"initprogramtxt"></a>1.1.3. Grid initalization parameters</h4>
-</div>
-</div>
-</div>
+"initprogramtxt"></a>1.1.3.&nbsp;Grid initialization
+parameters</h4>
+</div>
+</div>
+</div>
+<p>This third part allows you to specify the name, the argument and
+the keywords of the routine you want to use to initialize the grid.
+By default the name of the procedure is <span><strong class=
+"command">initncdf</strong></span>, its argument will be
+automatically defined so you cannot change them. If you If you
+checked "grid construction with other IDL batch or procedure", you
+have to select the name of the IDL procedure or batch file and its
+suitable arguments and keywords. Note that if you select an IDL
+batch file you cannot give any parameter or keyword.</p>
 <div class="figure"><a name="fig_xxx_0102" id="fig_xxx_0102"></a>
-<p class="title"><b>Figure 2. Window xxx 1</b></p>
+<p class="title"><b>Figure&nbsp;2.&nbsp;Window xxx 1</b></p>
 <div class="figure-contents">
-<div class="mediaobjectco"><img border="0" usemap="d0e145" src=
+<div class="mediaobjectco"><img border="0" usemap="d0e258" src=
 "figpng/xxx_0102.png?format=raw" alt="Window xxx 1"><map name=
-"d0e145" id="d0e145"></map></div>
-</div>
-</div>
-<p><br class="figure-break"></p>
-<p>the second the name of the <code class=
-"filename">initgrid.pro</code> script which will permit the reading
-and processing of the grid associated with the data file.</p>
+"d0e258" id="d0e258"></map></div>
+</div>
+</div>
+<p><br class="figure-break"></p>
 <p>Once these two lines have been completed, click on <span class=
 "guibutton">let's go</span>.</p>
-<p>For example, we choose the mask "tst_initlev". Compare the
-result with "automatic grid construction with initncdf.pro"
+<p>For example, we choose the IDL batch file "tst_initlev". Compare
+the result with "automatic grid construction with initncdf.pro"
 checked. Cf <a href="#fig_xxx_0404" title=
-"Figure&nbsp;23.&nbsp;Oceania at 125 metters of depth without a mask">
-Figure 23, &ldquo;Oceania at 125 metters of depth without a
-mask&rdquo;</a></p>
+"Figure&nbsp;18.&nbsp;temperature of the ocean at depth 125 meters without proper land/sea mask">
+Figure&nbsp;18, &ldquo;temperature of the ocean at depth 125 meters
+without proper land/sea mask&rdquo;</a></p>
 <div class="figure"><a name="fig_xxx_0103" id="fig_xxx_0103"></a>
-<p class="title"><b>Figure 3. Oceania at 125 metters of depth with
-a mask</b></p>
+<p class="title"><b>Figure&nbsp;3.&nbsp;Oceania at 125 metters of
+depth with proper grid initialization</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0103.png?format=raw" alt=
-"Oceania at 125 metters of depth with a mask"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
-</div>
-<div class="sect2" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h3 class="title"><a name="wigdets" id=
-"wigdets"></a>1.2.&nbsp;Description of XXX window</h3>
-</div>
-</div>
-</div>
-<p>Now the XXX window will open.</p>
+"Oceania at 125 metters of depth with proper grid initialization"></div>
+</div>
+<p><br class="figure-break"></p>
+</div>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="launch_xxx_2" id=
+"launch_xxx_2"></a>1.2.&nbsp;<code class="prompt">idl&gt;</code>
+<strong class="userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>/separate</code></em></code></strong></h3>
+</div>
+</div>
+</div>
+<p>This is the same as the simple <a href="#launch_xxx_1" title=
+"1.1.&nbsp;idl&gt; xxx"><code class="prompt">idl&gt;</code>
+<strong class="userinput"><code><span><strong class=
+"command">xxx</strong></span></code></strong></a> except that once
+the xxx window open, you will have 2 separate windows (command and
+plotting window) instead of one.</p>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="launch_xxx_3" id=
+"launch_xxx_3"></a>1.3.&nbsp;<code class="prompt">idl&gt;</code>
+<strong class="userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class="parameter"><code>restore
+= 'file.dat'</code></em></code></strong></h3>
+</div>
+</div>
+</div>
+<p>In that case xxx window will open directly in the same state as
+it was when the file "file.dat" was created. see <a href=
+"#restore">+++++++</a></p>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="launch_xxx_4" id=
+"launch_xxx_4"></a>1.4.&nbsp;<code class="prompt">idl&gt;</code>
+<strong class="userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em></code></strong></h3>
+</div>
+</div>
+</div>
+<p>In this case, the xxx window directly open the data file
+'file.nc' and build the grid automatically with the IDL procedure
+<span><strong class="command">initncdf</strong></span>. For
+example:</p>
+<pre class="screen">
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_1x1.nc'</code></em></code></strong>
+  
+</pre></div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="launch_xxx_5" id=
+"launch_xxx_5"></a>1.5.&nbsp;<code class="prompt">idl&gt;</code>
+<strong class="userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>keywd1 = ...</code></em>, <em class=
+"parameter"><code>keywd2 = ...</code></em></code></strong></h3>
+</div>
+</div>
+</div>
+<p>In this case, the xxx window directly open the data file
+'file.nc', build the grid automatically with the IDL procedure
+<span><strong class="command">initncdf</strong></span> and use the
+keywords <strong class="userinput"><code><em class=
+"parameter"><code>keywd1 = ...</code></em>, <em class=
+"parameter"><code>keywd2 = ...</code></em></code></strong> in the
+call of <span><strong class="command">initncdf</strong></span>. For
+example:</p>
+<pre class="screen">
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_1x1.nc'</code></em>, <em class="parameter"><code>useasmask = 'votemper'</code></em>, <em class="parameter"><code>missing_value = 31.0720</code></em></code></strong>
+  
+</pre></div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="launch_xxx_6" id=
+"launch_xxx_6"></a>1.6.&nbsp;<code class="prompt">idl&gt;</code>
+<strong class="userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>'initgrid'</code></em></code></strong></h3>
+</div>
+</div>
+</div>
+<p>In this case, the xxx window directly open the data file
+'file.nc' and build the grid directly with the IDL procedure or
+batch file <span><strong class=
+"command">initgrid</strong></span></p>
+<pre class="screen">
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc'</code></em>, <em class="parameter"><code>'tst_initorca2'</code></em></code></strong>
+  
+</pre></div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="launch_xxx_7" id=
+"launch_xxx_7"></a>1.7.&nbsp;<code class="prompt">idl&gt;</code>
+<strong class="userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>'initgrid'</code></em>, <em class=
+"parameter"><code>keywd1 = ...</code></em>, <em class=
+"parameter"><code>keywd2 = ...</code></em></code></strong></h3>
+</div>
+</div>
+</div>
+<p>In this case, the xxx window directly open the data file
+'file.nc', build the grid directly with the IDL procedure
+<span><strong class="command">initgrid</strong></span> and use the
+keywords <strong class="userinput"><code><em class=
+"parameter"><code>keywd1 = ...</code></em>, <em class=
+"parameter"><code>keywd2 = ...</code></em></code></strong> in the
+call of <span><strong class="command">initgrid</strong></span>.</p>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="launch_xxx_8" id=
+"launch_xxx_8"></a>1.8.&nbsp;<code class="prompt">idl&gt;</code>
+<strong class="userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'file.nc'</code></em>, <em class=
+"parameter"><code>'initgrid'</code></em>, <em class=
+"parameter"><code>'arg1, arg2,
+...'</code></em></code></strong></h3>
+</div>
+</div>
+</div>
+<p>In this case, the xxx window directly open the data file
+'file.nc', build the grid directly with the IDL procedure
+<span><strong class="command">initgrid</strong></span> and use the
+string <strong class="userinput"><code><em class=
+"parameter"><code>'arg1, arg2, ...'</code></em></code></strong> to
+specify the input arguments in the call of <span><strong class=
+"command">initgrid</strong></span>.</p>
+</div>
+</div>
+<div class="sect1" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both"><a name="wigdets" id=
+"wigdets"></a>2.&nbsp;Description of XXX window</h2>
+</div>
+</div>
+</div>
 <div class="figure"><a name="fig_xxx_0201" id="fig_xxx_0201"></a>
 <p class="title"><b>Figure&nbsp;4.&nbsp;Window xxx 2</b></p>
 <div class="figure-contents">
-<div class="mediaobjectco"><img border="0" usemap="d0e182" src=
+<div class="mediaobjectco"><img border="0" usemap="d0e506" src=
 "figpng/xxx_0201.png?format=raw" alt="Window xxx 2"><map name=
-"d0e182" id="d0e182">
+"d0e506" id="d0e506">
 <area shape="rect" coords="3,606,97,579">
 <area shape="rect" coords="108,606,325,577">
@@ -349,13 +642,10 @@
 </div>
 <p><br class="figure-break"></p>
-<p>It's configuration will change depending on whether you are in
-portrait or in landscape, but here are the different parts
-available for your use.</p>
-<div class="sect3" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h4 class="title"><a name="plottypetxt" id=
-"plottypetxt"></a>1.2.1.&nbsp;Plot type list</h4>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="plottypetxt" id=
+"plottypetxt"></a>2.1.&nbsp;Plot type list</h3>
 </div>
 </div>
@@ -374,24 +664,24 @@
 <p>If the type <code class="constant">plt</code> is selected, the
 selection of plot type is made by mouse. Cf <a href="#mouse" title=
-"2.1.&nbsp;In the graphics window on a horizontal plot">Section&nbsp;2.1,
+"3.1.&nbsp;In the graphics window on a horizontal plot">Section&nbsp;3.1,
 &ldquo;In the graphics window on a horizontal plot&rdquo;</a></p>
 </div>
 </div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="menutxt" id="menutxt"></a>2.2.&nbsp;The
+menu bar made up of 3 submenus</h3>
+</div>
+</div>
+</div>
 <div class="sect3" lang="en">
 <div class="titlepage">
 <div>
 <div>
-<h4 class="title"><a name="menutxt" id=
-"menutxt"></a>1.2.2.&nbsp;The menu bar made up of 3 submenus</h4>
-</div>
-</div>
-</div>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="filesubmenu" id=
-"filesubmenu"></a>1.2.2.1.&nbsp;<span class=
-"guisubmenu">File</span> submenu</h5>
+<h4 class="title"><a name="filesubmenu" id=
+"filesubmenu"></a>2.2.1.&nbsp;<span class="guisubmenu">File</span>
+submenu</h4>
 </div>
 </div>
@@ -406,15 +696,16 @@
 <ul type="disc">
 <li>
-<p><span class="guimenuitem">Open:</span> to open a second file.
-Same procedure as during the launching of XXX. The new file can be
-on a different grid, with different variables, with a different
-time base.</p>
-</li>
-<li>
-<p><span class="guimenuitem">New XXX:</span> to open a second XXX
-window identical to the first.</p>
-</li>
-<li>
-<p><span class="guimenuitem">Quit:</span> to close the XXX
+<p><span class="guibutton">Open:</span> to open a new file. Same
+procedure as during the <a href="#launch_xxx_1" title=
+"1.1.&nbsp;idl&gt; xxx">launch of XXX</a>. The new file can be on a
+different grid, with different variables, with a different time
+base...</p>
+</li>
+<li>
+<p><span class="guibutton">New XXX:</span> to open a second XXX
+window identical to the first one.</p>
+</li>
+<li>
+<p><span class="guibutton">Quit:</span> to close the XXX
 window.</p>
 </li>
@@ -422,11 +713,11 @@
 </div>
 </div>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="saveassubmenu" id=
-"saveassubmenu"></a>1.2.2.2.&nbsp;<span class="guisubmenu">Save
-As</span> submenu</h5>
+<div class="sect3" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title"><a name="saveassubmenu" id=
+"saveassubmenu"></a>2.2.2.&nbsp;<span class="guisubmenu">Save
+As</span> submenu</h4>
 </div>
 </div>
@@ -441,15 +732,18 @@
 <ul type="disc">
 <li>
-<p><span class="guimenuitem">Postscript:</span> to save in
-Postscript format</p>
-</li>
-<li>
-<p><span class="guimenuitem">Animated gif:</span>to create an
-animation from the XXX window. Careful, the creation of an
-animation is only possible if none of the plots have a time axis,
-and if the plots are all on the same time base (calendar). On the
-other hand, animations of horizontal and vertical plots, with
-different color palettes (for those not on an X-terminal), are
-possible.</p>
+<p><span class="guibutton">Postscript:</span> to save the plotting
+window in Postscript format</p>
+</li>
+<li>
+<p><span class="guibutton">Animated gif:</span> to create an
+animation of the plotting window.</p>
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Note</h3>
+<p>The creation of an animation is only possible if none of the
+plots have a time axis, and if the plots are all on the same time
+base (calendar). On the other hand, animations of horizontal and
+vertical plots, with different color palettes (for those not on an
+X-terminal), are possible.</p>
+</div>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
@@ -459,12 +753,13 @@
 </li>
 <li>
-<p><span class="guimenuitem">Gif:</span> to save a gif of the XXX
-graphics window.</p>
-</li>
-<li>
-<p><span class="guimenuitem">IDL procedure:</span> to save the
-command history that has created the plot. For example if I save
-the commands in <code class="filename">xxx_figure.pro</code>, I can
-then launch a new IDL session and type:</p>
+<p><span class="guibutton">Gif:</span> to save a gif of the
+plotting window.</p>
+</li>
+<li>
+<p><span class="guibutton">IDL procedure:</span> to save the
+command history that has created the plot in an IDL procedure that
+can be reexecuted later. For example if I save the commands in
+<code class="filename">xxx_figure.pro</code> file, when ever I
+want, I can then launch a new IDL session and type:</p>
 <pre class="screen">
 <code class="prompt">idl&gt;</code> <strong class=
@@ -486,9 +781,18 @@
 </li>
 <li>
-<p><span class="guimenuitem">RESTORE kwd of xxx:</span></p>
-</li>
-<li>
-<p><span class="guimenuitem">Print to prompt:</span> lists in the
-IDL window the command history that created the last plot. Useful
+<p><a name="restore" id="restore"></a><span class=
+"guibutton">RESTORE kwd of xxx:</span> to save the xxx widget (all
+buttons and parameters storeed in memory...) in a binary file in
+order to quit xxx and relauch it later with <a href="#launch_xxx_3"
+title="1.3.&nbsp;idl&gt; xxx, restore = 'file.dat'"><code class=
+"prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class="parameter"><code>restore
+= 'file.dat'</code></em></code></strong></a> and get exactly the
+same configuration.</p>
+</li>
+<li>
+<p><span class="guibutton">Print to prompt:</span> lists in the IDL
+window the command history that created the last plot. Useful
 primarily for debugging...</p>
 </li>
@@ -496,13 +800,11 @@
 </div>
 </div>
-<p>Test the various possibilities in the <span class="guimenu">Save
-As</span> menu.</p>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="flagsubmenu" id=
-"flagsubmenu"></a>1.2.2.3.&nbsp;<span class="guisubmenu">Flag
-options</span> submenu</h5>
+<div class="sect3" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title"><a name="flagsubmenu" id=
+"flagsubmenu"></a>2.2.3.&nbsp;<span class="guisubmenu">Flag
+options</span> submenu</h4>
 </div>
 </div>
@@ -545,7 +847,4 @@
 </ul>
 </div>
-</div>
-<p>Test the various possibilities in the <span class="guimenu">Flag
-options</span> menu.</p>
 <div class="caution" style=
 "margin-left: 0.5in; margin-right: 0.5in;">
@@ -555,10 +854,11 @@
 </div>
 </div>
-<div class="sect3" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h4 class="title"><a name="oktxt" id="oktxt"></a>1.2.3.&nbsp;OK
-button</h4>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="oktxt" id="oktxt"></a>2.3.&nbsp;OK
+button</h3>
 </div>
 </div>
@@ -567,10 +867,10 @@
 required to make a new plot appear</p>
 </div>
-<div class="sect3" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h4 class="title"><a name="pagelayouttxt" id=
-"pagelayouttxt"></a>1.2.4.&nbsp;Page Layout</h4>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="pagelayouttxt" id=
+"pagelayouttxt"></a>2.4.&nbsp;Page Layout</h3>
 </div>
 </div>
@@ -584,22 +884,20 @@
 </div>
 <p><br class="figure-break"></p>
-<p>For example: For 2 cln and 2 row. For explanations, see
-further.</p>
 <div class="figure"><a name="fig_xxx_0206a" id="fig_xxx_0206a"></a>
-<p class="title"><b>Figure&nbsp;10.&nbsp;A frame with several
-graphics</b></p>
+<p class="title"><b>Figure&nbsp;10.&nbsp;Example: For 2 cln and 2
+row</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0206a.png?format=raw" alt=
-"A frame with several graphics"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
-<div class="sect3" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h4 class="title"><a name="variableslisttxt" id=
-"variableslisttxt"></a>1.2.5.&nbsp;<span class="guimenuitem">List
-of variables</span></h4>
+"Example: For 2 cln and 2 row"></div>
+</div>
+<p><br class="figure-break"></p>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="variableslisttxt" id=
+"variableslisttxt"></a>2.5.&nbsp;<span class="guimenuitem">List of
+variables</span></h3>
 </div>
 </div>
@@ -607,19 +905,19 @@
 <p>you can choose the variable to work on.</p>
 <div class="figure"><a name="fig_xxx_0207" id="fig_xxx_0207"></a>
-<p class="title"><b>Figure&nbsp;11.&nbsp;differents Variables
-avaible</b></p>
+<p class="title"><b>Figure&nbsp;11.&nbsp;Example of differents
+Variables avaible</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0207.png?format=raw" alt=
-"differents Variables avaible"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
-<div class="sect3" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h4 class="title"><a name="fileslisttxt" id=
-"fileslisttxt"></a>1.2.6.&nbsp;<span class="guimenuitem">List of
-open files</span></h4>
+"Example of differents Variables avaible"></div>
+</div>
+<p><br class="figure-break"></p>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="fileslisttxt" id=
+"fileslisttxt"></a>2.6.&nbsp;<span class="guimenuitem">List of open
+files</span></h3>
 </div>
 </div>
@@ -627,94 +925,28 @@
 <p>you can choose the file to work on.</p>
 <div class="figure"><a name="fig_xxx_0208" id="fig_xxx_0208"></a>
-<p class="title"><b>Figure&nbsp;12.&nbsp;List of open files</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0208.png?format=raw" alt="List of open files"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
-<div class="sect3" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h4 class="title"><a name="commandtexttxt" id=
-"commandtexttxt"></a>1.2.7.&nbsp;<span class="guimenuitem">Command
-text</span></h4>
-</div>
-</div>
-</div>
-<p>To specify the computation you want to do. Examples:</p>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="withoutcommandtexttxt" id=
-"withoutcommandtexttxt"></a>1.2.7.1.&nbsp; <span class=
-"guimenuitem">Without any Command Text</span></h5>
-</div>
-</div>
-</div>
-<div class="figure"><a name="fig_xxx_0209" id="fig_xxx_0209"></a>
-<p class="title"><b>Figure&nbsp;13.&nbsp;Graphic by default</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0209.png?format=raw" alt="Graphic by default"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="withrealcont" id=
-"withrealcont"></a>1.2.7.2.&nbsp; <span class="guimenuitem">With
-the command text /realcont</span></h5>
-</div>
-</div>
-</div>
-<div class="figure"><a name="fig_xxx_0210a" id="fig_xxx_0210a"></a>
-<p class="title"><b>Figure&nbsp;14.&nbsp;Command text area</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0210a.png?format=raw" alt="Command text area"></div>
-</div>
-<p><br class="figure-break"></p>
-<div class="figure"><a name="fig_xxx_0210" id="fig_xxx_0210"></a>
-<p class="title"><b>Figure&nbsp;15.&nbsp;Graphic with the command
-text "/realcont"</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0210.png?format=raw" alt=
-"Graphic with the command text &quot;/realcont&quot;"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="withmaportho" id=
-"withmaportho"></a>1.2.7.3.&nbsp;<span class="guimenuitem">With the
-command text /realcont+ map=[90,0,0]+ /ortho+
-cell_fill=2.</span></h5>
-</div>
-</div>
-</div>
-<div class="figure"><a name="fig_xxx_0211a" id="fig_xxx_0211a"></a>
-<p class="title"><b>Figure&nbsp;16.&nbsp;Command text area with the
-right syntax</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0211a.png?format=raw" alt=
-"Command text area with the right syntax"></div>
-</div>
-<p><br class="figure-break"></p>
-<div class="figure"><a name="fig_xxx_0211" id="fig_xxx_0211"></a>
-<p class="title"><b>Figure&nbsp;17.&nbsp;Polar Projection</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0211.png?format=raw" alt="Polar Projection"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
+<p class="title"><b>Figure&nbsp;12.&nbsp;Example of list of open
+files</b></p>
+<div class="figure-contents"><img src=
+"figpng/xxx_0208.png?format=raw" alt=
+"Example of list of open files"></div>
+</div>
+<p><br class="figure-break"></p>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="commandtexttxt" id=
+"commandtexttxt"></a>2.7.&nbsp;<span class="guimenuitem">Command
+text</span></h3>
+</div>
+</div>
+</div>
+<p>To specify in the widget part number 7 the computation you want
+to do on the data</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
-<p>In the default case, the name given to a field is of no
-importance.</p>
-</div>
+<p>In all cases bellow, the name given to a field (a, b, c,...) is
+of no importance.</p>
 </div>
 <div class="sect3" lang="en">
@@ -722,6 +954,60 @@
 <div>
 <div>
-<h4 class="title"><a name="calendartxt" id=
-"calendartxt"></a>1.2.8.&nbsp;Calendar</h4>
+<h4 class="title"><a name="commandtext1" id=
+"commandtext1"></a>2.7.1.&nbsp;<span class="guimenuitem">Linear
+calculation</span></h4>
+</div>
+</div>
+</div>
+<p>If you want to make basic linear computation (like difference
+between fields, add/multiply by a constant...). you can simply put
+the following commands:</p>
+<pre class="screen">
+a - b
+</pre>
+<pre class="screen">
+numb1*a
+</pre>
+<pre class="screen">
+a + numb
+</pre>
+<p>or any command with the following format</p>
+<pre class="screen">
+numb1*a + numb2*b  + numb3*c ... + numb
+</pre>
+<p>where numb1, numb2,... correspond to numbers and a, b, c... will
+be the data to read.</p>
+</div>
+<div class="sect3" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title"><a name="commandtext1" id=
+"commandtext1"></a>2.7.2.&nbsp;<span class="guimenuitem">Any kind
+of computation calculation</span></h4>
+</div>
+</div>
+</div>
+<p>If you want to make a computation more complicated than a basic
+linear you must put designate the data you want to read between ""
+(with anything inbetween the "). For example:</p>
+<pre class="screen">
+"a"^2
+</pre>
+<pre class="screen">
+"a" - abs("b")
+</pre>
+<pre class="screen">
+grad("a", 'x')
+</pre>
+<p>...</p>
+</div>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="calendartxt" id=
+"calendartxt"></a>2.8.&nbsp;Calendar</h3>
 </div>
 </div>
@@ -730,21 +1016,19 @@
 specification of two dates, the beginning and end of a time series,
 or the period over which to average before plotting.</p>
-<p>Example: The first plot is during January.</p>
-<p>The second plot is from January to December.</p>
 <div class="figure"><a name="fig_xxx_0301" id="fig_xxx_0301"></a>
-<p class="title"><b>Figure&nbsp;18.&nbsp;Graphic with 2 different
-period of study</b></p>
+<p class="title"><b>Figure&nbsp;13.&nbsp;Example: first plot in
+January, second plot is from January to December</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0301.png?format=raw" alt=
-"Graphic with 2 different period of study"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
-<div class="sect3" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h4 class="title"><a name="domdeftxt" id=
-"domdeftxt"></a>1.2.9.&nbsp;Define the domain</h4>
+"Example: first plot in January, second plot is from January to December"></div>
+</div>
+<p><br class="figure-break"></p>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="domdeftxt" id=
+"domdeftxt"></a>2.9.&nbsp;Define the domain</h3>
 </div>
 </div>
@@ -752,93 +1036,57 @@
 <p>A series of widgets that allow specification of the min/max
 limits of the domain in longitude/x-index, latitude/y-index, and
-depth in levels or meters. For depth, one can specify in levels for
-a horizontal plot, and in meters for a vertical plot.</p>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="withoutdomainspecification" id=
-"withoutdomainspecification"></a>1.2.9.1.&nbsp;<span class=
-"guimenuitem">Without any domain specification</span></h5>
-</div>
-</div>
-</div>
+depth in levels or meters.</p>
 <div class="figure"><a name="fig_xxx_0210" id="fig_xxx_0210"></a>
-<p class="title"><b>Figure&nbsp;19.&nbsp;Domain by default</b></p>
+<p class="title"><b>Figure&nbsp;14.&nbsp;Domain by default</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0210.png?format=raw" alt="Domain by default"></div>
 </div>
 <p><br class="figure-break"></p>
-</div>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="withzoom" id=
-"withzoom"></a>1.2.9.2.&nbsp;<span class="guimenuitem">With a zoom
-on Oceania</span></h5>
-</div>
-</div>
-</div>
-<p>We can zoom, between 0 and 1 meter of depth, on the Oceania, by
-playing with the part Domdef, with this configuration</p>
 <div class="figure"><a name="fig_xxx_0401" id="fig_xxx_0401"></a>
-<p class="title"><b>Figure&nbsp;20.&nbsp;Change Domain area</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0401.png?format=raw" alt="Change Domain area"></div>
-</div>
-<p><br class="figure-break"></p>
-<p>This configuration give us:</p>
+<p class="title"><b>Figure&nbsp;15.&nbsp;Change Domain area: zoom
+on Oceania</b></p>
+<div class="figure-contents"><img src=
+"figpng/xxx_0401.png?format=raw" alt=
+"Change Domain area: zoom on Oceania"></div>
+</div>
+<p><br class="figure-break"></p>
 <div class="figure"><a name="fig_xxx_0402" id="fig_xxx_0402"></a>
-<p class="title"><b>Figure&nbsp;21.&nbsp;Graphic with a specified
-domain</b></p>
+<p class="title"><b>Figure&nbsp;16.&nbsp;This configuration give
+us:</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0402.png?format=raw" alt=
-"Graphic with a specified domain"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
-</div>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="depthspecificationtxt" id=
-"depthspecificationtxt"></a>1.2.1.&nbsp;<span class=
-"guimenuitem">With the specification of the depth</span></h5>
-</div>
-</div>
-</div>
-<p>If we want to see the temperature of the ocean between 125 and
-126 meters of depth</p>
+"This configuration give us:"></div>
+</div>
+<p><br class="figure-break"></p>
 <div class="figure"><a name="fig_xxx_0403" id="fig_xxx_0403"></a>
-<p class="title"><b>Figure&nbsp;22.&nbsp;Change depth area</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0403.png?format=raw" alt="Change depth area"></div>
+<p class="title"><b>Figure&nbsp;17.&nbsp;Change depth area: between
+depth 125 and 126</b></p>
+<div class="figure-contents"><img src=
+"figpng/xxx_0403.png?format=raw" alt=
+"Change depth area: between depth 125 and 126"></div>
 </div>
 <p><br class="figure-break"></p>
 <div class="figure"><a name="fig_xxx_0404" id="fig_xxx_0404"></a>
-<p class="title"><b>Figure&nbsp;23.&nbsp;Oceania at 125 metters of
-depth without a mask</b></p>
+<p class="title"><b>Figure&nbsp;18.&nbsp;temperature of the ocean
+at depth 125 meters without proper land/sea mask</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0404.png?format=raw" alt=
-"Oceania at 125 metters of depth without a mask"></div>
-</div>
-<p><br class="figure-break"></p>
-<p>As you can see, at this depth, we can see the difference between
-the continent at the surface and the real goegraphy of the terrain.
-If we want to see only the terrain at the specified depth, we have
-to put a mask. Cf <a href="#fig_xxx_0103" title=
-"Figure&nbsp;3.&nbsp;Oceania at 125 metters of depth with a mask">Figure&nbsp;3,
-&ldquo;Oceania at 125 metters of depth with a mask&rdquo;</a></p>
-<p>You can define precisely the depth you want to see:</p>
-<div class="figure"><a name="fig_xxx_0405" id="fig_xxx_0405"></a>
-<p class="title"><b>Figure&nbsp;24.&nbsp;The Precise Depth
-menu</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0405.png?format=raw" alt=
-"The Precise Depth menu"></div>
-</div>
-<p><br class="figure-break"></p>
+"temperature of the ocean at depth 125 meters without proper land/sea mask"></div>
+</div>
+<p><br class="figure-break">
+As you can see, at this depth, we better define a land/sea mask
+when loading the grid. Cf <a href="#fig_xxx_0103" title=
+"Figure&nbsp;3.&nbsp;Oceania at 125 metters of depth with proper grid initialization">
+Figure&nbsp;3, &ldquo;Oceania at 125 metters of depth with proper
+grid initialization&rdquo;</a></p>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="specificationstxt" id=
+"specificationstxt"></a>2.10.&nbsp;specify your plot</h3>
+</div>
+</div>
 </div>
 <div class="sect3" lang="en">
@@ -846,37 +1094,43 @@
 <div>
 <div>
-<h4 class="title"><a name="specificationstxt" id=
-"specificationstxt"></a>1.2.10.&nbsp;specify your plot</h4>
-</div>
-</div>
-</div>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="minmaxintervaltxt" id=
-"minmaxintervaltxt"></a>1.2.10.1.&nbsp;<span class=
-"guimenuitem">Specify the min, the max and the interval</span></h5>
-</div>
-</div>
-</div>
-<p>You can specify the min, max, and contour interval by filling
-out the provided boxes!</p>
-<p>You can restore configuration by default by pressing the
-"default" button.</p>
+<h4 class="title"><a name="minmaxintervaltxt" id=
+"minmaxintervaltxt"></a>2.10.1.&nbsp;<span class=
+"guimenuitem">Specify min, max and contour interval</span></h4>
+</div>
+</div>
+</div>
 <div class="figure"><a name="fig_xxx_0501" id="fig_xxx_0501"></a>
-<p class="title"><b>Figure&nbsp;25.&nbsp;Specification area</b></p>
-<div class="figure-contents"><img src=
-"figpng/xxx_0501.png?format=raw" alt="Specification area"></div>
-</div>
-<p><br class="figure-break"></p>
-</div>
-<div class="sect4" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title"><a name="colortxt" id=
-"colortxt"></a>1.2.10.2.&nbsp;<span class="guimenuitem">Specify the
-palette to be used</span></h5>
+<p class="title"><b>Figure&nbsp;19.&nbsp;min, max, and contour
+interval specifications</b></p>
+<div class="figure-contents"><img src=
+"figpng/xxx_0501.png?format=raw" alt=
+"min, max, and contour interval specifications"></div>
+</div>
+<p><br class="figure-break">
+You can restore configuration by default by pressing the "default"
+button.</p>
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Note</h3>
+<p>The path of the file <a href=
+"../../ToBeReviewed/WIDGET/AUTOUR_de_XXX/definedefaultextra.pro?format=raw"
+target="_top"><code class=
+"filename">definedefaultextra.pro</code></a> that defines the
+default values for each variable names is displayed when the cursor
+hovers over the button Default. This file contains a case statement
+based on the name of the variable and defining the min, max,
+contour interval and other keywords that should be used as default
+for the specified variable. You can copy this file in your own
+<code class="filename"><code class=
+"envar">${HOME}</code>/My_IDL/</code> directory and easily modify
+it to suit your favorite default values.</p>
+</div>
+</div>
+<div class="sect3" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title"><a name="colortxt" id=
+"colortxt"></a>2.10.2.&nbsp;<span class="guimenuitem">Specify the
+palette to be used</span></h4>
 </div>
 </div>
@@ -885,5 +1139,5 @@
 search for one among the palettes available.</p>
 <div class="figure"><a name="fig_xxx_0502" id="fig_xxx_0502"></a>
-<p class="title"><b>Figure&nbsp;26.&nbsp;The Color menu</b></p>
+<p class="title"><b>Figure&nbsp;20.&nbsp;The Color menu</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0502.png?format=raw" alt="The Color menu"></div>
@@ -891,12 +1145,57 @@
 <p><br class="figure-break"></p>
 </div>
+<div class="sect3" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title"><a name="kwdtxt" id=
+"kwdtxt"></a>2.10.3.&nbsp;<span class="guimenuitem">Add any
+keyword</span></h4>
+</div>
+</div>
+</div>
 <p>The "keywords" window allows specification of all desired
-keywords. These keywords can be those of <code class=
-"filename">plt.pro</code>, <code class="filename">pltt.pro</code>,
-<code class="filename">pltz.pro</code>, <code class=
-"filename">plt1d.pro</code>, or those of contour, plot, or all
-other programs that are used. Cf <a href="#commandtexttxt" title=
-"1.2.7.&nbsp;Command text">Section&nbsp;1.2.7, &ldquo;<span class=
-"guimenuitem">Command text</span>&rdquo;</a></p>
+keywords. There is a few examples of the use of this "keywords"
+window.</p>
+<div class="figure"><a name="fig_xxx_0209" id="fig_xxx_0209"></a>
+<p class="title"><b>Figure&nbsp;21.&nbsp;Without any additional
+keyword</b></p>
+<div class="figure-contents"><img src=
+"figpng/xxx_0209.png?format=raw" alt=
+"Without any additional keyword"></div>
+</div>
+<p><br class="figure-break"></p>
+<div class="figure"><a name="fig_xxx_0210a" id="fig_xxx_0210a"></a>
+<p class="title"><b>Figure&nbsp;22.&nbsp;add "/realcont"
+keyword</b></p>
+<div class="figure-contents"><img src=
+"figpng/xxx_0210a.png?format=raw" alt=
+"add &quot;/realcont&quot; keyword"></div>
+</div>
+<p><br class="figure-break"></p>
+<div class="figure"><a name="fig_xxx_0210" id="fig_xxx_0210"></a>
+<p class="title"><b>Figure&nbsp;23.&nbsp;Graphic with "/realcont"
+keyword</b></p>
+<div class="figure-contents"><img src=
+"figpng/xxx_0210.png?format=raw" alt=
+"Graphic with &quot;/realcont&quot; keyword"></div>
+</div>
+<p><br class="figure-break"></p>
+<div class="figure"><a name="fig_xxx_0211a" id="fig_xxx_0211a"></a>
+<p class="title"><b>Figure&nbsp;24.&nbsp;add "/realcont,
+map=[90,0,0], /ortho, cell_fill=2" keywords</b></p>
+<div class="figure-contents"><img src=
+"figpng/xxx_0211a.png?format=raw" alt=
+"add &quot;/realcont, map=[90,0,0], /ortho, cell_fill=2&quot; keywords"></div>
+</div>
+<p><br class="figure-break"></p>
+<div class="figure"><a name="fig_xxx_0211" id="fig_xxx_0211"></a>
+<p class="title"><b>Figure&nbsp;25.&nbsp;Graphic with "/realcont,
+map=[90,0,0], /ortho, cell_fill=2" keywords</b></p>
+<div class="figure-contents"><img src=
+"figpng/xxx_0211.png?format=raw" alt=
+"Graphic with &quot;/realcont, map=[90,0,0], /ortho, cell_fill=2&quot; keywords"></div>
+</div>
+<p><br class="figure-break"></p>
 </div>
 </div>
@@ -907,13 +1206,13 @@
 <div>
 <h2 class="title" style="clear: both"><a name="mouseactions" id=
-"mouseactions"></a>2.&nbsp;Mouse Actions</h2>
-</div>
-</div>
-</div>
-<div class="sect2" lang="en">
-<div class="titlepage">
-<div>
-<div>
-<h3 class="title"><a name="mouse" id="mouse"></a>2.1.&nbsp;In the
+"mouseactions"></a>3.&nbsp;Mouse Actions</h2>
+</div>
+</div>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title"><a name="mouse" id="mouse"></a>3.1.&nbsp;In the
 graphics window on a horizontal plot</h3>
 </div>
@@ -953,15 +1252,15 @@
 <li>
 <div class="figure"><a name="fig_mousell" id="fig_mousell"></a>
-<p class="title"><b>Figure&nbsp;27.&nbsp;<abbr class=
+<p class="title"><b>Figure&nbsp;26.&nbsp;<abbr class=
 "abbrev">LCL</abbr>---&gt;<code class="constant">plt</code></b></p>
 <div class="figure-contents">
-<div class="mediaobjectco"><img border="0" usemap="d0e769" src=
+<div class="mediaobjectco"><img border="0" usemap="d0e1058" src=
 "figpng/xxx_mousell.png?format=raw" alt="LCL---&gt;plt"><map name=
-"d0e769" id="d0e769"></map></div>
+"d0e1058" id="d0e1058"></map></div>
 </div>
 </div>
 <p><br class="figure-break"></p>
 <div class="figure"><a name="fig_xxx_0701" id="fig_xxx_0701"></a>
-<p class="title"><b>Figure&nbsp;28.&nbsp;Horizontal Plot</b></p>
+<p class="title"><b>Figure&nbsp;27.&nbsp;Horizontal Plot</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0701.png?format=raw" alt="Horizontal Plot"></div>
@@ -971,16 +1270,16 @@
 <li>
 <div class="figure"><a name="fig_mouselm" id="fig_mouselm"></a>
-<p class="title"><b>Figure&nbsp;29.&nbsp;<abbr class=
+<p class="title"><b>Figure&nbsp;28.&nbsp;<abbr class=
 "abbrev">LCM</abbr>---&gt;<code class=
 "constant">pltz</code></b></p>
 <div class="figure-contents">
-<div class="mediaobjectco"><img border="0" usemap="d0e793" src=
+<div class="mediaobjectco"><img border="0" usemap="d0e1082" src=
 "figpng/xxx_mouselm.png?format=raw" alt="LCM---&gt;pltz"><map name=
-"d0e793" id="d0e793"></map></div>
+"d0e1082" id="d0e1082"></map></div>
 </div>
 </div>
 <p><br class="figure-break"></p>
 <div class="figure"><a name="fig_xxx_0702" id="fig_xxx_0702"></a>
-<p class="title"><b>Figure&nbsp;30.&nbsp;Vertical Plot</b></p>
+<p class="title"><b>Figure&nbsp;29.&nbsp;Vertical Plot</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0702.png?format=raw" alt="Vertical Plot"></div>
@@ -990,16 +1289,16 @@
 <li>
 <div class="figure"><a name="fig_mouselr" id="fig_mouselr"></a>
-<p class="title"><b>Figure&nbsp;31.&nbsp;<abbr class=
+<p class="title"><b>Figure&nbsp;30.&nbsp;<abbr class=
 "abbrev">LCR</abbr>---&gt;<code class=
 "constant">pltt</code></b></p>
 <div class="figure-contents">
-<div class="mediaobjectco"><img border="0" usemap="d0e817" src=
+<div class="mediaobjectco"><img border="0" usemap="d0e1106" src=
 "figpng/xxx_mouselr.png?format=raw" alt="LCR---&gt;pltt"><map name=
-"d0e817" id="d0e817"></map></div>
+"d0e1106" id="d0e1106"></map></div>
 </div>
 </div>
 <p><br class="figure-break"></p>
 <div class="figure"><a name="fig_xxx_0703" id="fig_xxx_0703"></a>
-<p class="title"><b>Figure&nbsp;32.&nbsp;Common hovmoeller for xt
+<p class="title"><b>Figure&nbsp;31.&nbsp;Common hovmoeller for xt
 and yt cuts</b></p>
 <div class="figure-contents"><img src=
@@ -1022,5 +1321,5 @@
 <div>
 <h3 class="title"><a name="multipleplots" id=
-"multipleplots"></a>2.2.&nbsp;Create multiple plots on the same
+"multipleplots"></a>3.2.&nbsp;Create multiple plots on the same
 sheet and make them interact</h3>
 </div>
@@ -1045,17 +1344,17 @@
 <li>
 <div class="figure"><a name="fig_mousedl" id="fig_mousedl"></a>
-<p class="title"><b>Figure&nbsp;33.&nbsp;<abbr class=
+<p class="title"><b>Figure&nbsp;32.&nbsp;<abbr class=
 "abbrev">DCL</abbr>---&gt;&ldquo;<span class=
 "quote">reference</span>&rdquo; frame</b></p>
 <div class="figure-contents">
-<div class="mediaobjectco"><img border="0" usemap="d0e870" src=
+<div class="mediaobjectco"><img border="0" usemap="d0e1159" src=
 "figpng/xxx_mousedl.png?format=raw" alt=
-"DCL---&gt;reference frame"><map name="d0e870" id=
-"d0e870"></map></div>
+"DCL---&gt;reference frame"><map name="d0e1159" id=
+"d0e1159"></map></div>
 </div>
 </div>
 <p><br class="figure-break"></p>
 <div class="figure"><a name="fig_xxx_0801" id="fig_xxx_0801"></a>
-<p class="title"><b>Figure&nbsp;34.&nbsp;The reference frame is
+<p class="title"><b>Figure&nbsp;33.&nbsp;The reference frame is
 selected</b></p>
 <div class="figure-contents"><img src=
@@ -1067,17 +1366,17 @@
 <li>
 <div class="figure"><a name="fig_mousedm" id="fig_mousedm"></a>
-<p class="title"><b>Figure&nbsp;35.&nbsp;<abbr class=
+<p class="title"><b>Figure&nbsp;34.&nbsp;<abbr class=
 "abbrev">DCM</abbr>---&gt;&ldquo;<span class=
 "quote">target</span>&rdquo; frame</b></p>
 <div class="figure-contents">
-<div class="mediaobjectco"><img border="0" usemap="d0e895" src=
+<div class="mediaobjectco"><img border="0" usemap="d0e1184" src=
 "figpng/xxx_mousedm.png?format=raw" alt=
-"DCM---&gt;target frame"><map name="d0e895" id=
-"d0e895"></map></div>
+"DCM---&gt;target frame"><map name="d0e1184" id=
+"d0e1184"></map></div>
 </div>
 </div>
 <p><br class="figure-break"></p>
 <div class="figure"><a name="fig_xxx_0802" id="fig_xxx_0802"></a>
-<p class="title"><b>Figure&nbsp;36.&nbsp;The target frame is
+<p class="title"><b>Figure&nbsp;35.&nbsp;The target frame is
 selected</b></p>
 <div class="figure-contents"><img src=
@@ -1089,11 +1388,11 @@
 <li>
 <div class="figure"><a name="fig_mousedr" id="fig_mousedr"></a>
-<p class="title"><b>Figure&nbsp;37.&nbsp;<abbr class=
+<p class="title"><b>Figure&nbsp;36.&nbsp;<abbr class=
 "abbrev">DCR</abbr>---&gt;erase the frame</b></p>
 <div class="figure-contents">
-<div class="mediaobjectco"><img border="0" usemap="d0e917" src=
+<div class="mediaobjectco"><img border="0" usemap="d0e1206" src=
 "figpng/xxx_mousedr.png?format=raw" alt=
-"DCR---&gt;erase the frame"><map name="d0e917" id=
-"d0e917"></map></div>
+"DCR---&gt;erase the frame"><map name="d0e1206" id=
+"d0e1206"></map></div>
 </div>
 </div>
@@ -1105,4 +1404,13 @@
 <div class="procedure">
 <ol type="1">
+<li>
+<p>load xxx with the command:</p>
+<pre class="screen">
+    <code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code><span><strong class=
+"command">xxx</strong></span>, <em class=
+"parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc'</code></em>, <em class="parameter"><code>'tst_initorca05'</code></em></code></strong>
+  
+</pre></li>
 <li>
 <p>Select a 3-D field and create 6 frames for the sheet of
@@ -1123,5 +1431,5 @@
 in frame 4.</p>
 <div class="figure"><a name="fig_xxx_0901" id="fig_xxx_0901"></a>
-<p class="title"><b>Figure&nbsp;38.&nbsp;Frame with four
+<p class="title"><b>Figure&nbsp;37.&nbsp;Frame with four
 plot</b></p>
 <div class="figure-contents"><img src=
@@ -1148,5 +1456,5 @@
 </div>
 <div class="figure"><a name="fig_xxx_0902a" id="fig_xxx_0902a"></a>
-<p class="title"><b>Figure&nbsp;39.&nbsp;Command text area</b></p>
+<p class="title"><b>Figure&nbsp;38.&nbsp;Command text area</b></p>
 <div class="figure-contents"><img src=
 "figpng/xxx_0902a.png?format=raw" alt="Command text area"></div>
@@ -1158,5 +1466,5 @@
 redone.</p>
 <div class="figure"><a name="fig_xxx_0902" id="fig_xxx_0902"></a>
-<p class="title"><b>Figure&nbsp;40.&nbsp;The fourth plot with the
+<p class="title"><b>Figure&nbsp;39.&nbsp;The fourth plot with the
 keyword "nocontour"</b></p>
 <div class="figure-contents"><img src=
@@ -1169,6 +1477,6 @@
 </div>
 <div class="procedure">
-<p>in frame 5, let's create the same plot as in frame 2 except with
-different dates</p>
+<p>in frame 5, let's create the same plot as in frame 2 except we
+use pltv instead of plt</p>
 <ol type="1">
 <li>
@@ -1179,10 +1487,10 @@
 </li>
 <li>
-<p>change the date</p>
+<p>change plt for pltv</p>
 </li>
 <li>
 <p>click on <span class="guibutton">OK</span></p>
 <div class="figure"><a name="fig_xxx_0903" id="fig_xxx_0903"></a>
-<p class="title"><b>Figure&nbsp;41.&nbsp;Frame with five
+<p class="title"><b>Figure&nbsp;40.&nbsp;Frame with five
 plot</b></p>
 <div class="figure-contents"><img src=
@@ -1200,5 +1508,5 @@
 <div>
 <h2 class="title" style="clear: both"><a name="crash" id=
-"crash"></a>3.&nbsp;What should I do when it breakdown</h2>
+"crash"></a>4.&nbsp;What should I do when it breakdown</h2>
 </div>
 </div>
@@ -1207,5 +1515,6 @@
 <ol type="1">
 <li>
-<p>in the IDL window, type</p>
+<p>in the IDL window type (as many time you click on a button since
+a problem occurs in xxx !!!),</p>
 <pre class="screen">
 <code class="prompt">idl&gt;</code> <strong class=
@@ -1213,4 +1522,10 @@
 </pre></li>
 <li>
+<p>in the IDL window, type</p>
+<pre class="screen">
+<code class="prompt">idl&gt;</code> <strong class=
+"userinput"><code>domdef</code></strong>
+</pre></li>
+<li>
 <p><abbr class="abbrev">DCR</abbr> to erase the problem frame.</p>
 </li>
@@ -1218,5 +1533,5 @@
 <p>change the orientation of the plot by pressing Flag options
 -&gt; Portrait/Landscape. Cf <a href="#flagsubmenu" title=
-"1.2.2.3.&nbsp;Flag options submenu">Section&nbsp;1.2.2.3,
+"2.2.3.&nbsp;Flag options submenu">Section&nbsp;2.2.3,
 &ldquo;<span class="guisubmenu">Flag options</span>
 submenu&rdquo;</a></p>
@@ -1225,6 +1540,5 @@
 <p>quit XXX cleanly using <span class="guibutton">quit</span> from
 the <span class="guimenu">File</span> menu. Cf <a href=
-"#filesubmenu" title=
-"1.2.2.1.&nbsp;File submenu">Section&nbsp;1.2.2.1,
+"#filesubmenu" title="2.2.1.&nbsp;File submenu">Section&nbsp;2.2.1,
 &ldquo;<span class="guisubmenu">File</span> submenu&rdquo;</a></p>
 </li>
