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

Last change on this file since 209 was 194, checked in by pinsard, 18 years ago

add ENTITY hellip in xml files using it, necessary because I don't know yet how to handle entity with xmllint (2/2).
  • Property svn:keywords set to Id
File size: 52.0 KB
Line 
1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4<meta name="generator" content=
5"HTML Tidy for Mac OS X (vers 1 September 2005), see www.w3.org">
6<meta http-equiv="Content-Type" content=
7"text/html; charset=us-ascii">
8<title>Mini Guide for Basic Commands in the XXX Program</title>
9<link rel="stylesheet" href="style.css" type="text/css">
10<link rel="stylesheet" href="saxo.css" type="text/css">
11<meta name="generator" content="DocBook XSL Stylesheets V1.70.1">
12<meta name="keywords" content="IDL, SAXO, xxx">
13</head>
14<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
15alink="#0000FF">
16<div class="article" lang="en">
17<div class="titlepage">
18<div>
19<div>
20<h2 class="title"><a name="d0e2" id="d0e2"></a> Mini Guide for
21Basic Commands in the XXX Program</h2>
22</div>
23<div>
24<div class="authorgroup">
25<div class="author">
26<h3 class="author"><span class="firstname">S&eacute;bastien</span>
27<span class="surname">Masson</span> <code class=
28"email">&lt;<a href="mailto:Sebastien.Masson_at_locean-ipsl.upmc.fr">Sebastien.Masson_at_locean-ipsl.upmc.fr</a>&gt;</code></h3>
29</div>
30<div class="author">
31<h3 class="author"><span class="firstname">Albert</span>
32<span class="surname">Fisher</span></h3>
33</div>
34<div class="author">
35<h3 class="author"><span class="firstname">Fran&ccedil;oise</span>
36<span class="surname">Pinsard</span> <code class=
37"email">&lt;<a href=
38"mailto:Francoise.Pinsard_at_locean-ipsl.upmc.fr">Francoise.Pinsard_at_locean-ipsl.upmc.fr</a>&gt;</code></h3>
39</div>
40<div class="author">
41<h3 class="author"><span class="firstname">Steve</span>
42<span class="surname">Navarro</span></h3>
43</div>
44</div>
45</div>
46<div><span class="pubdate">svn Id of xml source file : $Id:
47mini_notice.xml 193 2006-09-22 10:13:30Z pinsard $<br>
48<br></span></div>
49<div>
50<div class="revhistory">
51<table border="1" width="100%" summary="Revision history">
52<tr>
53<th align="left" valign="top" colspan="2"><b>Revision
54History</b></th>
55</tr>
56<tr>
57<td align="left">Revision 0.0</td>
58<td align="left">May 29, 2000</td>
59</tr>
60<tr>
61<td align="left" colspan="2">French release by S&eacute;bastien
62Masson</td>
63</tr>
64<tr>
65<td align="left">Revision 0.1</td>
66<td align="left">July, 2002</td>
67</tr>
68<tr>
69<td align="left" colspan="2">Translation by Albert Fisher</td>
70</tr>
71<tr>
72<td align="left">Revision 0.2</td>
73<td align="left">July 20, 2006</td>
74</tr>
75<tr>
76<td align="left" colspan="2">HTML to XML/Docbook migration by
77Fran&ccedil;oise Pinsard</td>
78</tr>
79<tr>
80<td align="left">Revision 1.0</td>
81<td align="left">August, 2006</td>
82</tr>
83<tr>
84<td align="left" colspan="2">Major update by Steve Navarro</td>
85</tr>
86<tr>
87<td align="left">Revision 1.1</td>
88<td align="left">September, 2006</td>
89</tr>
90<tr>
91<td align="left" colspan="2">Review by S&eacute;bastien Masson</td>
92</tr>
93</table>
94</div>
95</div>
96</div>
97<hr></div>
98<div class="toc">
99<p><b>Table of Contents</b></p>
100<dl>
101<dt><span class="sect1"><a href="#launchxxx">1. Launching
102XXX</a></span></dt>
103<dd>
104<dl>
105<dt><span class="sect2"><a href="#launch_xxx_1">1.1. <code class=
106"prompt">idl&gt;</code> <strong class=
107"userinput"><code><span><strong class=
108"command">xxx</strong></span></code></strong></a></span></dt>
109<dt><span class="sect2"><a href="#launch_xxx_2">1.2. <code class=
110"prompt">idl&gt;</code> <strong class=
111"userinput"><code><span><strong class=
112"command">xxx</strong></span>, <em class=
113"parameter"><code>/separate</code></em></code></strong></a></span></dt>
114<dt><span class="sect2"><a href="#launch_xxx_3">1.3. <code class=
115"prompt">idl&gt;</code> <strong class=
116"userinput"><code><span><strong class=
117"command">xxx</strong></span>, <em class="parameter"><code>restore
118= 'file.dat'</code></em></code></strong></a></span></dt>
119<dt><span class="sect2"><a href="#launch_xxx_4">1.4. <code class=
120"prompt">idl&gt;</code> <strong class=
121"userinput"><code><span><strong class=
122"command">xxx</strong></span>, <em class=
123"parameter"><code>'file.nc'</code></em></code></strong></a></span></dt>
124<dt><span class="sect2"><a href="#launch_xxx_5">1.5. <code class=
125"prompt">idl&gt;</code> <strong class=
126"userinput"><code><span><strong class=
127"command">xxx</strong></span>, <em class=
128"parameter"><code>'file.nc'</code></em>, <em class=
129"parameter"><code>keywd1 = &hellip;</code></em>, <em class=
130"parameter"><code>keywd2 =
131&hellip;</code></em></code></strong></a></span></dt>
132<dt><span class="sect2"><a href="#launch_xxx_6">1.6. <code class=
133"prompt">idl&gt;</code> <strong class=
134"userinput"><code><span><strong class=
135"command">xxx</strong></span>, <em class=
136"parameter"><code>'file.nc'</code></em>, <em class=
137"parameter"><code>'initgrid'</code></em></code></strong></a></span></dt>
138<dt><span class="sect2"><a href="#launch_xxx_7">1.7. <code class=
139"prompt">idl&gt;</code> <strong class=
140"userinput"><code><span><strong class=
141"command">xxx</strong></span>, <em class=
142"parameter"><code>'file.nc'</code></em>, <em class=
143"parameter"><code>'initgrid'</code></em>, <em class=
144"parameter"><code>keywd1 = &hellip;</code></em>, <em class=
145"parameter"><code>keywd2 =
146&hellip;</code></em></code></strong></a></span></dt>
147<dt><span class="sect2"><a href="#launch_xxx_8">1.8. <code class=
148"prompt">idl&gt;</code> <strong class=
149"userinput"><code><span><strong class=
150"command">xxx</strong></span>, <em class=
151"parameter"><code>'file.nc'</code></em>, <em class=
152"parameter"><code>'initgrid'</code></em>, <em class=
153"parameter"><code>'arg1, arg2,
154&hellip;'</code></em></code></strong></a></span></dt>
155</dl>
156</dd>
157<dt><span class="sect1"><a href="#wigdets">2. Description of XXX
158window</a></span></dt>
159<dd>
160<dl>
161<dt><span class="sect2"><a href="#plottypetxt">2.1. Plot type
162list</a></span></dt>
163<dt><span class="sect2"><a href="#menutxt">2.2. The menu bar made
164up of 3 sub-menus</a></span></dt>
165<dt><span class="sect2"><a href="#oktxt">2.3. OK
166button</a></span></dt>
167<dt><span class="sect2"><a href="#pagelayouttxt">2.4. Page
168Layout</a></span></dt>
169<dt><span class="sect2"><a href="#variableslisttxt">2.5.
170<span class="guimenuitem">List of variables</span></a></span></dt>
171<dt><span class="sect2"><a href="#fileslisttxt">2.6. <span class=
172"guimenuitem">List of open files</span></a></span></dt>
173<dt><span class="sect2"><a href="#commandtexttxt">2.7. <span class=
174"guimenuitem">Command text</span></a></span></dt>
175<dt><span class="sect2"><a href="#calendartxt">2.8.
176Calendar</a></span></dt>
177<dt><span class="sect2"><a href="#domdeftxt">2.9. Define the
178domain</a></span></dt>
179<dt><span class="sect2"><a href="#specificationstxt">2.10. Specify
180your plot</a></span></dt>
181</dl>
182</dd>
183<dt><span class="sect1"><a href="#mouseactions">3. Mouse
184Actions</a></span></dt>
185<dd>
186<dl>
187<dt><span class="sect2"><a href="#mouse">3.1. In the graphics
188window on a horizontal plot</a></span></dt>
189<dt><span class="sect2"><a href="#multipleplots">3.2. Create
190multiple plots on the same sheet and make them
191interact</a></span></dt>
192</dl>
193</dd>
194<dt><span class="sect1"><a href="#crash">4. What should I do when
195it breakdown</a></span></dt>
196</dl>
197</div>
198<div class="sect1" lang="en">
199<div class="titlepage">
200<div>
201<div>
202<h2 class="title" style="clear: both"><a name="launchxxx" id=
203"launchxxx"></a>1.&nbsp;Launching XXX</h2>
204</div>
205</div>
206</div>
207<p>There is several ways to launch XXX which we will detail in the
208next sections:</p>
209<pre class="screen">
210    <code class="prompt">idl&gt;</code> <strong class=
211"userinput"><code><span><strong class=
212"command">xxx</strong></span></code></strong>
213    <code class="prompt">idl&gt;</code> <strong class=
214"userinput"><code><span><strong class=
215"command">xxx</strong></span>, <em class=
216"parameter"><code>/separate</code></em></code></strong>
217    <code class="prompt">idl&gt;</code> <strong class=
218"userinput"><code><span><strong class=
219"command">xxx</strong></span>, <em class=
220"parameter"><code>restore = 'file.dat'</code></em></code></strong>
221    <code class="prompt">idl&gt;</code> <strong class=
222"userinput"><code><span><strong class=
223"command">xxx</strong></span>, <em class=
224"parameter"><code>'file.nc'</code></em></code></strong>
225    <code class="prompt">idl&gt;</code> <strong class=
226"userinput"><code><span><strong class=
227"command">xxx</strong></span>, <em class=
228"parameter"><code>'file.nc'</code></em>, <em class=
229"parameter"><code>keywd1 = &hellip;</code></em>, <em class=
230"parameter"><code>keywd2 = &hellip;</code></em></code></strong>
231    <code class="prompt">idl&gt;</code> <strong class=
232"userinput"><code><span><strong class=
233"command">xxx</strong></span>, <em class=
234"parameter"><code>'file.nc'</code></em>, <em class=
235"parameter"><code>'initgrid'</code></em></code></strong>
236    <code class="prompt">idl&gt;</code> <strong class=
237"userinput"><code><span><strong class=
238"command">xxx</strong></span>, <em class=
239"parameter"><code>'file.nc'</code></em>, <em class=
240"parameter"><code>'initgrid'</code></em>, <em class=
241"parameter"><code>keywd1 = &hellip;</code></em>, <em class=
242"parameter"><code>keywd2 = &hellip;</code></em></code></strong>
243    <code class="prompt">idl&gt;</code> <strong class=
244"userinput"><code><span><strong class=
245"command">xxx</strong></span>, <em class=
246"parameter"><code>'file.nc'</code></em>, <em class=
247"parameter"><code>'initgrid'</code></em>, <em class=
248"parameter"><code>'arg1, arg2, &hellip;'</code></em></code></strong>
249 
250</pre>
251<div class="sect2" lang="en">
252<div class="titlepage">
253<div>
254<div>
255<h3 class="title"><a name="launch_xxx_1" id=
256"launch_xxx_1"></a>1.1.&nbsp;<code class="prompt">idl&gt;</code>
257<strong class="userinput"><code><span><strong class=
258"command">xxx</strong></span></code></strong></h3>
259</div>
260</div>
261</div>
262<p>A window will open with 3 parts to consider.</p>
263<div class="figure"><a name="fig_xxx_0101" id="fig_xxx_0101"></a>
264<p class="title"><b>Figure&nbsp;1.&nbsp;Window xxx 1</b></p>
265<div class="figure-contents">
266<div class="mediaobjectco"><img border="0" usemap="d0e204" src=
267"figpng/xxx_0101.png" alt="Window xxx 1"><map name="d0e204" id=
268"d0e204">
269<area shape="rect" coords="26,256,485,214">
270<area shape="rect" coords="78,208,433,157">
271<area shape="rect" coords="3,150,518,31"></map>
272<div class="calloutlist">
273<table border="0" summary="Callout list">
274<tr>
275<td width="5%" valign="top" align="left"><img src=
276"images/callouts/1.png" alt="1" border="0"></td>
277<td valign="top" align="left">
278<p>Data file name</p>
279</td>
280</tr>
281<tr>
282<td width="5%" valign="top" align="left"><img src=
283"images/callouts/2.png" alt="2" border="0"></td>
284<td valign="top" align="left">
285<p>Grid initialization method</p>
286</td>
287</tr>
288<tr>
289<td width="5%" valign="top" align="left"><img src=
290"images/callouts/3.png" alt="3" border="0"></td>
291<td valign="top" align="left">
292<p>Grid initialization parameters</p>
293</td>
294</tr>
295</table>
296</div>
297</div>
298</div>
299</div>
300<p><br class="figure-break"></p>
301<div class="sect3" lang="en">
302<div class="titlepage">
303<div>
304<div>
305<h4 class="title"><a name="datafiletxt" id=
306"datafiletxt"></a>1.1.1.&nbsp;Data file name</h4>
307</div>
308</div>
309</div>
310<p>The name of the data file. It can be typed directly in the
311window provided, or selected with the help of the <span class=
312"guibutton">browse</span> button.</p>
313</div>
314<div class="sect3" lang="en">
315<div class="titlepage">
316<div>
317<div>
318<h4 class="title"><a name="initmethodtxt" id=
319"initmethodtxt"></a>1.1.2.&nbsp;Grid initialization method</h4>
320</div>
321</div>
322</div>
323<p>For visualising grilled data, you need to <a href=
324"./firststeps.html#load_grid" target="_top">define the grid</a> on
325which are located the data. By default, "automatic grid
326construction with initncdf.pro" is checked. This means that the
327grid will be defined by using the informations contained in the
328data file (through the IDL prodecure <span><strong class=
329"command">initncdf</strong></span>) without needing any other
330auxillary file. If you checked "grid construction with other IDL
331batch or procedure", this means that you don't want to use the
332default <span><strong class="command">initncdf</strong></span>
333procedure to define the grid and you will provide your own IDL
334procedure or the so-called IDL batch file (a file which is called
335by using @, see IDL documentation).</p>
336</div>
337<div class="sect3" lang="en">
338<div class="titlepage">
339<div>
340<div>
341<h4 class="title"><a name="initprogramtxt" id=
342"initprogramtxt"></a>1.1.3.&nbsp;Grid initialization
343parameters</h4>
344</div>
345</div>
346</div>
347<p>This third part allows you to specify the name, the argument and
348the keywords of the routine you want to use to initialize the grid.
349By default the name of the procedure is <span><strong class=
350"command">initncdf</strong></span>, its argument will be
351automatically defined so you cannot change them. If you If you
352checked "grid construction with other IDL batch or procedure", you
353have to select the name of the IDL procedure or batch file and its
354suitable arguments and keywords. Note that if you select an IDL
355batch file you cannot give any parameter or keyword.</p>
356<div class="figure"><a name="fig_xxx_0102" id="fig_xxx_0102"></a>
357<p class="title"><b>Figure&nbsp;2.&nbsp;Window xxx 1</b></p>
358<div class="figure-contents">
359<div class="mediaobjectco"><img border="0" usemap="d0e258" src=
360"figpng/xxx_0102.png" alt="Window xxx 1"><map name="d0e258" id=
361"d0e258"></map></div>
362</div>
363</div>
364<p><br class="figure-break"></p>
365<p>Once these two lines have been completed, click on <span class=
366"guibutton">let's go</span>.</p>
367<p>For example, we choose the IDL batch file "tst_initlev". Compare
368the result with "automatic grid construction with initncdf.pro"
369checked. Cf <a href="#fig_xxx_0404" title=
370"Figure&nbsp;18.&nbsp;temperature of the ocean at depth 125 meters without proper land/sea mask">
371Figure&nbsp;18, &ldquo;temperature of the ocean at depth 125 meters
372without proper land/sea mask&rdquo;</a></p>
373<div class="figure"><a name="fig_xxx_0103" id="fig_xxx_0103"></a>
374<p class="title"><b>Figure&nbsp;3.&nbsp;Oceania at 125 meters of
375depth with proper grid initialization</b></p>
376<div class="figure-contents"><img src="figpng/xxx_0103.png" alt=
377"Oceania at 125 meters of depth with proper grid initialization"></div>
378</div>
379<p><br class="figure-break"></p>
380</div>
381</div>
382<div class="sect2" lang="en">
383<div class="titlepage">
384<div>
385<div>
386<h3 class="title"><a name="launch_xxx_2" id=
387"launch_xxx_2"></a>1.2.&nbsp;<code class="prompt">idl&gt;</code>
388<strong class="userinput"><code><span><strong class=
389"command">xxx</strong></span>, <em class=
390"parameter"><code>/separate</code></em></code></strong></h3>
391</div>
392</div>
393</div>
394<p>This is the same as the simple <a href="#launch_xxx_1" title=
395"1.1.&nbsp;idl&gt; xxx"><code class="prompt">idl&gt;</code>
396<strong class="userinput"><code><span><strong class=
397"command">xxx</strong></span></code></strong></a> except that once
398the xxx window open, you will have 2 separate windows (command and
399plotting window) instead of one.</p>
400</div>
401<div class="sect2" lang="en">
402<div class="titlepage">
403<div>
404<div>
405<h3 class="title"><a name="launch_xxx_3" id=
406"launch_xxx_3"></a>1.3.&nbsp;<code class="prompt">idl&gt;</code>
407<strong class="userinput"><code><span><strong class=
408"command">xxx</strong></span>, <em class="parameter"><code>restore
409= 'file.dat'</code></em></code></strong></h3>
410</div>
411</div>
412</div>
413<p>In that case xxx window will open directly in the same state as
414it was when the file "file.dat" was created. see <a href=
415"#restore">+++++++</a></p>
416</div>
417<div class="sect2" lang="en">
418<div class="titlepage">
419<div>
420<div>
421<h3 class="title"><a name="launch_xxx_4" id=
422"launch_xxx_4"></a>1.4.&nbsp;<code class="prompt">idl&gt;</code>
423<strong class="userinput"><code><span><strong class=
424"command">xxx</strong></span>, <em class=
425"parameter"><code>'file.nc'</code></em></code></strong></h3>
426</div>
427</div>
428</div>
429<p>In this case, the xxx window directly open the data file
430'file.nc' and build the grid automatically with the IDL procedure
431<span><strong class="command">initncdf</strong></span>. For
432example:</p>
433<pre class="screen">
434    <code class="prompt">idl&gt;</code> <strong class=
435"userinput"><code><span><strong class=
436"command">xxx</strong></span>, <em class=
437"parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_1x1.nc'</code></em></code></strong>
438 
439</pre></div>
440<div class="sect2" lang="en">
441<div class="titlepage">
442<div>
443<div>
444<h3 class="title"><a name="launch_xxx_5" id=
445"launch_xxx_5"></a>1.5.&nbsp;<code class="prompt">idl&gt;</code>
446<strong class="userinput"><code><span><strong class=
447"command">xxx</strong></span>, <em class=
448"parameter"><code>'file.nc'</code></em>, <em class=
449"parameter"><code>keywd1 = &hellip;</code></em>, <em class=
450"parameter"><code>keywd2 =
451&hellip;</code></em></code></strong></h3>
452</div>
453</div>
454</div>
455<p>In this case, the xxx window directly open the data file
456'file.nc', build the grid automatically with the IDL procedure
457<span><strong class="command">initncdf</strong></span> and use the
458keywords <strong class="userinput"><code><em class=
459"parameter"><code>keywd1 = &hellip;</code></em>, <em class=
460"parameter"><code>keywd2 = &hellip;</code></em></code></strong> in
461the call of <span><strong class="command">initncdf</strong></span>.
462For example:</p>
463<pre class="screen">
464    <code class="prompt">idl&gt;</code> <strong class=
465"userinput"><code><span><strong class=
466"command">xxx</strong></span>, <em class=
467"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>
468 
469</pre></div>
470<div class="sect2" lang="en">
471<div class="titlepage">
472<div>
473<div>
474<h3 class="title"><a name="launch_xxx_6" id=
475"launch_xxx_6"></a>1.6.&nbsp;<code class="prompt">idl&gt;</code>
476<strong class="userinput"><code><span><strong class=
477"command">xxx</strong></span>, <em class=
478"parameter"><code>'file.nc'</code></em>, <em class=
479"parameter"><code>'initgrid'</code></em></code></strong></h3>
480</div>
481</div>
482</div>
483<p>In this case, the xxx window directly open the data file
484'file.nc' and build the grid directly with the IDL procedure or
485batch file <span><strong class=
486"command">initgrid</strong></span></p>
487<pre class="screen">
488    <code class="prompt">idl&gt;</code> <strong class=
489"userinput"><code><span><strong class=
490"command">xxx</strong></span>, <em class=
491"parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc'</code></em>, <em class="parameter"><code>'tst_initorca2'</code></em></code></strong>
492 
493</pre></div>
494<div class="sect2" lang="en">
495<div class="titlepage">
496<div>
497<div>
498<h3 class="title"><a name="launch_xxx_7" id=
499"launch_xxx_7"></a>1.7.&nbsp;<code class="prompt">idl&gt;</code>
500<strong class="userinput"><code><span><strong class=
501"command">xxx</strong></span>, <em class=
502"parameter"><code>'file.nc'</code></em>, <em class=
503"parameter"><code>'initgrid'</code></em>, <em class=
504"parameter"><code>keywd1 = &hellip;</code></em>, <em class=
505"parameter"><code>keywd2 =
506&hellip;</code></em></code></strong></h3>
507</div>
508</div>
509</div>
510<p>In this case, the xxx window directly open the data file
511'file.nc', build the grid directly with the IDL procedure
512<span><strong class="command">initgrid</strong></span> and use the
513keywords <strong class="userinput"><code><em class=
514"parameter"><code>keywd1 = &hellip;</code></em>, <em class=
515"parameter"><code>keywd2 = &hellip;</code></em></code></strong> in
516the call of <span><strong class=
517"command">initgrid</strong></span>.</p>
518</div>
519<div class="sect2" lang="en">
520<div class="titlepage">
521<div>
522<div>
523<h3 class="title"><a name="launch_xxx_8" id=
524"launch_xxx_8"></a>1.8.&nbsp;<code class="prompt">idl&gt;</code>
525<strong class="userinput"><code><span><strong class=
526"command">xxx</strong></span>, <em class=
527"parameter"><code>'file.nc'</code></em>, <em class=
528"parameter"><code>'initgrid'</code></em>, <em class=
529"parameter"><code>'arg1, arg2,
530&hellip;'</code></em></code></strong></h3>
531</div>
532</div>
533</div>
534<p>In this case, the xxx window directly open the data file
535'file.nc', build the grid directly with the IDL procedure
536<span><strong class="command">initgrid</strong></span> and use the
537string <strong class="userinput"><code><em class=
538"parameter"><code>'arg1, arg2,
539&hellip;'</code></em></code></strong> to specify the input
540arguments in the call of <span><strong class=
541"command">initgrid</strong></span>.</p>
542</div>
543</div>
544<div class="sect1" lang="en">
545<div class="titlepage">
546<div>
547<div>
548<h2 class="title" style="clear: both"><a name="wigdets" id=
549"wigdets"></a>2.&nbsp;Description of XXX window</h2>
550</div>
551</div>
552</div>
553<div class="figure"><a name="fig_xxx_0201" id="fig_xxx_0201"></a>
554<p class="title"><b>Figure&nbsp;4.&nbsp;Window xxx 2</b></p>
555<div class="figure-contents">
556<div class="mediaobjectco"><img border="0" usemap="d0e506" src=
557"figpng/xxx_0201.png" alt="Window xxx 2"><map name="d0e506" id=
558"d0e506">
559<area shape="rect" coords="3,606,97,579">
560<area shape="rect" coords="108,606,325,577">
561<area shape="rect" coords="5,571,44,544">
562<area shape="rect" coords="70,571,193,544">
563<area shape="rect" coords="209,570,323,545">
564<area shape="rect" coords="2,535,344,513">
565<area shape="rect" coords="2,504,346,470">
566<area shape="rect" coords="2,461,212,414">
567<area shape="rect" coords="16,403,308,183">
568<area shape="rect" coords="1,172,345,50"></map>
569<div class="calloutlist">
570<table border="0" summary="Callout list">
571<tr>
572<td width="5%" valign="top" align="left"><img src=
573"images/callouts/1.png" alt="1" border="0"></td>
574<td valign="top" align="left">
575<p>Plot type</p>
576</td>
577</tr>
578<tr>
579<td width="5%" valign="top" align="left"><img src=
580"images/callouts/2.png" alt="2" border="0"></td>
581<td valign="top" align="left">
582<p>Menu</p>
583</td>
584</tr>
585<tr>
586<td width="5%" valign="top" align="left"><img src=
587"images/callouts/3.png" alt="3" border="0"></td>
588<td valign="top" align="left">
589<p>OK</p>
590</td>
591</tr>
592<tr>
593<td width="5%" valign="top" align="left"><img src=
594"images/callouts/4.png" alt="4" border="0"></td>
595<td valign="top" align="left">
596<p>Page layout</p>
597</td>
598</tr>
599<tr>
600<td width="5%" valign="top" align="left"><img src=
601"images/callouts/5.png" alt="5" border="0"></td>
602<td valign="top" align="left">
603<p>Variables list</p>
604</td>
605</tr>
606<tr>
607<td width="5%" valign="top" align="left"><img src=
608"images/callouts/6.png" alt="6" border="0"></td>
609<td valign="top" align="left">
610<p>Files list</p>
611</td>
612</tr>
613<tr>
614<td width="5%" valign="top" align="left"><img src=
615"images/callouts/7.png" alt="7" border="0"></td>
616<td valign="top" align="left">
617<p>Command text</p>
618</td>
619</tr>
620<tr>
621<td width="5%" valign="top" align="left"><img src=
622"images/callouts/8.png" alt="8" border="0"></td>
623<td valign="top" align="left">
624<p>Calendar</p>
625</td>
626</tr>
627<tr>
628<td width="5%" valign="top" align="left"><img src=
629"images/callouts/9.png" alt="9" border="0"></td>
630<td valign="top" align="left">
631<p>Domdef</p>
632</td>
633</tr>
634<tr>
635<td width="5%" valign="top" align="left"><img src=
636"images/callouts/10.png" alt="10" border="0"></td>
637<td valign="top" align="left">
638<p>Spefications</p>
639</td>
640</tr>
641</table>
642</div>
643</div>
644</div>
645</div>
646<p><br class="figure-break"></p>
647<div class="sect2" lang="en">
648<div class="titlepage">
649<div>
650<div>
651<h3 class="title"><a name="plottypetxt" id=
652"plottypetxt"></a>2.1.&nbsp;Plot type list</h3>
653</div>
654</div>
655</div>
656<p>Allows specification of the type of plot desired.</p>
657<div class="figure"><a name="fig_xxx_0202" id="fig_xxx_0202"></a>
658<p class="title"><b>Figure&nbsp;5.&nbsp;Different plot types
659available</b></p>
660<div class="figure-contents"><img src="figpng/xxx_0202.png" alt=
661"Different plot types available"></div>
662</div>
663<p><br class="figure-break"></p>
664<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
665<h3 class="title">Note</h3>
666<p>If the type <code class="constant">plt</code> is selected, the
667selection of plot type is made by mouse. Cf <a href="#mouse" title=
668"3.1.&nbsp;In the graphics window on a horizontal plot">Section&nbsp;3.1,
669&ldquo;In the graphics window on a horizontal plot&rdquo;</a></p>
670</div>
671</div>
672<div class="sect2" lang="en">
673<div class="titlepage">
674<div>
675<div>
676<h3 class="title"><a name="menutxt" id="menutxt"></a>2.2.&nbsp;The
677menu bar made up of 3 sub-menus</h3>
678</div>
679</div>
680</div>
681<div class="sect3" lang="en">
682<div class="titlepage">
683<div>
684<div>
685<h4 class="title"><a name="filesubmenu" id=
686"filesubmenu"></a>2.2.1.&nbsp;<span class="guisubmenu">File</span>
687sub-menu</h4>
688</div>
689</div>
690</div>
691<div class="figure"><a name="fig_xxx_0203" id="fig_xxx_0203"></a>
692<p class="title"><b>Figure&nbsp;6.&nbsp;The File menu</b></p>
693<div class="figure-contents"><img src="figpng/xxx_0203.png" alt=
694"The File menu"></div>
695</div>
696<p><br class="figure-break"></p>
697<div class="itemizedlist">
698<ul type="disc">
699<li>
700<p><span class="guibutton">Open:</span> to open a new file. Same
701procedure as during the <a href="#launch_xxx_1" title=
702"1.1.&nbsp;idl&gt; xxx">launch of XXX</a>. The new file can be on a
703different grid, with different variables, with a different time
704base &hellip;</p>
705</li>
706<li>
707<p><span class="guibutton">New XXX:</span> to open a second XXX
708window identical to the first one.</p>
709</li>
710<li>
711<p><span class="guibutton">Quit:</span> to close the XXX
712window.</p>
713</li>
714</ul>
715</div>
716</div>
717<div class="sect3" lang="en">
718<div class="titlepage">
719<div>
720<div>
721<h4 class="title"><a name="saveassubmenu" id=
722"saveassubmenu"></a>2.2.2.&nbsp;<span class="guisubmenu">Save
723As</span> sub-menu</h4>
724</div>
725</div>
726</div>
727<div class="figure"><a name="fig_xxx_0204" id="fig_xxx_0204"></a>
728<p class="title"><b>Figure&nbsp;7.&nbsp;The Save As menu</b></p>
729<div class="figure-contents"><img src="figpng/xxx_0204.png" alt=
730"The Save As menu"></div>
731</div>
732<p><br class="figure-break"></p>
733<div class="itemizedlist">
734<ul type="disc">
735<li>
736<p><span class="guibutton">Postscript:</span> to save the plotting
737window in Postscript format</p>
738</li>
739<li>
740<p><span class="guibutton">Animated gif:</span> to create an
741animation of the plotting window.</p>
742<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
743<h3 class="title">Note</h3>
744<p>The creation of an animation is only possible if none of the
745plots have a time axis, and if the plots are all on the same time
746base (calendar). On the other hand, animations of horizontal and
747vertical plots, with different color palettes (for those not on an
748X-terminal), are possible.</p>
749</div>
750<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
751<h3 class="title">Note</h3>
752<p>The creation of animations has a tendency to saturate the video
753memory of X-terminals, crashing the entire program &hellip;</p>
754</div>
755</li>
756<li>
757<p><span class="guibutton">Gif:</span> to save a gif of the
758plotting window.</p>
759</li>
760<li>
761<p><span class="guibutton">IDL procedure:</span> to save the
762command history that has created the plot in an IDL procedure that
763can be re-executed later. For example if I save the commands in
764<code class="filename">xxx_figure.pro</code> file, when ever I
765want, I can then launch a new IDL session and type:</p>
766<pre class="screen">
767<code class="prompt">idl&gt;</code> <strong class=
768"userinput"><code>@init</code></strong>
769<code class="prompt">idl&gt;</code> <strong class=
770"userinput"><code>xxx_figure</code></strong>
771</pre>
772<p>and I'll obtain the saved figure.</p>
773<pre class="screen">
774<code class="prompt">idl&gt;</code> <strong class=
775"userinput"><code>xxx_figure,/post</code></strong>
776</pre>
777<p>or</p>
778<pre class="screen">
779<code class="prompt">idl&gt;</code> <strong class=
780"userinput"><code>@ps</code></strong>
781</pre>
782<p>will then create a Postscript file of the figure.</p>
783</li>
784<li>
785<p><a name="restore" id="restore"></a><span class=
786"guibutton">RESTORE kwd of xxx:</span> to save the xxx widget (all
787buttons and parameters stored in memory &hellip;) in a binary file
788in order to quit xxx and relaunch it later with <a href=
789"#launch_xxx_3" title=
790"1.3.&nbsp;idl&gt; xxx, restore = 'file.dat'"><code class=
791"prompt">idl&gt;</code> <strong class=
792"userinput"><code><span><strong class=
793"command">xxx</strong></span>, <em class="parameter"><code>restore
794= 'file.dat'</code></em></code></strong></a> and get exactly the
795same configuration.</p>
796</li>
797<li>
798<p><span class="guibutton">Print to prompt:</span> lists in the IDL
799window the command history that created the last plot. Useful
800primarily for debugging&hellip;</p>
801</li>
802</ul>
803</div>
804</div>
805<div class="sect3" lang="en">
806<div class="titlepage">
807<div>
808<div>
809<h4 class="title"><a name="flagsubmenu" id=
810"flagsubmenu"></a>2.2.3.&nbsp;<span class="guisubmenu">Flag
811options</span> sub-menu</h4>
812</div>
813</div>
814</div>
815<div class="figure"><a name="fig_xxx_0205" id="fig_xxx_0205"></a>
816<p class="title"><b>Figure&nbsp;8.&nbsp;The Flag Option
817menu</b></p>
818<div class="figure-contents"><img src="figpng/xxx_0205.png" alt=
819"The Flag Option menu"></div>
820</div>
821<p><br class="figure-break"></p>
822<div class="itemizedlist">
823<ul type="disc">
824<li>
825<p><span class="guibutton">Portrait/Landscape:</span> changes the
826configuration of the plot.</p>
827</li>
828<li>
829<p><span class="guibutton">Overlay:</span> to plot contours of a
830different field on top the one represented as color-filled
831contours. It is necessary to relaunch the entire plot to make this
832work!</p>
833</li>
834<li>
835<p><span class="guibutton">Vecteur:</span> to plot a vector field
836on top of contours. Only works on horizontal plots (<code class=
837"filename">plt.pro</code>). As for Overlay, a relaunch of the
838entire plot is necessary.</p>
839</li>
840<li>
841<p><span class="guibutton">Longitude / x index:</span> switches
842longitude labeling of the plot sub-domain from degrees to indexes
843following i.</p>
844</li>
845<li>
846<p><span class="guibutton">Latitude / y index:</span> switches
847latitude labeling of the plot sub-domain from degrees to indexes
848following j.</p>
849</li>
850</ul>
851</div>
852<div class="caution" style=
853"margin-left: 0.5in; margin-right: 0.5in;">
854<h3 class="title">Caution</h3>
855<p>Careful, a selected option remains selected until it is
856re-clicked.</p>
857</div>
858</div>
859</div>
860<div class="sect2" lang="en">
861<div class="titlepage">
862<div>
863<div>
864<h3 class="title"><a name="oktxt" id="oktxt"></a>2.3.&nbsp;OK
865button</h3>
866</div>
867</div>
868</div>
869<p>Click on this <span class="guibutton">OK</span> button is
870required to make a new plot appear</p>
871</div>
872<div class="sect2" lang="en">
873<div class="titlepage">
874<div>
875<div>
876<h3 class="title"><a name="pagelayouttxt" id=
877"pagelayouttxt"></a>2.4.&nbsp;Page Layout</h3>
878</div>
879</div>
880</div>
881<p>Specify the number of columns and rows for plots on the sheet of
882paper.</p>
883<div class="figure"><a name="fig_xxx_0206" id="fig_xxx_0206"></a>
884<p class="title"><b>Figure&nbsp;9.&nbsp;Number of Column</b></p>
885<div class="figure-contents"><img src="figpng/xxx_0206.png" alt=
886"Number of Column"></div>
887</div>
888<p><br class="figure-break"></p>
889<div class="figure"><a name="fig_xxx_0206a" id="fig_xxx_0206a"></a>
890<p class="title"><b>Figure&nbsp;10.&nbsp;Example: For 2 columns and
8912 rows</b></p>
892<div class="figure-contents"><img src="figpng/xxx_0206a.png" alt=
893"Example: For 2 columns and 2 rows"></div>
894</div>
895<p><br class="figure-break"></p>
896</div>
897<div class="sect2" lang="en">
898<div class="titlepage">
899<div>
900<div>
901<h3 class="title"><a name="variableslisttxt" id=
902"variableslisttxt"></a>2.5.&nbsp;<span class="guimenuitem">List of
903variables</span></h3>
904</div>
905</div>
906</div>
907<p>You can choose the variable to work on.</p>
908<div class="figure"><a name="fig_xxx_0207" id="fig_xxx_0207"></a>
909<p class="title"><b>Figure&nbsp;11.&nbsp;Example of different
910Variables available</b></p>
911<div class="figure-contents"><img src="figpng/xxx_0207.png" alt=
912"Example of different Variables available"></div>
913</div>
914<p><br class="figure-break"></p>
915</div>
916<div class="sect2" lang="en">
917<div class="titlepage">
918<div>
919<div>
920<h3 class="title"><a name="fileslisttxt" id=
921"fileslisttxt"></a>2.6.&nbsp;<span class="guimenuitem">List of open
922files</span></h3>
923</div>
924</div>
925</div>
926<p>You can choose the file to work on.</p>
927<div class="figure"><a name="fig_xxx_0208" id="fig_xxx_0208"></a>
928<p class="title"><b>Figure&nbsp;12.&nbsp;Example of list of open
929files</b></p>
930<div class="figure-contents"><img src="figpng/xxx_0208.png" alt=
931"Example of list of open files"></div>
932</div>
933<p><br class="figure-break"></p>
934</div>
935<div class="sect2" lang="en">
936<div class="titlepage">
937<div>
938<div>
939<h3 class="title"><a name="commandtexttxt" id=
940"commandtexttxt"></a>2.7.&nbsp;<span class="guimenuitem">Command
941text</span></h3>
942</div>
943</div>
944</div>
945<p>To specify in the widget part number 7 the computation you want
946to do on the data</p>
947<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
948<h3 class="title">Note</h3>
949<p>In all cases bellow, the name given to a field (a, b, c,
950&hellip;) is of no importance.</p>
951</div>
952<div class="sect3" lang="en">
953<div class="titlepage">
954<div>
955<div>
956<h4 class="title"><a name="commandtext1" id=
957"commandtext1"></a>2.7.1.&nbsp;<span class="guimenuitem">Linear
958calculation</span></h4>
959</div>
960</div>
961</div>
962<p>If you want to make basic linear computation (like difference
963between fields, add/multiply by a constant &hellip;). you can
964simply put the following commands:</p>
965<pre class="screen">
966a - b
967</pre>
968<pre class="screen">
969numb1*a
970</pre>
971<pre class="screen">
972a + numb
973</pre>
974<p>or any command with the following format</p>
975<pre class="screen">
976numb1*a + numb2*b  + numb3*c &hellip; + numb
977</pre>
978<p>where numb1, numb2, &hellip; correspond to numbers and a, b, c
979&hellip; will be the data to read.</p>
980</div>
981<div class="sect3" lang="en">
982<div class="titlepage">
983<div>
984<div>
985<h4 class="title"><a name="commandtext1" id=
986"commandtext1"></a>2.7.2.&nbsp;<span class="guimenuitem">Any kind
987of computation</span></h4>
988</div>
989</div>
990</div>
991<p>If you want to make a computation more complicated than a basic
992linear you must put designate the data you want to read between
993<span><strong class="keycap">"</strong></span><span><strong class=
994"keycap">"</strong></span> (with anything in between the "). For
995example:</p>
996<pre class="screen">
997"a"^2
998</pre>
999<pre class="screen">
1000"a" - abs("b")
1001</pre>
1002<pre class="screen">
1003grad("a", 'x')
1004</pre>
1005<p>&hellip;</p>
1006</div>
1007</div>
1008<div class="sect2" lang="en">
1009<div class="titlepage">
1010<div>
1011<div>
1012<h3 class="title"><a name="calendartxt" id=
1013"calendartxt"></a>2.8.&nbsp;Calendar</h3>
1014</div>
1015</div>
1016</div>
1017<p>The calendar is made up of two drop-lists, which allow
1018specification of two dates, the beginning and end of a time series,
1019or the period over which to average before plotting.</p>
1020<div class="figure"><a name="fig_xxx_0301" id="fig_xxx_0301"></a>
1021<p class="title"><b>Figure&nbsp;13.&nbsp;Example: first plot in
1022January, second plot is from January to December</b></p>
1023<div class="figure-contents"><img src="figpng/xxx_0301.png" alt=
1024"Example: first plot in January, second plot is from January to December"></div>
1025</div>
1026<p><br class="figure-break"></p>
1027</div>
1028<div class="sect2" lang="en">
1029<div class="titlepage">
1030<div>
1031<div>
1032<h3 class="title"><a name="domdeftxt" id=
1033"domdeftxt"></a>2.9.&nbsp;Define the domain</h3>
1034</div>
1035</div>
1036</div>
1037<p>A series of widgets that allow specification of the min/max
1038limits of the domain in longitude/x-index, latitude/y-index, and
1039depth in levels or meters.</p>
1040<div class="figure"><a name="fig_xxx_0210" id="fig_xxx_0210"></a>
1041<p class="title"><b>Figure&nbsp;14.&nbsp;Domain by default</b></p>
1042<div class="figure-contents"><img src="figpng/xxx_0210.png" alt=
1043"Domain by default"></div>
1044</div>
1045<p><br class="figure-break"></p>
1046<div class="figure"><a name="fig_xxx_0401" id="fig_xxx_0401"></a>
1047<p class="title"><b>Figure&nbsp;15.&nbsp;Change Domain area: zoom
1048on Oceania</b></p>
1049<div class="figure-contents"><img src="figpng/xxx_0401.png" alt=
1050"Change Domain area: zoom on Oceania"></div>
1051</div>
1052<p><br class="figure-break"></p>
1053<div class="figure"><a name="fig_xxx_0402" id="fig_xxx_0402"></a>
1054<p class="title"><b>Figure&nbsp;16.&nbsp;This configuration give
1055us:</b></p>
1056<div class="figure-contents"><img src="figpng/xxx_0402.png" alt=
1057"This configuration give us:"></div>
1058</div>
1059<p><br class="figure-break"></p>
1060<div class="figure"><a name="fig_xxx_0403" id="fig_xxx_0403"></a>
1061<p class="title"><b>Figure&nbsp;17.&nbsp;Change depth area: between
1062depth 125 and 126</b></p>
1063<div class="figure-contents"><img src="figpng/xxx_0403.png" alt=
1064"Change depth area: between depth 125 and 126"></div>
1065</div>
1066<p><br class="figure-break"></p>
1067<div class="figure"><a name="fig_xxx_0404" id="fig_xxx_0404"></a>
1068<p class="title"><b>Figure&nbsp;18.&nbsp;temperature of the ocean
1069at depth 125 meters without proper land/sea mask</b></p>
1070<div class="figure-contents"><img src="figpng/xxx_0404.png" alt=
1071"temperature of the ocean at depth 125 meters without proper land/sea mask"></div>
1072</div>
1073<p><br class="figure-break">
1074As you can see, at this depth, we better define a land/sea mask
1075when loading the grid. Cf <a href="#fig_xxx_0103" title=
1076"Figure&nbsp;3.&nbsp;Oceania at 125 meters of depth with proper grid initialization">
1077Figure&nbsp;3, &ldquo;Oceania at 125 meters of depth with proper
1078grid initialization&rdquo;</a></p>
1079</div>
1080<div class="sect2" lang="en">
1081<div class="titlepage">
1082<div>
1083<div>
1084<h3 class="title"><a name="specificationstxt" id=
1085"specificationstxt"></a>2.10.&nbsp;Specify your plot</h3>
1086</div>
1087</div>
1088</div>
1089<div class="sect3" lang="en">
1090<div class="titlepage">
1091<div>
1092<div>
1093<h4 class="title"><a name="minmaxintervaltxt" id=
1094"minmaxintervaltxt"></a>2.10.1.&nbsp;<span class=
1095"guimenuitem">Specify min, max and contour interval</span></h4>
1096</div>
1097</div>
1098</div>
1099<div class="figure"><a name="fig_xxx_0501" id="fig_xxx_0501"></a>
1100<p class="title"><b>Figure&nbsp;19.&nbsp;min, max, and contour
1101interval specifications</b></p>
1102<div class="figure-contents"><img src="figpng/xxx_0501.png" alt=
1103"min, max, and contour interval specifications"></div>
1104</div>
1105<p><br class="figure-break">
1106You can restore configuration by default by pressing the
1107<span class="guibutton">Default</span> button.</p>
1108<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
1109<h3 class="title">Note</h3>
1110<p>The path of the file <a href=
1111"../../ToBeReviewed/WIDGET/AUTOUR_de_XXX/definedefaultextra.pro"
1112target="_top"><code class=
1113"filename">definedefaultextra.pro</code></a> that defines the
1114default values for each variable names is displayed when the cursor
1115hovers over the button <span class="guibutton">Default</span>. This
1116file contains a case statement based on the name of the variable
1117and defining the min, max, contour interval and other keywords that
1118should be used as default for the specified variable. You can copy
1119this file in your own <code class="filename"><code class=
1120"envar">${HOME}</code>/My_IDL/</code> directory and easily modify
1121it to suit your favorite default values.</p>
1122</div>
1123</div>
1124<div class="sect3" lang="en">
1125<div class="titlepage">
1126<div>
1127<div>
1128<h4 class="title"><a name="colortxt" id=
1129"colortxt"></a>2.10.2.&nbsp;<span class="guimenuitem">Specify the
1130palette to be used</span></h4>
1131</div>
1132</div>
1133</div>
1134<p>For the color palette, you can either specify the name or go
1135search for one among the palettes available.</p>
1136<div class="figure"><a name="fig_xxx_0502" id="fig_xxx_0502"></a>
1137<p class="title"><b>Figure&nbsp;20.&nbsp;The Color menu</b></p>
1138<div class="figure-contents"><img src="figpng/xxx_0502.png" alt=
1139"The Color menu"></div>
1140</div>
1141<p><br class="figure-break"></p>
1142</div>
1143<div class="sect3" lang="en">
1144<div class="titlepage">
1145<div>
1146<div>
1147<h4 class="title"><a name="kwdtxt" id=
1148"kwdtxt"></a>2.10.3.&nbsp;<span class="guimenuitem">Add any
1149keyword</span></h4>
1150</div>
1151</div>
1152</div>
1153<p>The &ldquo;<span class="quote">keywords</span>&rdquo; window
1154allows specification of all desired keywords. There is a few
1155examples of the use of this &ldquo;<span class=
1156"quote">keywords</span>&rdquo; window.</p>
1157<div class="figure"><a name="fig_xxx_0209" id="fig_xxx_0209"></a>
1158<p class="title"><b>Figure&nbsp;21.&nbsp;Without any additional
1159keyword</b></p>
1160<div class="figure-contents"><img src="figpng/xxx_0209.png" alt=
1161"Without any additional keyword"></div>
1162</div>
1163<p><br class="figure-break"></p>
1164<div class="figure"><a name="fig_xxx_0210a" id="fig_xxx_0210a"></a>
1165<p class="title"><b>Figure&nbsp;22.&nbsp;Add <code class=
1166"varname">/realcont</code> keyword</b></p>
1167<div class="figure-contents"><img src="figpng/xxx_0210a.png" alt=
1168"Add /realcont keyword"></div>
1169</div>
1170<p><br class="figure-break"></p>
1171<div class="figure"><a name="fig_xxx_0210" id="fig_xxx_0210"></a>
1172<p class="title"><b>Figure&nbsp;23.&nbsp;Graphic with <code class=
1173"varname">/realcont</code> keyword</b></p>
1174<div class="figure-contents"><img src="figpng/xxx_0210.png" alt=
1175"Graphic with /realcont keyword"></div>
1176</div>
1177<p><br class="figure-break"></p>
1178<div class="figure"><a name="fig_xxx_0211a" id="fig_xxx_0211a"></a>
1179<p class="title"><b>Figure&nbsp;24.&nbsp;Add <code class=
1180"userinput">/realcont, map=[90,0,0], /ortho, cell_fill=2</code>
1181keywords</b></p>
1182<div class="figure-contents"><img src="figpng/xxx_0211a.png" alt=
1183"Add /realcont, map=[90,0,0], /ortho, cell_fill=2 keywords"></div>
1184</div>
1185<p><br class="figure-break"></p>
1186<div class="figure"><a name="fig_xxx_0211" id="fig_xxx_0211"></a>
1187<p class="title"><b>Figure&nbsp;25.&nbsp;Graphic with <code class=
1188"literal">/realcont, map=[90,0,0], /ortho, cell_fill=2</code>
1189keywords</b></p>
1190<div class="figure-contents"><img src="figpng/xxx_0211.png" alt=
1191"Graphic with /realcont, map=[90,0,0], /ortho, cell_fill=2 keywords"></div>
1192</div>
1193<p><br class="figure-break"></p>
1194</div>
1195</div>
1196</div>
1197<div class="sect1" lang="en">
1198<div class="titlepage">
1199<div>
1200<div>
1201<h2 class="title" style="clear: both"><a name="mouseactions" id=
1202"mouseactions"></a>3.&nbsp;Mouse Actions</h2>
1203</div>
1204</div>
1205</div>
1206<div class="sect2" lang="en">
1207<div class="titlepage">
1208<div>
1209<div>
1210<h3 class="title"><a name="mouse" id="mouse"></a>3.1.&nbsp;In the
1211graphics window on a horizontal plot</h3>
1212</div>
1213</div>
1214</div>
1215<p>Select a domain and select the horizontal plot (<code class=
1216"constant">plt</code>), vertical plot (<code class=
1217"constant">pltz</code>), or the hovmoeller plot (<code class=
1218"constant">pltt</code>):</p>
1219<p>The domain we'd like to select for the plot is determined by one
1220of its diagonals, defined therefore by two points. The first point
1221is defined when the mouse button is pushed, then the mouse is
1222moved, and the second point is defined as the mouse button is
1223released (click-drag). The domains are thus defined by a long click
1224(<abbr class="abbrev">LC</abbr>). To determine which type of plot
1225should be made of selection, use:</p>
1226<p>If the plot selector is on <code class="constant">plt</code></p>
1227<div class="itemizedlist">
1228<ul type="disc">
1229<li>
1230<p>the <span class="mousebutton">left</span> mouse button to create
1231horizontal plots (<code class="constant">plt</code>)</p>
1232</li>
1233<li>
1234<p>the <span class="mousebutton">middle</span> mouse button to
1235create vertical plots (<code class="constant">pltz</code>)</p>
1236</li>
1237<li>
1238<p>the <span class="mousebutton">right</span> mouse button to
1239create common hovmoellers for xt and yt cuts (<code class=
1240"constant">pltt</code>)</p>
1241</li>
1242</ul>
1243</div>
1244<p>In summary:</p>
1245<div class="itemizedlist">
1246<ul type="disc">
1247<li>
1248<div class="figure"><a name="fig_mousell" id="fig_mousell"></a>
1249<p class="title"><b>Figure&nbsp;26.&nbsp;<abbr class=
1250"abbrev">LCL</abbr>---&gt;<code class="constant">plt</code></b></p>
1251<div class="figure-contents">
1252<div class="mediaobjectco"><img border="0" usemap="d0e1098" src=
1253"figpng/xxx_mousell.png" alt="LCL---&gt;plt"><map name="d0e1098"
1254id="d0e1098"></map></div>
1255</div>
1256</div>
1257<p><br class="figure-break"></p>
1258<div class="figure"><a name="fig_xxx_0701" id="fig_xxx_0701"></a>
1259<p class="title"><b>Figure&nbsp;27.&nbsp;Horizontal Plot</b></p>
1260<div class="figure-contents"><img src="figpng/xxx_0701.png" alt=
1261"Horizontal Plot"></div>
1262</div>
1263<p><br class="figure-break"></p>
1264</li>
1265<li>
1266<div class="figure"><a name="fig_mouselm" id="fig_mouselm"></a>
1267<p class="title"><b>Figure&nbsp;28.&nbsp;<abbr class=
1268"abbrev">LCM</abbr>---&gt;<code class=
1269"constant">pltz</code></b></p>
1270<div class="figure-contents">
1271<div class="mediaobjectco"><img border="0" usemap="d0e1122" src=
1272"figpng/xxx_mouselm.png" alt="LCM---&gt;pltz"><map name="d0e1122"
1273id="d0e1122"></map></div>
1274</div>
1275</div>
1276<p><br class="figure-break"></p>
1277<div class="figure"><a name="fig_xxx_0702" id="fig_xxx_0702"></a>
1278<p class="title"><b>Figure&nbsp;29.&nbsp;Vertical Plot</b></p>
1279<div class="figure-contents"><img src="figpng/xxx_0702.png" alt=
1280"Vertical Plot"></div>
1281</div>
1282<p><br class="figure-break"></p>
1283</li>
1284<li>
1285<div class="figure"><a name="fig_mouselr" id="fig_mouselr"></a>
1286<p class="title"><b>Figure&nbsp;30.&nbsp;<abbr class=
1287"abbrev">LCR</abbr>---&gt;<code class=
1288"constant">pltt</code></b></p>
1289<div class="figure-contents">
1290<div class="mediaobjectco"><img border="0" usemap="d0e1146" src=
1291"figpng/xxx_mouselr.png" alt="LCR---&gt;pltt"><map name="d0e1146"
1292id="d0e1146"></map></div>
1293</div>
1294</div>
1295<p><br class="figure-break"></p>
1296<div class="figure"><a name="fig_xxx_0703" id="fig_xxx_0703"></a>
1297<p class="title"><b>Figure&nbsp;31.&nbsp;Common hovmoeller for xt
1298and yt cuts</b></p>
1299<div class="figure-contents"><img src="figpng/xxx_0703.png" alt=
1300"Common hovmoeller for xt and yt cuts"></div>
1301</div>
1302<p><br class="figure-break"></p>
1303</li>
1304</ul>
1305</div>
1306<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
1307<h3 class="title">Note</h3>
1308<p>If the plot selector is on something other than <code class=
1309"constant">plt</code> the indicated plot type is made.</p>
1310</div>
1311</div>
1312<div class="sect2" lang="en">
1313<div class="titlepage">
1314<div>
1315<div>
1316<h3 class="title"><a name="multipleplots" id=
1317"multipleplots"></a>3.2.&nbsp;Create multiple plots on the same
1318sheet and make them interact</h3>
1319</div>
1320</div>
1321</div>
1322<p>Select the number of columns and rows for the page.</p>
1323<p>Create a first plot. It will appear in the first frame.</p>
1324<p>To create a plot in another frame double-click in the frame with
1325the <span class="mousebutton">middle</span> button (<abbr class=
1326"abbrev"><span class="mousebutton">DCM</span></abbr>). A black
1327dotted frame will surround the designated frame, the
1328&ldquo;<span class="quote">target</span>&rdquo; frame. A black
1329frame will surround the first plot. This is the &ldquo;<span class=
1330"quote">reference</span>&rdquo; frame, in other words the one that
1331all the XXX widgets refer to. Change for example the date and
1332create a new plot. With a <span class="mousebutton">left</span>
1333button double-click in the first frame, all the widgets change and
1334refer again to the first plot. A double-click with the <span class=
1335"mousebutton">right</span> button in the second frame will erase
1336the plot.</p>
1337<p>In summary:</p>
1338<div class="itemizedlist">
1339<ul type="disc">
1340<li>
1341<div class="figure"><a name="fig_mousedl" id="fig_mousedl"></a>
1342<p class="title"><b>Figure&nbsp;32.&nbsp;<abbr class=
1343"abbrev">DCL</abbr>---&gt;&ldquo;<span class=
1344"quote">reference</span>&rdquo; frame</b></p>
1345<div class="figure-contents">
1346<div class="mediaobjectco"><img border="0" usemap="d0e1210" src=
1347"figpng/xxx_mousedl.png" alt="DCL---&gt;reference frame"><map name=
1348"d0e1210" id="d0e1210"></map></div>
1349</div>
1350</div>
1351<p><br class="figure-break"></p>
1352<div class="figure"><a name="fig_xxx_0801" id="fig_xxx_0801"></a>
1353<p class="title"><b>Figure&nbsp;33.&nbsp;The reference frame is
1354selected</b></p>
1355<div class="figure-contents"><img src="figpng/xxx_0801.png" alt=
1356"The reference frame is selected"></div>
1357</div>
1358<p><br class="figure-break"></p>
1359</li>
1360<li>
1361<div class="figure"><a name="fig_mousedm" id="fig_mousedm"></a>
1362<p class="title"><b>Figure&nbsp;34.&nbsp;<abbr class=
1363"abbrev">DCM</abbr>---&gt;&ldquo;<span class=
1364"quote">target</span>&rdquo; frame</b></p>
1365<div class="figure-contents">
1366<div class="mediaobjectco"><img border="0" usemap="d0e1235" src=
1367"figpng/xxx_mousedm.png" alt="DCM---&gt;target frame"><map name=
1368"d0e1235" id="d0e1235"></map></div>
1369</div>
1370</div>
1371<p><br class="figure-break"></p>
1372<div class="figure"><a name="fig_xxx_0802" id="fig_xxx_0802"></a>
1373<p class="title"><b>Figure&nbsp;35.&nbsp;The target frame is
1374selected</b></p>
1375<div class="figure-contents"><img src="figpng/xxx_0802.png" alt=
1376"The target frame is selected"></div>
1377</div>
1378<p><br class="figure-break"></p>
1379</li>
1380<li>
1381<div class="figure"><a name="fig_mousedr" id="fig_mousedr"></a>
1382<p class="title"><b>Figure&nbsp;36.&nbsp;<abbr class=
1383"abbrev">DCR</abbr>---&gt;erase the frame</b></p>
1384<div class="figure-contents">
1385<div class="mediaobjectco"><img border="0" usemap="d0e1257" src=
1386"figpng/xxx_mousedr.png" alt="DCR---&gt;erase the frame"><map name=
1387"d0e1257" id="d0e1257"></map></div>
1388</div>
1389</div>
1390<p><br class="figure-break"></p>
1391</li>
1392</ul>
1393</div>
1394<p>Here's a series of commands to show how this works.</p>
1395<div class="procedure">
1396<ol type="1">
1397<li>
1398<p>load xxx with the command:</p>
1399<pre class="screen">
1400    <code class="prompt">idl&gt;</code> <strong class=
1401"userinput"><code><span><strong class=
1402"command">xxx</strong></span>, <em class=
1403"parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_ORCA05.nc'</code></em>, <em class="parameter"><code>'tst_initorca05'</code></em></code></strong>
1404 
1405</pre></li>
1406<li>
1407<p>Select a 3-D field and create 6 frames for the sheet of
1408paper.</p>
1409</li>
1410<li>
1411<p>Create a horizontal plot in Frame 1</p>
1412</li>
1413<li>
1414<p><abbr class="abbrev">DCM</abbr> in frame 2, <abbr class=
1415"abbrev">LCL</abbr> on the plot in frame 1, to create a horizontal
1416zoom in frame 2.</p>
1417<p><abbr class="abbrev">DCM</abbr> in frame 3, <abbr class=
1418"abbrev">LCM</abbr> on the plot in frame 1, to create a vertical
1419cut in frame 3.</p>
1420<p><abbr class="abbrev">DCM</abbr> in frame 4, <abbr class=
1421"abbrev">LCR</abbr> on the plot in frame 1, to create a hovmoeller
1422in frame 4.</p>
1423<div class="figure"><a name="fig_xxx_0901" id="fig_xxx_0901"></a>
1424<p class="title"><b>Figure&nbsp;37.&nbsp;Frame with four
1425plot</b></p>
1426<div class="figure-contents"><img src="figpng/xxx_0901.png" alt=
1427"Frame with four plot"></div>
1428</div>
1429<p><br class="figure-break"></p>
1430</li>
1431</ol>
1432</div>
1433<div class="procedure">
1434<p>To redo the hovmoeller with the keyword</p>
1435<div class="literallayout">
1436<p>/nocontour</p>
1437</div>
1438<ol type="1">
1439<li>
1440<p><abbr class="abbrev">DCL</abbr> in frame 4 which now becomes the
1441reference and target frame.</p>
1442</li>
1443<li>
1444<p>Add the keyword</p>
1445<div class="literallayout">
1446<p>/nocontour</p>
1447</div>
1448<div class="figure"><a name="fig_xxx_0902a" id="fig_xxx_0902a"></a>
1449<p class="title"><b>Figure&nbsp;38.&nbsp;Command text area</b></p>
1450<div class="figure-contents"><img src="figpng/xxx_0902a.png" alt=
1451"Command text area"></div>
1452</div>
1453<p><br class="figure-break"></p>
1454</li>
1455<li>
1456<p>click <span class="guibutton">OK</span>, and the plot is
1457redone.</p>
1458<div class="figure"><a name="fig_xxx_0902" id="fig_xxx_0902"></a>
1459<p class="title"><b>Figure&nbsp;39.&nbsp;The fourth plot with the
1460keyword "nocontour"</b></p>
1461<div class="figure-contents"><img src="figpng/xxx_0902.png" alt=
1462"The fourth plot with the keyword &quot;nocontour&quot;"></div>
1463</div>
1464<p><br class="figure-break"></p>
1465</li>
1466</ol>
1467</div>
1468<div class="procedure">
1469<p>in frame 5, let's create the same plot as in frame 2 except we
1470use pltv instead of plt</p>
1471<ol type="1">
1472<li>
1473<p><abbr class="abbrev">DCL</abbr> on frame 2</p>
1474</li>
1475<li>
1476<p><abbr class="abbrev">DCM</abbr> on frame 5</p>
1477</li>
1478<li>
1479<p>change plt for pltv</p>
1480</li>
1481<li>
1482<p>Click on <span class="guibutton">OK</span></p>
1483<div class="figure"><a name="fig_xxx_0903" id="fig_xxx_0903"></a>
1484<p class="title"><b>Figure&nbsp;40.&nbsp;Frame with five
1485plot</b></p>
1486<div class="figure-contents"><img src="figpng/xxx_0903.png" alt=
1487"Frame with five plot"></div>
1488</div>
1489<p><br class="figure-break"></p>
1490</li>
1491</ol>
1492</div>
1493</div>
1494</div>
1495<div class="sect1" lang="en">
1496<div class="titlepage">
1497<div>
1498<div>
1499<h2 class="title" style="clear: both"><a name="crash" id=
1500"crash"></a>4.&nbsp;What should I do when it breakdown</h2>
1501</div>
1502</div>
1503</div>
1504<div class="orderedlist">
1505<ol type="1">
1506<li>
1507<p>In the IDL window type (as many time you click on a button since
1508a problem occurs in xxx !!!),</p>
1509<pre class="screen">
1510<code class="prompt">idl&gt;</code> <strong class=
1511"userinput"><code>retall</code></strong>
1512</pre></li>
1513<li>
1514<p>in the IDL window, type</p>
1515<pre class="screen">
1516<code class="prompt">idl&gt;</code> <strong class=
1517"userinput"><code>domdef</code></strong>
1518</pre></li>
1519<li>
1520<p><abbr class="abbrev">DCR</abbr> to erase the problem frame.</p>
1521</li>
1522<li>
1523<p>change the orientation of the plot by pressing Flag options
1524-&gt; Portrait/Landscape. Cf <a href="#flagsubmenu" title=
1525"2.2.3.&nbsp;Flag options sub-menu">Section&nbsp;2.2.3,
1526&ldquo;<span class="guisubmenu">Flag options</span>
1527sub-menu&rdquo;</a></p>
1528</li>
1529<li>
1530<p>quit XXX cleanly using <span class="guibutton">quit</span> from
1531the <span class="guimenu">File</span> menu. Cf <a href=
1532"#filesubmenu" title=
1533"2.2.1.&nbsp;File sub-menu">Section&nbsp;2.2.1, &ldquo;<span class=
1534"guisubmenu">File</span> sub-menu&rdquo;</a></p>
1535</li>
1536</ol>
1537</div>
1538<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
1539<h3 class="title">Note</h3>
1540<p>Always avoid if at all possible closing and killing the XXX
1541window, but rather select <span class="guibutton">quit</span> from
1542the <span class="guimenu">File</span> menu. XXX uses a large number
1543of pointers, and want only killing the window will leave a large
1544number of unused variables in memory, which could in the end
1545overflow. To clean up this memory:</p>
1546<pre class="screen">
1547<code class="prompt">idl&gt;</code> <strong class=
1548"userinput"><code>ptr_free, ptr_valid()</code></strong>
1549</pre></div>
1550</div>
1551</div>
1552</body>
1553</html>
Note: See TracBrowser for help on using the repository browser.