source: trunk/SRC/Documentation/xmldoc/mini_notice.html @ 346

Last change on this file since 346 was 346, checked in by pinsard, 16 years ago

migration from
\DocBook 4 to \DocBook 5 : production outputs
  • Property svn:keywords set to Id
File size: 52.8 KB
Line 
1<?xml version="1.0" encoding="utf-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml">
4  <head>
5    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6    <title>Mini Guide for Basic Commands in the XXX Program</title>
7    <link rel="stylesheet" href="style.css" type="text/css" />
8    <link rel="stylesheet" href="saxo.css" type="text/css" />
9    <link rev="made" href="mailto:saxo-dev_at_forge.ipsl.jussieu.fr" />
10    <meta name="generator" content="DocBook XSL Stylesheets V1.71.1" />
11    <meta name="keywords" content="IDL, SAXO, xxx" />
12  </head>
13  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14    <div class="article" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="mini_notice" id="mini_notice"></a> Mini Guide for Basic Commands in the XXX Program </h2></div><div><div class="authorgroup">
15      <div class="author"><h3 class="author"><span class="firstname">Sé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></div>
16      <div class="author"><h3 class="author"><span class="firstname">Albert</span> <span class="surname">Fisher</span> </h3></div>
17      <div class="author"><h3 class="author"><span class="firstname">Françoise</span> <span class="surname">Pinsard</span> <code class="email">&lt;<a href="mailto:Francoise.Pinsard_at_locean-ipsl.upmc.fr">Francoise.Pinsard_at_locean-ipsl.upmc.fr</a>&gt;</code></h3></div>
18      <div class="author"><h3 class="author"><span class="firstname">Steve</span> <span class="surname">Navarro</span> </h3></div>
19    </div></div><div><span class="pubdate">svn Id of xml source file : $Id$<br /><br /></span></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>
20      <tr><td align="left">Revision 0.0</td><td align="left">May 29, 2000</td></tr><tr><td align="left" colspan="2">French release by Sébastien Masson</td></tr>
21      <tr><td align="left">Revision 0.1</td><td align="left">July, 2002</td></tr><tr><td align="left" colspan="2">Translation by Albert Fisher</td></tr>
22      <tr><td align="left">Revision 0.2</td><td align="left">July 20, 2006</td></tr><tr><td align="left" colspan="2">HTML to XML/Docbook migration by Françoise Pinsard</td></tr>
23      <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>
24      <tr><td align="left">Revision 1.1</td><td align="left">September, 2006</td></tr><tr><td align="left" colspan="2">Review by Sébastien Masson</td></tr>
25      <tr><td align="left">Revision 1.2</td><td align="left">April 2008</td></tr><tr><td align="left" colspan="2">migration from DocBook 4.2 to Docbook 5.0</td></tr>
26
27     </table></div></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#launchxxx">1. Launching XXX</a></span></dt><dd><dl><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="#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 sub-menus</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. List of variables</a></span></dt><dt><span class="sect2"><a href="#fileslisttxt">2.6. List of open files</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">3.1. In the graphics window on a horizontal plot</a></span></dt><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">4. What should I do when it breakdown</a></span></dt></dl></div>
28
29
30 
31
32
33<div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="launchxxx" id="launchxxx"></a>1. Launching XXX</h2></div></div></div>
34
35<p>
36There is several ways to launch XXX which we will detail in the next sections:
37  </p><pre class="screen">
38    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span></code></strong>
39    <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>
40    <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>
41    <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>
42    <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>
43    <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>
44    <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>
45    <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>
46  </pre><p>
47</p>
48
49<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_1" id="launch_xxx_1"></a>1.1. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span></code></strong></h3></div></div></div>
50  <p>
51    A window will open with 3 parts to consider.
52</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><div class="figure-contents">
53
54<div class="mediaobject"><img border="0" usemap="id2572796" src="figpng/xxx_0101.png" alt="Window xxx 1" /><map name="id2572796" id="id2572796"><area shape="rect" coords="27,298,504,249" /><area shape="rect" coords="81,242,450,183" /><area shape="rect" coords="3,175,538,36" /></map><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">
55<p>Data file name</p>
56</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">
57<p>Grid initialization method</p>
58</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/3.png" alt="3" border="0" /></td><td valign="top" align="left">
59<p>Grid initialization parameters</p>
60</td></tr></table></div></div>
61</div></div><p><br class="figure-break" />
62  </p>
63
64<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="datafiletxt" id="datafiletxt"></a>1.1.1. Data file name</h4></div></div></div>
65  <p>
66    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.
67  </p>
68</div>
69<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="initmethodtxt" id="initmethodtxt"></a>1.1.2. Grid initialization method</h4></div></div></div>
70  <p>
71    For visualising grilled data, you need to <a href="./firststeps.html#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 auxiliary 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).
72  </p>
73</div>
74<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="initprogramtxt" id="initprogramtxt"></a>1.1.3. Grid initialization parameters</h4></div></div></div>
75  <p>
76    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.
77By 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.
78    </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><div class="figure-contents">
79     
80      <div class="mediaobject"><img src="figpng/xxx_0102.png" alt="Window xxx 1" /></div>
81    </div></div><p><br class="figure-break" />
82  </p>
83  <p>
84    Once these two lines have been completed, click on <span class="guibutton">let's go</span>.
85  </p>
86  <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 18. temperature of the ocean at depth 125 meters without proper land/sea mask">Figure 18, “temperature of the ocean at depth 125 meters without proper land/sea mask”</a>
87  </p>
88<p>
89  </p><div class="figure"><a name="fig_xxx_0103" id="fig_xxx_0103"></a><p class="title"><b>Figure 3. Oceania at 125 meters of depth with proper grid initialization</b></p><div class="figure-contents">
90     
91<div class="mediaobject"><img src="figpng/xxx_0103.png" alt="Oceania at 125 meters of depth with proper grid initialization" /></div>
92  </div></div><p><br class="figure-break" />
93</p>
94</div>
95</div>
96
97<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_2" id="launch_xxx_2"></a>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></h3></div></div></div>
98<p>
99This is the same as the simple <a href="#launch_xxx_1" title="1.1. 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.
100</p>
101</div>
102
103<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_3" id="launch_xxx_3"></a>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></h3></div></div></div>
104<p>
105In 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>
106</p>
107</div>
108
109<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_4" id="launch_xxx_4"></a>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></h3></div></div></div>
110<p>
111In 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:
112  </p><pre class="screen">
113    <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>
114  </pre><p>
115</p>
116</div>
117
118<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_5" id="launch_xxx_5"></a>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></h3></div></div></div>
119<p>
120In 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:
121  </p><pre class="screen">
122    <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>
123  </pre><p>
124</p>
125</div>
126
127<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_6" id="launch_xxx_6"></a>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></h3></div></div></div>
128<p>
129In 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>
130  </p><pre class="screen">
131    <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>
132  </pre><p>
133</p>
134</div>
135
136<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_7" id="launch_xxx_7"></a>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></h3></div></div></div>
137<p>
138In 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>.
139</p>
140</div>
141
142<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_8" id="launch_xxx_8"></a>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></h3></div></div></div>
143<p>
144In 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>.
145</p>
146</div>
147
148</div>
149
150<div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="wigdets" id="wigdets"></a>2. Description of XXX window</h2></div></div></div>
151
152<p>
153
154</p><div class="figure"><a name="fig_xxx_0201" id="fig_xxx_0201"></a><p class="title"><b>Figure 4. Window xxx 2</b></p><div class="figure-contents">
155
156<div class="mediaobject"><img border="0" usemap="id2573385" src="figpng/xxx_0201.png" alt="Window xxx 2" /><map name="id2573385" id="id2573385"><area shape="rect" coords="4,346,122,331" /><area shape="rect" coords="136,346,409,330" /><area shape="rect" coords="6,326,55,311" /><area shape="rect" coords="88,326,243,311" /><area shape="rect" coords="263,326,407,311" /><area shape="rect" coords="2,306,433,293" /><area shape="rect" coords="2,288,436,269" /><area shape="rect" coords="2,263,267,237" /><area shape="rect" coords="20,230,388,105" /><area shape="rect" coords="1,98,434,29" /></map><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">
157<p>Plot type</p>
158</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">
159<p>Menu</p>
160</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/3.png" alt="3" border="0" /></td><td valign="top" align="left">
161<p>OK</p>
162</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/4.png" alt="4" border="0" /></td><td valign="top" align="left">
163<p>Page layout</p>
164</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/5.png" alt="5" border="0" /></td><td valign="top" align="left">
165<p>Variables list</p>
166</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/6.png" alt="6" border="0" /></td><td valign="top" align="left">
167<p>Files list</p>
168</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/7.png" alt="7" border="0" /></td><td valign="top" align="left">
169<p>Command text</p>
170</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/8.png" alt="8" border="0" /></td><td valign="top" align="left">
171<p>Calendar</p>
172</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/9.png" alt="9" border="0" /></td><td valign="top" align="left">
173<p>Domdef</p>
174</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/10.png" alt="10" border="0" /></td><td valign="top" align="left">
175<p>Spefications</p>
176</td></tr></table></div></div>
177</div></div><p><br class="figure-break" />
178</p>
179
180<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plottypetxt" id="plottypetxt"></a>2.1. Plot type list</h3></div></div></div>
181<p>Allows specification of the type of plot desired.</p>
182<p>
183    </p><div class="figure"><a name="fig_xxx_0202" id="fig_xxx_0202"></a><p class="title"><b>Figure 5. Different plot types available</b></p><div class="figure-contents">
184     
185<div class="mediaobject"><img src="figpng/xxx_0202.png" alt="Different plot types available" /></div>
186    </div></div><p><br class="figure-break" />
187</p>
188<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
189<p>
190If the type <code class="constant">plt</code> is selected, the selection of plot type
191is made by mouse. Cf <a href="#mouse" title="3.1. In the graphics window on a horizontal plot">Section 3.1, “In the graphics window on a horizontal plot”</a></p>
192</div>
193</div>
194
195<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="menutxt" id="menutxt"></a>2.2. The menu bar made up of 3 sub-menus</h3></div></div></div>
196<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="filesubmenu" id="filesubmenu"></a>2.2.1. <span class="guibutton">File</span> sub-menu</h4></div></div></div>
197<p>
198    </p><div class="figure"><a name="fig_xxx_0203" id="fig_xxx_0203"></a><p class="title"><b>Figure 6. The File menu</b></p><div class="figure-contents">
199     
200<div class="mediaobject"><img src="figpng/xxx_0203.png" alt="The File menu" /></div>
201    </div></div><p><br class="figure-break" />
202</p>
203<p>
204</p><div class="itemizedlist"><ul type="disc"><li><p><span class="guisubmenu">Open:</span> to open a new file. Same procedure as during the <a href="#launch_xxx_1" title="1.1. idl&gt; xxx">launch of XXX</a>.
205The new file can be on a different grid, with different variables, with a different time base 

206</p></li><li><p><span class="guisubmenu">New XXX:</span> to open a second XXX window xml:identical to the first one.</p></li><li><p><span class="guisubmenu">Quit:</span> to close the XXX window.</p></li></ul></div><p>
207</p>
208</div>
209<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="saveassubmenu" id="saveassubmenu"></a>2.2.2. <span class="guibutton">Save As</span> sub-menu</h4></div></div></div>
210<p>
211    </p><div class="figure"><a name="fig_xxx_0204" id="fig_xxx_0204"></a><p class="title"><b>Figure 7. The Save As menu</b></p><div class="figure-contents">
212     
213<div class="mediaobject"><img src="figpng/xxx_0204.png" alt="The Save As menu" /></div>
214    </div></div><p><br class="figure-break" />
215</p>
216<p>
217</p><div class="itemizedlist"><ul type="disc"><li><p><span class="guisubmenu">Postscript:</span> to save the plotting window in Postscript format</p></li><li><p><span class="guisubmenu">Animated gif:</span> to create an animation of the plotting window.
218</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><p>
219</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The creation of animations has a tendency to saturate the video memory of X-terminals, crashing the entire program 
</p></div><p>
220</p></li><li><p><span class="guisubmenu">Gif:</span> to save a gif of the plotting window.</p></li><li><p><span class="guisubmenu">IDL procedure:</span> to save the command history that has created the plot in an IDL procedure that can be re-executed 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:
221  </p><pre class="screen">
222<code class="prompt">idl&gt;</code> <strong class="userinput"><code>@init</code></strong>
223<code class="prompt">idl&gt;</code> <strong class="userinput"><code>xxx_figure</code></strong>
224</pre><p>
225and I'll obtain the saved figure.
226  </p><pre class="screen">
227<code class="prompt">idl&gt;</code> <strong class="userinput"><code>xxx_figure,/post</code></strong>
228</pre><p>
229or
230  </p><pre class="screen">
231<code class="prompt">idl&gt;</code> <strong class="userinput"><code>@ps</code></strong>
232</pre><p>
233will then create a Postscript file of the figure.
234</p></li><li><p><a name="restore" id="restore"></a><span class="guisubmenu">RESTORE kwd of xxx:</span> to save the xxx widget (all buttons and parameters stored in memory 
) in a binary file in order to quit xxx and relaunch it later with <a href="#launch_xxx_3" title="1.3. 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="guisubmenu">Print to prompt:</span> lists in the IDL window the command history that created the last plot. Useful primarily for debugging
</p></li></ul></div><p>
235</p>
236</div>
237<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="flagsubmenu" id="flagsubmenu"></a>2.2.3. <span class="guisubmenu">Flag options</span> sub-menu</h4></div></div></div>
238<p>
239    </p><div class="figure"><a name="fig_xxx_0205" id="fig_xxx_0205"></a><p class="title"><b>Figure 8. The Flag Option menu</b></p><div class="figure-contents">
240     
241<div class="mediaobject"><img src="figpng/xxx_0205.png" alt="The Flag Option menu" /></div>
242    </div></div><p><br class="figure-break" />
243</p>
244<p>
245</p><div class="itemizedlist"><ul type="disc"><li><p><span class="guisubmenu">Portrait/Landscape:</span> changes the configuration of the plot.</p></li><li><p><span class="guisubmenu">Overlay:</span> to plot contours of a different field on top the
246one represented as color-filled contours. It is necessary to relaunch the entire plot to make this work!</p></li><li><p><span class="guisubmenu">Vecteur:</span> to plot a vector field on top of contours. Only
247works on horizontal plots (<code class="filename">plt.pro</code>).
248As for Overlay, a relaunch of the entire plot is necessary.</p></li><li><p><span class="guisubmenu">Longitude / x index:</span> switches longitude labeling of the plot sub-domain from degrees to indexes following i.</p></li><li><p><span class="guisubmenu">Latitude / y index:</span> switches latitude labeling of the plot sub-domain from degrees to indexes following j.</p></li></ul></div><p>
249</p>
250<div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Caution</h3><p>Careful, a selected option remains selected until it is re-clicked.</p></div>
251</div>
252</div>
253
254<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="oktxt" id="oktxt"></a>2.3. OK button</h3></div></div></div>
255<p>Click on this <span class="guibutton">OK</span> button is required to make a new plot appear</p>
256</div>
257
258<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="pagelayouttxt" id="pagelayouttxt"></a>2.4. Page Layout</h3></div></div></div>
259<p>Specify the number of columns and rows for plots on the sheet of paper.</p>
260<p>
261    </p><div class="figure"><a name="fig_xxx_0206" id="fig_xxx_0206"></a><p class="title"><b>Figure 9. Number of Column</b></p><div class="figure-contents">
262     
263<div class="mediaobject"><img src="figpng/xxx_0206.png" alt="Number of Column" /></div>
264    </div></div><p><br class="figure-break" />
265</p>
266<p>
267    </p><div class="figure"><a name="fig_xxx_0206a" id="fig_xxx_0206a"></a><p class="title"><b>Figure 10. Example: For 2 columns and 2 rows</b></p><div class="figure-contents">
268     
269<div class="mediaobject"><img src="figpng/xxx_0206a.png" alt="Example: For 2 columns and 2 rows" /></div>
270    </div></div><p><br class="figure-break" />
271</p>
272</div>
273
274<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="variableslisttxt" id="variableslisttxt"></a>2.5. List of variables</h3></div></div></div>
275<p>You can choose the variable to work on.</p>
276<p>
277    </p><div class="figure"><a name="fig_xxx_0207" id="fig_xxx_0207"></a><p class="title"><b>Figure 11. Example of different Variables available</b></p><div class="figure-contents">
278     
279<div class="mediaobject"><img src="figpng/xxx_0207.png" alt="Example of different Variables available" /></div>
280    </div></div><p><br class="figure-break" />
281</p>
282</div>
283
284<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="fileslisttxt" id="fileslisttxt"></a>2.6. List of open files</h3></div></div></div>
285<p>You can choose the file to work on.</p>
286<p>
287    </p><div class="figure"><a name="fig_xxx_0208" id="fig_xxx_0208"></a><p class="title"><b>Figure 12. Example of list of open files</b></p><div class="figure-contents">
288     
289<div class="mediaobject"><img src="figpng/xxx_0208.png" alt="Example of list of open files" /></div>
290    </div></div><p><br class="figure-break" />
291</p>
292</div>
293
294<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="commandtexttxt" id="commandtexttxt"></a>2.7. <span class="guimenuitem">Command text</span></h3></div></div></div>
295<p>
296To specify in the widget part number 7 the computation you want to do on the data
297</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>In all cases bellow, the name given to a field (a, b, c, 
) is of no importance.</p></div><p>
298</p>
299<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="commandtext_linear" id="commandtext_linear"></a>2.7.1. Linear calculation</h4></div></div></div>
300<p>
301If 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.
302</p>
303</div>
304<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="commandtext_anykind" id="commandtext_anykind"></a>2.7.2. Any kind of computation</h4></div></div></div>
305<p>
306If you want to make a computation more complicated than a basic linear you must put designate the data you want to read between <span><strong class="keycap">"</strong></span><span><strong class="keycap">"</strong></span> (with anything in between 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> â€Š
307</p>
308</div>
309</div>
310
311<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="calendartxt" id="calendartxt"></a>2.8. Calendar</h3></div></div></div>
312<p>
313The calendar is made up of two drop-lists, which allow specification of two dates, the beginning and end of a time series, or the period over which to average before plotting.</p>
314<p>
315    </p><div class="figure"><a name="fig_xxx_0301" id="fig_xxx_0301"></a><p class="title"><b>Figure 13. Example: first plot in January, second plot is from January to December</b></p><div class="figure-contents">
316     
317<div class="mediaobject"><img src="figpng/xxx_0301.png" alt="Example: first plot in January, second plot is from January to December" /></div>
318    </div></div><p><br class="figure-break" />
319</p>
320</div>
321
322<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="domdeftxt" id="domdeftxt"></a>2.9. Define the domain</h3></div></div></div>
323<p>
324  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.
325  </p><div class="figure"><a name="fig_xxx_0210_domain" id="fig_xxx_0210_domain"></a><p class="title"><b>Figure 14. Domain by default</b></p><div class="figure-contents">
326   
327<div class="mediaobject"><img src="figpng/xxx_0210.png" alt="Domain by default" /></div>
328  </div></div><p><br class="figure-break" />
329  </p><div class="figure"><a name="fig_xxx_0401" id="fig_xxx_0401"></a><p class="title"><b>Figure 15. Change Domain area: zoom on Oceania</b></p><div class="figure-contents">
330   
331<div class="mediaobject"><img src="figpng/xxx_0401.png" alt="Change Domain area: zoom on Oceania" /></div>
332  </div></div><p><br class="figure-break" />
333  </p><div class="figure"><a name="fig_xxx_0402" id="fig_xxx_0402"></a><p class="title"><b>Figure 16. This configuration give us:</b></p><div class="figure-contents">
334   
335<div class="mediaobject"><img src="figpng/xxx_0402.png" alt="This configuration give us:" /></div>
336  </div></div><p><br class="figure-break" />
337  </p><div class="figure"><a name="fig_xxx_0403" id="fig_xxx_0403"></a><p class="title"><b>Figure 17. Change depth area: between depth 125 and 126</b></p><div class="figure-contents">
338   
339<div class="mediaobject"><img src="figpng/xxx_0403.png" alt="Change depth area: between depth 125 and 126" /></div>
340  </div></div><p><br class="figure-break" />
341  </p><div class="figure"><a name="fig_xxx_0404" id="fig_xxx_0404"></a><p class="title"><b>Figure 18. temperature of the ocean at depth 125 meters without proper land/sea mask</b></p><div class="figure-contents">
342   
343<div class="mediaobject"><img src="figpng/xxx_0404.png" alt="temperature of the ocean at depth 125 meters without proper land/sea mask" /></div>
344  </div></div><p><br class="figure-break" />
345  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 3. Oceania at 125 meters of depth with proper grid initialization">Figure 3, “Oceania at 125 meters of depth with proper grid initialization”</a>
346</p>
347</div>
348
349<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="specificationstxt" id="specificationstxt"></a>2.10. Specify your plot</h3></div></div></div>
350
351<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="minmaxintervaltxt" id="minmaxintervaltxt"></a>2.10.1. Specify min, max and contour interval</h4></div></div></div>
352<p>
353  </p><div class="figure"><a name="fig_xxx_0501" id="fig_xxx_0501"></a><p class="title"><b>Figure 19. min, max, and contour interval specifications</b></p><div class="figure-contents">
354   
355<div class="mediaobject"><img src="figpng/xxx_0501.png" alt="min, max, and contour interval specifications" /></div>
356  </div></div><p><br class="figure-break" />
357  You can restore configuration by default by pressing the <span class="guibutton">Default</span> button.
358  </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" 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 <span class="guibutton">Default</span>. 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">${HOME}/My_IDL/</code> directory and easily modify it to suit your favorite default values.</p></div><p>
359</p>
360</div>
361
362<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="colortxt" id="colortxt"></a>2.10.2. Specify the palette to be used</h4></div></div></div>
363<p>For the color palette, you can either specify the name or go search for one among the palettes available.</p>
364<p>
365    </p><div class="figure"><a name="fig_xxx_0502" id="fig_xxx_0502"></a><p class="title"><b>Figure 20. The Color menu</b></p><div class="figure-contents">
366     
367<div class="mediaobject"><img src="figpng/xxx_0502.png" alt="The Color menu" /></div>
368    </div></div><p><br class="figure-break" />
369</p>
370</div>
371
372<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="kwdtxt" id="kwdtxt"></a>2.10.3. Add any keyword</h4></div></div></div>
373<p>
374  The “<span class="quote">keywords</span>” window allows specification of all desired keywords. There is a few examples of the use of this “<span class="quote">keywords</span>” window.
375  </p><div class="figure"><a name="fig_xxx_0209" id="fig_xxx_0209"></a><p class="title"><b>Figure 21. Without any additional keyword</b></p><div class="figure-contents">
376   
377<div class="mediaobject"><img src="figpng/xxx_0209.png" alt="Without any additional keyword" /></div>
378  </div></div><p><br class="figure-break" />
379  </p><div class="figure"><a name="fig_xxx_0210a" id="fig_xxx_0210a"></a><p class="title"><b>Figure 22. Add <code class="varname">/realcont</code> keyword</b></p><div class="figure-contents">
380   
381<div class="mediaobject"><img src="figpng/xxx_0210a.png" alt="Add /realcont keyword" /></div>
382  </div></div><p><br class="figure-break" />
383  </p><div class="figure"><a name="fig_xxx_0210_realcont" id="fig_xxx_0210_realcont"></a><p class="title"><b>Figure 23. Graphic with <code class="varname">/realcont</code> keyword</b></p><div class="figure-contents">
384   
385<div class="mediaobject"><img src="figpng/xxx_0210.png" alt="Graphic with /realcont keyword" /></div>
386  </div></div><p><br class="figure-break" />
387  </p><div class="figure"><a name="fig_xxx_0211a" id="fig_xxx_0211a"></a><p class="title"><b>Figure 24. Add <code class="userinput">/realcont, map=[90,0,0], /ortho, cell_fill=2</code> keywords</b></p><div class="figure-contents">
388   
389<div class="mediaobject"><img src="figpng/xxx_0211a.png" alt="Add /realcont, map=[90,0,0], /ortho, cell_fill=2 keywords" /></div>
390  </div></div><p><br class="figure-break" />
391  </p><div class="figure"><a name="fig_xxx_0211" id="fig_xxx_0211"></a><p class="title"><b>Figure 25. Graphic with <code class="literal">/realcont, map=[90,0,0], /ortho, cell_fill=2</code> keywords</b></p><div class="figure-contents">
392   
393<div class="mediaobject"><img src="figpng/xxx_0211.png" alt="Graphic with /realcont, map=[90,0,0], /ortho, cell_fill=2 keywords" /></div>
394  </div></div><p><br class="figure-break" />
395</p>
396</div>
397</div>
398</div>
399
400<div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mouseactions" id="mouseactions"></a>3. Mouse Actions</h2></div></div></div>
401
402<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mouse" id="mouse"></a>3.1. In the graphics window on a horizontal plot</h3></div></div></div>
403<p>
404Select a domain and select the horizontal plot (<code class="constant">plt</code>), vertical plot
405(<code class="constant">pltz</code>), or the hovmoeller plot (<code class="constant">pltt</code>):</p>
406<p>
407The domain we'd like to select for the plot is determined by one of
408its diagonals, defined therefore by two points.
409The first point is
410defined when the mouse button is pushed, then the mouse is moved, and
411the second point is defined as the mouse button is released
412(click-drag).
413The domains are thus defined by a long click (<abbr class="abbrev">LC</abbr>).
414To determine which type of plot should be made of selection, use:
415</p>
416<p>
417If the plot selector is on <code class="constant">plt</code>
418</p><div class="itemizedlist"><ul type="disc"><li><p>the <span class="mousebutton">left</span> mouse button to create horizontal plots (<code class="constant">plt</code>)</p></li><li><p>the <span class="mousebutton">middle</span> mouse button to create vertical plots (<code class="constant">pltz</code>)</p></li><li><p>the <span class="mousebutton">right</span> mouse button to create common hovmoellers for xt and yt cuts (<code class="constant">pltt</code>)</p></li></ul></div><p>
419</p>
420
421<p>In summary:</p>
422<p>
423</p><div class="itemizedlist"><ul type="disc"><li>
424<p>
425    </p><div class="figure"><a name="fig_mousell" id="fig_mousell"></a><p class="title"><b>Figure 26. <abbr class="abbrev">LCL</abbr>---&gt;<code class="constant">plt</code></b></p><div class="figure-contents">
426     
427      <div class="mediaobject"><img src="figpng/xxx_mousell.png" alt="LCL---&gt;plt" /></div>
428    </div></div><p><br class="figure-break" />
429</p>
430<p>
431    </p><div class="figure"><a name="fig_xxx_0701" id="fig_xxx_0701"></a><p class="title"><b>Figure 27. Horizontal Plot</b></p><div class="figure-contents">
432     
433      <div class="mediaobject"><img src="figpng/xxx_0701.png" alt="Horizontal Plot" /></div>
434    </div></div><p><br class="figure-break" />
435</p>
436
437</li><li>
438<p>
439    </p><div class="figure"><a name="fig_mouselm" id="fig_mouselm"></a><p class="title"><b>Figure 28. <abbr class="abbrev">LCM</abbr>---&gt;<code class="constant">pltz</code></b></p><div class="figure-contents">
440     
441      <div class="mediaobject"><img src="figpng/xxx_mouselm.png" alt="LCM---&gt;pltz" /></div>
442    </div></div><p><br class="figure-break" />
443</p>
444<p>
445    </p><div class="figure"><a name="fig_xxx_0702" id="fig_xxx_0702"></a><p class="title"><b>Figure 29. Vertical Plot</b></p><div class="figure-contents">
446     
447      <div class="mediaobject"><img src="figpng/xxx_0702.png" alt="Vertical Plot" /></div>
448    </div></div><p><br class="figure-break" />
449</p>
450
451</li><li>
452<p>
453    </p><div class="figure"><a name="fig_mouselr" id="fig_mouselr"></a><p class="title"><b>Figure 30. <abbr class="abbrev">LCR</abbr>---&gt;<code class="constant">pltt</code></b></p><div class="figure-contents">
454     
455      <div class="mediaobject"><img src="figpng/xxx_mouselr.png" alt="LCR---&gt;pltt" /></div>
456    </div></div><p><br class="figure-break" />
457</p>
458<p>
459    </p><div class="figure"><a name="fig_xxx_0703" id="fig_xxx_0703"></a><p class="title"><b>Figure 31. Common hovmoeller for xt and yt cuts</b></p><div class="figure-contents">
460     
461      <div class="mediaobject"><img src="figpng/xxx_0703.png" alt="Common hovmoeller for xt and yt cuts" /></div>
462    </div></div><p><br class="figure-break" />
463</p>
464
465</li></ul></div><p>
466</p>
467
468<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>If the plot selector is on something other than <code class="constant">plt</code> the indicated plot type is made.</p></div>
469
470</div>
471<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="multipleplots" id="multipleplots"></a>3.2. Create multiple plots on the same sheet and make them interact</h3></div></div></div>
472
473<p>
474Select the number of columns and rows for the page.</p>
475<p>
476Create a first plot.
477It will appear in the first frame.</p>
478<p>
479To create a plot in another frame double-click in the frame with the
480<span class="mousebutton">middle</span> button (<span class="mousebutton">DCM</span>).
481A black dotted frame will surround the designated frame, the “<span class="quote">target</span>” frame.
482A black frame will surround the first plot.
483This is the “<span class="quote">reference</span>” frame, in other words the one
484that all the XXX widgets refer to.
485Change for example the date and create a new plot.
486With a <span class="mousebutton">left</span> button double-click in the first
487frame, all the widgets change and refer again to the first plot.
488A double-click with the <span class="mousebutton">right</span> button in the second frame will erase the
489plot.</p>
490<p>In summary: </p>
491<div class="itemizedlist"><ul type="disc"><li>
492<p>
493    </p><div class="figure"><a name="fig_mousedl" id="fig_mousedl"></a><p class="title"><b>Figure 32. <abbr class="abbrev">DCL</abbr>---&gt;“<span class="quote">reference</span>” frame</b></p><div class="figure-contents">
494     
495      <div class="mediaobject"><img src="figpng/xxx_mousedl.png" alt="DCL---&gt;reference frame" /></div>
496    </div></div><p><br class="figure-break" />
497</p>
498<p>
499    </p><div class="figure"><a name="fig_xxx_0801" id="fig_xxx_0801"></a><p class="title"><b>Figure 33. The reference frame is selected</b></p><div class="figure-contents">
500     
501      <div class="mediaobject"><img src="figpng/xxx_0801.png" alt="The reference frame is selected" /></div>
502    </div></div><p><br class="figure-break" />
503</p>
504
505</li><li>
506<p>
507    </p><div class="figure"><a name="fig_mousedm" id="fig_mousedm"></a><p class="title"><b>Figure 34. <abbr class="abbrev">DCM</abbr>---&gt;“<span class="quote">target</span>” frame</b></p><div class="figure-contents">
508     
509      <div class="mediaobject"><img src="figpng/xxx_mousedm.png" alt="DCM---&gt;target frame" /></div>
510    </div></div><p><br class="figure-break" />
511</p>
512<p>
513    </p><div class="figure"><a name="fig_xxx_0802" id="fig_xxx_0802"></a><p class="title"><b>Figure 35. The target frame is selected</b></p><div class="figure-contents">
514     
515      <div class="mediaobject"><img src="figpng/xxx_0802.png" alt="The target frame is selected" /></div>
516    </div></div><p><br class="figure-break" />
517</p>
518</li><li>
519<p>
520    </p><div class="figure"><a name="fig_mousedr" id="fig_mousedr"></a><p class="title"><b>Figure 36. <abbr class="abbrev">DCR</abbr>---&gt;erase the frame</b></p><div class="figure-contents">
521     
522      <div class="mediaobject"><img src="figpng/xxx_mousedr.png" alt="DCR---&gt;erase the frame" /></div>
523    </div></div><p><br class="figure-break" />
524
525</p>
526</li></ul></div>
527<p>Here's a series of commands to show how this works.</p>
528<div class="procedure"><ol type="1"><li>
529<p>
530load xxx with the command:
531  </p><pre class="screen">
532    <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>
533  </pre><p>
534</p>
535</li><li>
536<p>
537Select a 3-D field and create 6 frames for the sheet of paper.
538</p>
539</li><li>
540<p>
541Create a horizontal plot in Frame 1
542</p>
543</li><li>
544<p>
545<abbr class="abbrev">DCM</abbr> in frame 2, <abbr class="abbrev">LCL</abbr> on the plot in frame 1, to create a horizontal
546zoom in frame 2.</p>
547<p>
548<abbr class="abbrev">DCM</abbr> in frame 3, <abbr class="abbrev">LCM</abbr> on the plot in frame 1, to create a vertical cut
549in frame 3.</p>
550<p>
551<abbr class="abbrev">DCM</abbr> in frame 4, <abbr class="abbrev">LCR</abbr> on the plot in frame 1, to create a hovmoeller in frame 4.
552</p>
553<p>
554    </p><div class="figure"><a name="fig_xxx_0901" id="fig_xxx_0901"></a><p class="title"><b>Figure 37. Frame with four plot</b></p><div class="figure-contents">
555     
556      <div class="mediaobject"><img src="figpng/xxx_0901.png" alt="Frame with four plot" /></div>
557    </div></div><p><br class="figure-break" />
558</p>
559</li></ol></div>
560<div class="procedure"><p>
561To redo the hovmoeller with the keyword </p><div class="literallayout"><p>/nocontour</p></div><p>
562</p><ol type="1"><li>
563<p>
564<abbr class="abbrev">DCL</abbr> in frame 4 which now becomes the reference and target frame.
565</p>
566</li><li>
567<p>
568Add the keyword
569</p><div class="literallayout"><p>/nocontour</p></div><p>
570</p>
571<p>
572    </p><div class="figure"><a name="fig_xxx_0902a" id="fig_xxx_0902a"></a><p class="title"><b>Figure 38. Command text area</b></p><div class="figure-contents">
573     
574      <div class="mediaobject"><img src="figpng/xxx_0902a.png" alt="Command text area" /></div>
575    </div></div><p><br class="figure-break" />
576</p>
577</li><li>
578<p>
579click <span class="guibutton">OK</span>, and the plot is redone.
580</p>
581<p>
582    </p><div class="figure"><a name="fig_xxx_0902" id="fig_xxx_0902"></a><p class="title"><b>Figure 39. The fourth plot with the keyword "nocontour"</b></p><div class="figure-contents">
583     
584      <div class="mediaobject"><img src="figpng/xxx_0902.png" alt="The fourth plot with the keyword &quot;nocontour&quot;" /></div>
585    </div></div><p><br class="figure-break" />
586</p>
587</li></ol></div>
588<div class="procedure"><p>
589in frame 5, let's create the same plot as in frame 2 except we use pltv instead of plt
590</p><ol type="1"><li>
591<p>
592<abbr class="abbrev">DCL</abbr> on frame 2
593</p>
594</li><li>
595<p>
596<abbr class="abbrev">DCM</abbr> on frame 5
597</p>
598</li><li>
599<p>
600change plt for pltv
601</p>
602</li><li>
603<p>
604Click on <span class="guibutton">OK</span>
605</p>
606<p>
607    </p><div class="figure"><a name="fig_xxx_0903" id="fig_xxx_0903"></a><p class="title"><b>Figure 40. Frame with five plot</b></p><div class="figure-contents">
608     
609      <div class="mediaobject"><img src="figpng/xxx_0903.png" alt="Frame with five plot" /></div>
610    </div></div><p><br class="figure-break" />
611</p>
612</li></ol></div>
613</div>
614</div>
615<div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="crash" id="crash"></a>4. What should I do when it breakdown</h2></div></div></div>
616
617<p>
618</p><div class="orderedlist"><ol type="1"><li>
619<p>
620In the IDL window type (as many time you click on a button since a problem occurs in xxx !!!),
621  </p><pre class="screen">
622<code class="prompt">idl&gt;</code> <strong class="userinput"><code>retall</code></strong>
623</pre><p>
624</p></li><li>
625<p>
626in the IDL window, type
627  </p><pre class="screen">
628<code class="prompt">idl&gt;</code> <strong class="userinput"><code>domdef</code></strong>
629</pre><p>
630</p></li><li>
631<p><abbr class="abbrev">DCR</abbr> to erase the problem frame.
632</p>
633</li><li><p>change the orientation of the plot by pressing Flag options -&gt; Portrait/Landscape. Cf <a href="#flagsubmenu" title="2.2.3. Flag options sub-menu">Section 2.2.3, “<span class="guisubmenu">Flag options</span> sub-menu”</a>
634</p></li><li><p>quit XXX cleanly using <span class="guisubmenu">quit</span> from the <span class="guibutton">File</span> menu. Cf <a href="#filesubmenu" title="2.2.1. File sub-menu">Section 2.2.1, “<span class="guibutton">File</span> sub-menu”</a>
635</p></li></ol></div><p>
636</p>
637<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
638<p>
639Always avoid if at all possible closing and killing the XXX
640window, but rather select <span class="guisubmenu">quit</span> from the <span class="guibutton">File</span> menu.
641XXX uses a large number of pointers, and want only killing the window will
642leave a large number of unused variables in memory, which could in the end
643overflow.
644To clean up this memory:
645  </p><pre class="screen">
646<code class="prompt">idl&gt;</code> <strong class="userinput"><code>ptr_free, ptr_valid()</code></strong>
647</pre><p>
648</p>
649</div>
650</div>
651</div>
652  </body>
653</html>
Note: See TracBrowser for help on using the repository browser.