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

Last change on this file since 157 was 157, checked in by navarro, 18 years ago

header improvements + xxx doc

  • Property svn:keywords set to Id
File size: 38.1 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 1st December 2004), 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">
29Sebastien.Masson_at_locean-ipsl.upmc.fr</a>&gt;</code></h3>
30</div>
31<div class="author">
32<h3 class="author"><span class="firstname">Albert</span>
33<span class="surname">Fisher</span></h3>
34</div>
35<div class="author">
36<h3 class="author"><span class="firstname">Fran&ccedil;oise</span>
37<span class="surname">Pinsard</span> <code class=
38"email">&lt;<a href=
39"mailto:Francoise.Pinsard_at_locean-ipsl.upmc.fr">Francoise.Pinsard_at_locean-ipsl.upmc.fr</a>&gt;</code></h3>
40</div>
41<div class="author">
42<h3 class="author"><span class="firstname">Steve</span>
43<span class="surname">Navarro</span></h3>
44</div>
45</div>
46</div>
47<div><span class="pubdate">svn Id of xml source file : $Id:
48mini_notice.xml 149 2006-07-28 15:13:40Z smasson $<br>
49<br></span></div>
50<div>
51<div class="revhistory">
52<table border="1" width="100%" summary="Revision history">
53<tr>
54<th align="left" valign="top" colspan="2"><b>Revision
55History</b></th>
56</tr>
57<tr>
58<td align="left">Revision 0.0</td>
59<td align="left">May 29, 2000</td>
60</tr>
61<tr>
62<td align="left" colspan="2">French release by S&eacute;bastien
63Masson</td>
64</tr>
65<tr>
66<td align="left">Revision 0.1</td>
67<td align="left">July, 2002</td>
68</tr>
69<tr>
70<td align="left" colspan="2">Translation by Albert Fisher</td>
71</tr>
72<tr>
73<td align="left">Revision 0.2</td>
74<td align="left">July 20, 2006</td>
75</tr>
76<tr>
77<td align="left" colspan="2">HTML to XML/Docbook migration by
78Fran&ccedil;oise Pinsard</td>
79</tr>
80</table>
81</div>
82</div>
83</div>
84<hr></div>
85<div class="toc">
86<p><b>Table of Contents</b></p>
87<dl>
88<dt><span class="sect1"><a href="#introxxx">1. XXX widget
89functions</a></span></dt>
90<dd>
91<dl>
92<dt><span class="sect2"><a href="#launchxxx">1.1. Launching
93XXX</a></span></dt>
94<dt><span class="sect2"><a href="#wigdets">1.2. Description of XXX
95window</a></span></dt>
96</dl>
97</dd>
98<dt><span class="sect1"><a href="#mouseactions">2. Mouse
99Actions</a></span></dt>
100<dd>
101<dl>
102<dt><span class="sect2"><a href="#mouse">2.1. In the graphics
103window on a horizontal plot</a></span></dt>
104<dt><span class="sect2"><a href="#multipleplots">2.2. Create
105multiple plots on the same sheet and make them
106interact</a></span></dt>
107</dl>
108</dd>
109<dt><span class="sect1"><a href="#crash">3. What should I do when
110it breakdown</a></span></dt>
111</dl>
112</div>
113<div class="sect1" lang="en">
114<div class="titlepage">
115<div>
116<div>
117<h2 class="title" style="clear: both"><a name="introxxx" id=
118"introxxx"></a>1.&nbsp;XXX widget functions</h2>
119</div>
120</div>
121</div>
122<div class="sect2" lang="en">
123<div class="titlepage">
124<div>
125<div>
126<h3 class="title"><a name="launchxxx" id=
127"launchxxx"></a>1.1.&nbsp;Launching XXX</h3>
128</div>
129</div>
130</div>
131<p>The first command to type is</p>
132<pre class="screen">
133<code class="prompt">idl&gt;</code> <strong class=
134"userinput"><code>@init</code></strong>
135</pre>
136<p>Afterwards, to work directly with XXX, type:</p>
137<pre class="screen">
138
139<code class="prompt">idl&gt;</code> <strong class=
140"userinput"><code>xxx</code></strong>
141</pre>
142A window will open with 2 lines to complete.
143<div class="figure"><a name="fig_xxx_0101" id="fig_xxx_0101"></a>
144<p class="title"><b>Figure 1. Window xxx 1</b></p>
145<div class="figure-contents">
146<div class="mediaobjectco"><img border="0" usemap="d0e102" src=
147"figpng/xxx_0101.png" alt="Window xxx 1"><map name="d0e102" id=
148"d0e102">
149<area shape="rect" coords="26,256,485,214">
150<area shape="rect" coords="78,208,433,157">
151<area shape="rect" coords="3,150,518,31"></map>
152<div class="calloutlist">
153<table border="0" summary="Callout list">
154<tr>
155<td width="5%" valign="top" align="left"><img src=
156"images/callouts/1.png" alt="1" border="0"></td>
157<td valign="top" align="left">
158<p>Data file</p>
159</td>
160</tr>
161<tr>
162<td width="5%" valign="top" align="left"><img src=
163"images/callouts/2.png" alt="2" border="0"></td>
164<td valign="top" align="left">
165<p>Init method</p>
166</td>
167</tr>
168<tr>
169<td width="5%" valign="top" align="left"><img src=
170"images/callouts/3.png" alt="3" border="0"></td>
171<td valign="top" align="left">
172<p>Init program</p>
173</td>
174</tr>
175</table>
176</div>
177</div>
178</div>
179</div>
180<br class="figure-break">
181<div class="sect3" lang="en">
182<div class="titlepage">
183<div>
184<div>
185<h4 class="title"><a name="datafiletxt" id="datafiletxt"></a>1.1.1.
186File name</h4>
187</div>
188</div>
189</div>
190<p>the name of the data file. The name can be typed directly in the
191window provided, or selected with the help of the <span class=
192"guibutton">browse</span> button.</p>
193</div>
194<div class="sect3" lang="en">
195<div class="titlepage">
196<div>
197<div>
198<h4 class="title"><a name="initmethodtxt" id=
199"initmethodtxt"></a>1.1.2. Grid initalization method</h4>
200</div>
201</div>
202</div>
203<p>By default, "automatic grid construction with initncdf.pro" is
204checked.</p>
205<p>But you can choose an other grid by checking "grid construction
206with other IDL batch or procedure"</p>
207</div>
208<div class="sect3" lang="en">
209<div class="titlepage">
210<div>
211<div>
212<h4 class="title"><a name="initprogramtxt" id=
213"initprogramtxt"></a>1.1.3. Grid initalization parameters</h4>
214</div>
215</div>
216</div>
217<div class="figure"><a name="fig_xxx_0102" id="fig_xxx_0102"></a>
218<p class="title"><b>Figure 2. Window xxx 1</b></p>
219<div class="figure-contents">
220<div class="mediaobjectco"><img border="0" usemap="d0e145" src=
221"figpng/xxx_0102.png" alt="Window xxx 1"><map name="d0e145" id=
222"d0e145"></map></div>
223</div>
224</div>
225<p><br class="figure-break"></p>
226<p>the second the name of the <code class=
227"filename">initgrid.pro</code> script which will permit the reading
228and processing of the grid associated with the data file.</p>
229<p>Once these two lines have been completed, click on <span class=
230"guibutton">let's go</span>.</p>
231<p>For example, we choose the mask "tst_initlev". Compare the
232result with "automatic grid construction with initncdf.pro"
233checked. Cf <a href="#fig_xxx_0404" title=
234"Figure&nbsp;23.&nbsp;Oceania at 125 metters of depth without a mask">
235Figure 23, &ldquo;Oceania at 125 metters of depth without a
236mask&rdquo;</a></p>
237<div class="figure"><a name="fig_xxx_0103" id="fig_xxx_0103"></a>
238<p class="title"><b>Figure 3. Oceania at 125 metters of depth with
239a mask</b></p>
240<div class="figure-contents"><img src="figpng/xxx_0103.png" alt=
241"Oceania at 125 metters of depth with a mask"></div>
242</div>
243<p><br class="figure-break"></p>
244</div>
245</div>
246<div class="sect2" lang="en">
247<div class="titlepage">
248<div>
249<div>
250<h3 class="title"><a name="wigdets" id=
251"wigdets"></a>1.2.&nbsp;Description of XXX window</h3>
252</div>
253</div>
254</div>
255<p>Now the XXX window will open.</p>
256<div class="figure"><a name="fig_xxx_0201" id="fig_xxx_0201"></a>
257<p class="title"><b>Figure&nbsp;4.&nbsp;Window xxx 2</b></p>
258<div class="figure-contents">
259<div class="mediaobjectco"><img border="0" usemap="d0e182" src=
260"figpng/xxx_0201.png" alt="Window xxx 2"><map name="d0e182" id=
261"d0e182">
262<area shape="rect" coords="3,606,97,579">
263<area shape="rect" coords="108,606,325,577">
264<area shape="rect" coords="5,571,44,544">
265<area shape="rect" coords="70,571,193,544">
266<area shape="rect" coords="209,570,323,545">
267<area shape="rect" coords="2,535,344,513">
268<area shape="rect" coords="2,504,346,470">
269<area shape="rect" coords="2,461,212,414">
270<area shape="rect" coords="16,403,308,183">
271<area shape="rect" coords="1,172,345,50"></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>Plot type</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>Menu</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>OK</p>
293</td>
294</tr>
295<tr>
296<td width="5%" valign="top" align="left"><img src=
297"images/callouts/4.png" alt="4" border="0"></td>
298<td valign="top" align="left">
299<p>Page layout</p>
300</td>
301</tr>
302<tr>
303<td width="5%" valign="top" align="left"><img src=
304"images/callouts/5.png" alt="5" border="0"></td>
305<td valign="top" align="left">
306<p>Variables list</p>
307</td>
308</tr>
309<tr>
310<td width="5%" valign="top" align="left"><img src=
311"images/callouts/6.png" alt="6" border="0"></td>
312<td valign="top" align="left">
313<p>Files list</p>
314</td>
315</tr>
316<tr>
317<td width="5%" valign="top" align="left"><img src=
318"images/callouts/7.png" alt="7" border="0"></td>
319<td valign="top" align="left">
320<p>Command text</p>
321</td>
322</tr>
323<tr>
324<td width="5%" valign="top" align="left"><img src=
325"images/callouts/8.png" alt="8" border="0"></td>
326<td valign="top" align="left">
327<p>Calendar</p>
328</td>
329</tr>
330<tr>
331<td width="5%" valign="top" align="left"><img src=
332"images/callouts/9.png" alt="9" border="0"></td>
333<td valign="top" align="left">
334<p>Domdef</p>
335</td>
336</tr>
337<tr>
338<td width="5%" valign="top" align="left"><img src=
339"images/callouts/10.png" alt="10" border="0"></td>
340<td valign="top" align="left">
341<p>Spefications</p>
342</td>
343</tr>
344</table>
345</div>
346</div>
347</div>
348</div>
349<p><br class="figure-break"></p>
350<p>It's configuration will change depending on whether you are in
351portrait or in landscape, but here are the different parts
352available for your use.</p>
353<div class="sect3" lang="en">
354<div class="titlepage">
355<div>
356<div>
357<h4 class="title"><a name="plottypetxt" id=
358"plottypetxt"></a>1.2.1.&nbsp;Plot type list</h4>
359</div>
360</div>
361</div>
362<p>allows specification of the type of plot desired.</p>
363<div class="figure"><a name="fig_xxx_0202" id="fig_xxx_0202"></a>
364<p class="title"><b>Figure&nbsp;5.&nbsp;Differents plot types
365avaibles</b></p>
366<div class="figure-contents"><img src="figpng/xxx_0202.png" alt=
367"Differents plot types avaibles"></div>
368</div>
369<p><br class="figure-break"></p>
370<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
371<h3 class="title">Note</h3>
372<p>If the type <code class="constant">plt</code> is selected, the
373selection of plot type is made by mouse. Cf <a href="#mouse" title=
374"2.1.&nbsp;In the graphics window on a horizontal plot">Section&nbsp;2.1,
375&ldquo;In the graphics window on a horizontal plot&rdquo;</a></p>
376</div>
377</div>
378<div class="sect3" lang="en">
379<div class="titlepage">
380<div>
381<div>
382<h4 class="title"><a name="menutxt" id=
383"menutxt"></a>1.2.2.&nbsp;The menu bar made up of 3 submenus</h4>
384</div>
385</div>
386</div>
387<div class="sect4" lang="en">
388<div class="titlepage">
389<div>
390<div>
391<h5 class="title"><a name="filesubmenu" id=
392"filesubmenu"></a>1.2.2.1.&nbsp;<span class=
393"guisubmenu">File</span> submenu</h5>
394</div>
395</div>
396</div>
397<div class="figure"><a name="fig_xxx_0203" id="fig_xxx_0203"></a>
398<p class="title"><b>Figure&nbsp;6.&nbsp;The File menu</b></p>
399<div class="figure-contents"><img src="figpng/xxx_0203.png" alt=
400"The File menu"></div>
401</div>
402<p><br class="figure-break"></p>
403<div class="itemizedlist">
404<ul type="disc">
405<li>
406<p><span class="guimenuitem">Open:</span> to open a second file.
407Same procedure as during the launching of XXX. The new file can be
408on a different grid, with different variables, with a different
409time base.</p>
410</li>
411<li>
412<p><span class="guimenuitem">New XXX:</span> to open a second XXX
413window identical to the first.</p>
414</li>
415<li>
416<p><span class="guimenuitem">Close:</span> to close the XXX
417window.</p>
418</li>
419</ul>
420</div>
421</div>
422<div class="sect4" lang="en">
423<div class="titlepage">
424<div>
425<div>
426<h5 class="title"><a name="saveassubmenu" id=
427"saveassubmenu"></a>1.2.2.2.&nbsp;<span class="guisubmenu">Save
428As</span> submenu</h5>
429</div>
430</div>
431</div>
432<div class="figure"><a name="fig_xxx_0204" id="fig_xxx_0204"></a>
433<p class="title"><b>Figure&nbsp;7.&nbsp;The Save As menu</b></p>
434<div class="figure-contents"><img src="figpng/xxx_0204.png" alt=
435"The Save As menu"></div>
436</div>
437<p><br class="figure-break"></p>
438<div class="itemizedlist">
439<ul type="disc">
440<li>
441<p><span class="guimenuitem">Postscript:</span> to save in
442Postscript format</p>
443</li>
444<li>
445<p><span class="guimenuitem">Animated gif:</span> to create an
446animation from the XXX window. Careful, the creation of an
447animation is only possible if none of the plots have a time axis,
448and if the plots are all on the same time base (calendar). On the
449other hand, animations of horizontal and vertical plots, with
450different color palettes (for those not on an X-terminal), are
451possible.</p>
452<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
453<h3 class="title">Note</h3>
454<p>the creation of animations has a tendency to saturate the video
455memory of X-terminals, crashing the entire program...</p>
456</div>
457</li>
458<li>
459<p><span class="guimenuitem">Gif:</span> to save a gif of the XXX
460graphics window.</p>
461</li>
462<li>
463<p><span class="guimenuitem">IDL procedure:</span> to save the
464command history that has created the plot. For example if I save
465the commands in <code class="filename">xxx_figure.pro</code>, I can
466then launch a new IDL session and type:</p>
467<pre class="screen">
468<code class="prompt">idl&gt;</code> <strong class=
469"userinput"><code>@init</code></strong>
470<code class="prompt">idl&gt;</code> <strong class=
471"userinput"><code>xxx_figure</code></strong>
472</pre>
473<p>and I'll obtain the saved figure.</p>
474<pre class="screen">
475<code class="prompt">idl&gt;</code> <strong class=
476"userinput"><code>xxx_figure,/post </code></strong>
477</pre>
478<p>or</p>
479<pre class="screen">
480<code class="prompt">idl&gt;</code> <strong class=
481"userinput"><code>@ps</code></strong>
482</pre>
483<p>will then create a Postscript file of the figure.</p>
484</li>
485<li>
486<p><span class="guimenuitem">RESTORE kwd of xxx:</span></p>
487</li>
488<li>
489<p><span class="guimenuitem">Print to prompt:</span> lists in the
490IDL window the command history that created the last plot. Useful
491primarily for debugging...</p>
492</li>
493</ul>
494</div>
495</div>
496<p>Test the various possibilities in the <span class="guimenu">Save
497As</span> menu.</p>
498<div class="sect4" lang="en">
499<div class="titlepage">
500<div>
501<div>
502<h5 class="title"><a name="flagsubmenu" id=
503"flagsubmenu"></a>1.2.2.3.&nbsp;<span class="guisubmenu">Flag
504options</span> submenu</h5>
505</div>
506</div>
507</div>
508<div class="figure"><a name="fig_xxx_0205" id="fig_xxx_0205"></a>
509<p class="title"><b>Figure&nbsp;8.&nbsp;The Flag Option
510menu</b></p>
511<div class="figure-contents"><img src="figpng/xxx_0205.png" alt=
512"The Flag Option menu"></div>
513</div>
514<p><br class="figure-break"></p>
515<div class="itemizedlist">
516<ul type="disc">
517<li>
518<p><span class="guibutton">Portrait/Landscape:</span> changes the
519configuration of the plot.</p>
520</li>
521<li>
522<p><span class="guibutton">Overlay:</span> to plot contours of a
523different field on top the one represented as color-filled
524contours. It is necessary to relaunch the entire plot to make this
525work!</p>
526</li>
527<li>
528<p><span class="guibutton">Vecteur:</span> to plot a vector field
529on top of contours. Only works on horizontal plots (<code class=
530"filename">plt.pro</code>). As for Overlay, a relaunch of the
531entire plot is necessary.</p>
532</li>
533<li>
534<p><span class="guibutton">Longitude / x index:</span> switches
535longitude labelling of the plot subdomain from degrees to indices
536following i.</p>
537</li>
538<li>
539<p><span class="guibutton">Latitude / y index:</span> switches
540latitude labelling of the plot subdomain from degrees to indices
541following j.</p>
542</li>
543</ul>
544</div>
545</div>
546<p>Test the various possibilities in the <span class="guimenu">Flag
547options</span> menu.</p>
548<div class="caution" style=
549"margin-left: 0.5in; margin-right: 0.5in;">
550<h3 class="title">Caution</h3>
551<p>Careful, a selected option remains selected until it is
552reclicked.</p>
553</div>
554</div>
555<div class="sect3" lang="en">
556<div class="titlepage">
557<div>
558<div>
559<h4 class="title"><a name="oktxt" id="oktxt"></a>1.2.3.&nbsp;OK
560button</h4>
561</div>
562</div>
563</div>
564<p>click on this <span class="guibutton">OK</span> button is
565required to make a new plot appear</p>
566</div>
567<div class="sect3" lang="en">
568<div class="titlepage">
569<div>
570<div>
571<h4 class="title"><a name="pagelayouttxt" id=
572"pagelayouttxt"></a>1.2.4.&nbsp;Page Layout</h4>
573</div>
574</div>
575</div>
576<p>specify the number of columns and rows for plots on the sheet of
577paper.</p>
578<div class="figure"><a name="fig_xxx_0206" id="fig_xxx_0206"></a>
579<p class="title"><b>Figure&nbsp;9.&nbsp;Number of Column</b></p>
580<div class="figure-contents"><img src="figpng/xxx_0206.png" alt=
581"Number of Column"></div>
582</div>
583<p><br class="figure-break"></p>
584<p>For example: For 2 cln and 2 row. For explanations, see
585further.</p>
586<div class="figure"><a name="fig_xxx_0206a" id="fig_xxx_0206a"></a>
587<p class="title"><b>Figure&nbsp;10.&nbsp;A frame with several
588graphics</b></p>
589<div class="figure-contents"><img src="figpng/xxx_0206a.png" alt=
590"A frame with several graphics"></div>
591</div>
592<p><br class="figure-break"></p>
593</div>
594<div class="sect3" lang="en">
595<div class="titlepage">
596<div>
597<div>
598<h4 class="title"><a name="variableslisttxt" id=
599"variableslisttxt"></a>1.2.5.&nbsp;<span class="guimenuitem">List
600of variables</span></h4>
601</div>
602</div>
603</div>
604<p>you can choose the variable to work on.</p>
605<div class="figure"><a name="fig_xxx_0207" id="fig_xxx_0207"></a>
606<p class="title"><b>Figure&nbsp;11.&nbsp;differents Variables
607avaible</b></p>
608<div class="figure-contents"><img src="figpng/xxx_0207.png" alt=
609"differents Variables avaible"></div>
610</div>
611<p><br class="figure-break"></p>
612</div>
613<div class="sect3" lang="en">
614<div class="titlepage">
615<div>
616<div>
617<h4 class="title"><a name="fileslisttxt" id=
618"fileslisttxt"></a>1.2.6.&nbsp;<span class="guimenuitem">List of
619open files</span></h4>
620</div>
621</div>
622</div>
623<p>you can choose the file to work on.</p>
624<div class="figure"><a name="fig_xxx_0208" id="fig_xxx_0208"></a>
625<p class="title"><b>Figure&nbsp;12.&nbsp;List of open files</b></p>
626<div class="figure-contents"><img src="figpng/xxx_0208.png" alt=
627"List of open files"></div>
628</div>
629<p><br class="figure-break"></p>
630</div>
631<div class="sect3" lang="en">
632<div class="titlepage">
633<div>
634<div>
635<h4 class="title"><a name="commandtexttxt" id=
636"commandtexttxt"></a>1.2.7.&nbsp;<span class="guimenuitem">Command
637text</span></h4>
638</div>
639</div>
640</div>
641<p>To specify the computation you want to do. Examples:</p>
642<div class="sect4" lang="en">
643<div class="titlepage">
644<div>
645<div>
646<h5 class="title"><a name="withoutcommandtexttxt" id=
647"withoutcommandtexttxt"></a>1.2.7.1.&nbsp; <span class=
648"guimenuitem">Without any Command Text</span></h5>
649</div>
650</div>
651</div>
652<div class="figure"><a name="fig_xxx_0209" id="fig_xxx_0209"></a>
653<p class="title"><b>Figure&nbsp;13.&nbsp;Graphic by default</b></p>
654<div class="figure-contents"><img src="figpng/xxx_0209.png" alt=
655"Graphic by default"></div>
656</div>
657<p><br class="figure-break"></p>
658</div>
659<div class="sect4" lang="en">
660<div class="titlepage">
661<div>
662<div>
663<h5 class="title"><a name="withrealcont" id=
664"withrealcont"></a>1.2.7.2.&nbsp; <span class="guimenuitem">With
665the command text /realcont</span></h5>
666</div>
667</div>
668</div>
669<div class="figure"><a name="fig_xxx_0210a" id="fig_xxx_0210a"></a>
670<p class="title"><b>Figure&nbsp;14.&nbsp;Command text area</b></p>
671<div class="figure-contents"><img src="figpng/xxx_0210a.png" alt=
672"Command text area"></div>
673</div>
674<p><br class="figure-break"></p>
675<div class="figure"><a name="fig_xxx_0210" id="fig_xxx_0210"></a>
676<p class="title"><b>Figure&nbsp;15.&nbsp;Graphic with the command
677text "/realcont"</b></p>
678<div class="figure-contents"><img src="figpng/xxx_0210.png" alt=
679"Graphic with the command text &quot;/realcont&quot;"></div>
680</div>
681<p><br class="figure-break"></p>
682</div>
683<div class="sect4" lang="en">
684<div class="titlepage">
685<div>
686<div>
687<h5 class="title"><a name="withmaportho" id=
688"withmaportho"></a>1.2.7.3.&nbsp;<span class="guimenuitem">With the
689command text /realcont+ map=[90,0,0]+ /ortho+
690cell_fill=2.</span></h5>
691</div>
692</div>
693</div>
694<div class="figure"><a name="fig_xxx_0211a" id="fig_xxx_0211a"></a>
695<p class="title"><b>Figure&nbsp;16.&nbsp;Command text area with the
696right syntax</b></p>
697<div class="figure-contents"><img src="figpng/xxx_0211a.png" alt=
698"Command text area with the right syntax"></div>
699</div>
700<p><br class="figure-break"></p>
701<div class="figure"><a name="fig_xxx_0211" id="fig_xxx_0211"></a>
702<p class="title"><b>Figure&nbsp;17.&nbsp;Polar Projection</b></p>
703<div class="figure-contents"><img src="figpng/xxx_0211.png" alt=
704"Polar Projection"></div>
705</div>
706<p><br class="figure-break"></p>
707</div>
708<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
709<h3 class="title">Note</h3>
710<p>In the default case, the name given to a field is of no
711importance.</p>
712</div>
713</div>
714<div class="sect3" lang="en">
715<div class="titlepage">
716<div>
717<div>
718<h4 class="title"><a name="calendartxt" id=
719"calendartxt"></a>1.2.8.&nbsp;Calendar</h4>
720</div>
721</div>
722</div>
723<p>The calendar is made up of two droplists, which allow
724specification of two dates, the beginning and end of a time series,
725or the period over which to average before plotting.</p>
726<p>Example: The first plot is during January.</p>
727<p>The second plot is from January to December.</p>
728<div class="figure"><a name="fig_xxx_0301" id="fig_xxx_0301"></a>
729<p class="title"><b>Figure&nbsp;18.&nbsp;Graphic with 2 different
730period of study</b></p>
731<div class="figure-contents"><img src="figpng/xxx_0301.png" alt=
732"Graphic with 2 different period of study"></div>
733</div>
734<p><br class="figure-break"></p>
735</div>
736<div class="sect3" lang="en">
737<div class="titlepage">
738<div>
739<div>
740<h4 class="title"><a name="domdeftxt" id=
741"domdeftxt"></a>1.2.9.&nbsp;Define the domain</h4>
742</div>
743</div>
744</div>
745<p>A series of widgets that allow specification of the min/max
746limits of the domain in longitude/x-index, latitude/y-index, and
747depth in levels or meters. For depth, one can specify in levels for
748a horizontal plot, and in meters for a vertical plot.</p>
749<div class="sect4" lang="en">
750<div class="titlepage">
751<div>
752<div>
753<h5 class="title"><a name="withoutdomainspecification" id=
754"withoutdomainspecification"></a>1.2.9.1.&nbsp;<span class=
755"guimenuitem">Without any domain specification</span></h5>
756</div>
757</div>
758</div>
759<div class="figure"><a name="fig_xxx_0210" id="fig_xxx_0210"></a>
760<p class="title"><b>Figure&nbsp;19.&nbsp;Domain by default</b></p>
761<div class="figure-contents"><img src="figpng/xxx_0210.png" alt=
762"Domain by default"></div>
763</div>
764<p><br class="figure-break"></p>
765</div>
766<div class="sect4" lang="en">
767<div class="titlepage">
768<div>
769<div>
770<h5 class="title"><a name="withzoom" id=
771"withzoom"></a>1.2.9.2.&nbsp;<span class="guimenuitem">With a zoom
772on Oceania</span></h5>
773</div>
774</div>
775</div>
776<p>We can zoom, between 0 and 1 meter of depth, on the Oceania, by
777playing with the part Domdef, with this configuration</p>
778<div class="figure"><a name="fig_xxx_0401" id="fig_xxx_0401"></a>
779<p class="title"><b>Figure&nbsp;20.&nbsp;Change Domain area</b></p>
780<div class="figure-contents"><img src="figpng/xxx_0401.png" alt=
781"Change Domain area"></div>
782</div>
783<p><br class="figure-break"></p>
784<p>This configuration give us:</p>
785<div class="figure"><a name="fig_xxx_0402" id="fig_xxx_0402"></a>
786<p class="title"><b>Figure&nbsp;21.&nbsp;Graphic with a specified
787domain</b></p>
788<div class="figure-contents"><img src="figpng/xxx_0402.png" alt=
789"Graphic with a specified domain"></div>
790</div>
791<p><br class="figure-break"></p>
792</div>
793</div>
794<div class="sect4" lang="en">
795<div class="titlepage">
796<div>
797<div>
798<h5 class="title"><a name="depthspecificationtxt" id=
799"depthspecificationtxt"></a>1.2.1.&nbsp;<span class=
800"guimenuitem">With the specification of the depth</span></h5>
801</div>
802</div>
803</div>
804<p>If we want to see the temperature of the ocean between 125 and
805126 meters of depth</p>
806<div class="figure"><a name="fig_xxx_0403" id="fig_xxx_0403"></a>
807<p class="title"><b>Figure&nbsp;22.&nbsp;Change depth area</b></p>
808<div class="figure-contents"><img src="figpng/xxx_0403.png" alt=
809"Change depth area"></div>
810</div>
811<p><br class="figure-break"></p>
812<div class="figure"><a name="fig_xxx_0404" id="fig_xxx_0404"></a>
813<p class="title"><b>Figure&nbsp;23.&nbsp;Oceania at 125 metters of
814depth without a mask</b></p>
815<div class="figure-contents"><img src="figpng/xxx_0404.png" alt=
816"Oceania at 125 metters of depth without a mask"></div>
817</div>
818<p><br class="figure-break"></p>
819<p>As you can see, at this depth, we can see the difference between
820the continent at the surface and the real goegraphy of the terrain.
821If we want to see only the terrain at the specified depth, we have
822to put a mask. Cf <a href="#fig_xxx_0103" title=
823"Figure&nbsp;3.&nbsp;Oceania at 125 metters of depth with a mask">Figure&nbsp;3,
824&ldquo;Oceania at 125 metters of depth with a mask&rdquo;</a></p>
825<p>You can define precisely the depth you want to see:</p>
826<div class="figure"><a name="fig_xxx_0405" id="fig_xxx_0405"></a>
827<p class="title"><b>Figure&nbsp;24.&nbsp;The Precise Depth
828menu</b></p>
829<div class="figure-contents"><img src="figpng/xxx_0405.png" alt=
830"The Precise Depth menu"></div>
831</div>
832<p><br class="figure-break"></p>
833</div>
834<div class="sect3" lang="en">
835<div class="titlepage">
836<div>
837<div>
838<h4 class="title"><a name="specificationstxt" id=
839"specificationstxt"></a>1.2.10.&nbsp;specify your plot</h4>
840</div>
841</div>
842</div>
843<div class="sect4" lang="en">
844<div class="titlepage">
845<div>
846<div>
847<h5 class="title"><a name="minmaxintervaltxt" id=
848"minmaxintervaltxt"></a>1.2.10.1.&nbsp;<span class=
849"guimenuitem">Specify the min, the max and the interval</span></h5>
850</div>
851</div>
852</div>
853<p>You can specify the min, max, and contour interval by filling
854out the provided boxes!</p>
855<p>You can restore configuration by default by pressing the
856"default" button.</p>
857<div class="figure"><a name="fig_xxx_0501" id="fig_xxx_0501"></a>
858<p class="title"><b>Figure&nbsp;25.&nbsp;Specification area</b></p>
859<div class="figure-contents"><img src="figpng/xxx_0501.png" alt=
860"Specification area"></div>
861</div>
862<p><br class="figure-break"></p>
863</div>
864<div class="sect4" lang="en">
865<div class="titlepage">
866<div>
867<div>
868<h5 class="title"><a name="colortxt" id=
869"colortxt"></a>1.2.10.2.&nbsp;<span class="guimenuitem">Specify the
870palette to be used</span></h5>
871</div>
872</div>
873</div>
874<p>For the color palette, you can either specify the name or go
875search for one among the palettes available.</p>
876<div class="figure"><a name="fig_xxx_0502" id="fig_xxx_0502"></a>
877<p class="title"><b>Figure&nbsp;26.&nbsp;The Color menu</b></p>
878<div class="figure-contents"><img src="figpng/xxx_0502.png" alt=
879"The Color menu"></div>
880</div>
881<p><br class="figure-break"></p>
882</div>
883<p>The "keywords" window allows specification of all desired
884keywords. These keywords can be those of <code class=
885"filename">plt.pro</code>, <code class="filename">pltt.pro</code>,
886<code class="filename">pltz.pro</code>, <code class=
887"filename">plt1d.pro</code>, or those of contour, plot, or all
888other programs that are used. Cf <a href="#commandtexttxt" title=
889"1.2.7.&nbsp;Command text">Section&nbsp;1.2.7, &ldquo;<span class=
890"guimenuitem">Command text</span>&rdquo;</a></p>
891</div>
892</div>
893</div>
894<div class="sect1" lang="en">
895<div class="titlepage">
896<div>
897<div>
898<h2 class="title" style="clear: both"><a name="mouseactions" id=
899"mouseactions"></a>2.&nbsp;Mouse Actions</h2>
900</div>
901</div>
902</div>
903<div class="sect2" lang="en">
904<div class="titlepage">
905<div>
906<div>
907<h3 class="title"><a name="mouse" id="mouse"></a>2.1.&nbsp;In the
908graphics window on a horizontal plot</h3>
909</div>
910</div>
911</div>
912<p>Select a domain and select the horizontal plot (<code class=
913"constant">plt</code>), vertical plot (<code class=
914"constant">pltz</code>), or the hovmoeller plot (<code class=
915"constant">pltt</code>):</p>
916<p>The domain we'd like to select for the plot is determined by one
917of its diagonals, defined therefore by two points. The first point
918is defined when the mouse button is pushed, then the mouse is
919moved, and the second point is defined as the mouse button is
920released (click-drag). The domains are thus defined by a long click
921(<abbr class="abbrev">LC</abbr>). To determine which type of plot
922should be made of selection, use:</p>
923<p>If the plot selector is on <code class="constant">plt</code></p>
924<div class="itemizedlist">
925<ul type="disc">
926<li>
927<p>the left mouse button to create horizontal plots (<code class=
928"constant">plt</code>)</p>
929</li>
930<li>
931<p>the middle mouse button to create vertical plots (<code class=
932"constant">pltz</code>)</p>
933</li>
934<li>
935<p>the right mouse button to create common hovmoellers for xt and
936yt cuts (<code class="constant">pltt</code>)</p>
937</li>
938</ul>
939</div>
940<p>In summary:</p>
941<div class="itemizedlist">
942<ul type="disc">
943<li>
944<div class="figure"><a name="fig_mousell" id="fig_mousell"></a>
945<p class="title"><b>Figure&nbsp;27.&nbsp;<abbr class=
946"abbrev">LCL</abbr>---&gt;<code class="constant">plt</code></b></p>
947<div class="figure-contents">
948<div class="mediaobjectco"><img border="0" usemap="d0e760" src=
949"figpng/xxx_mousell.png" alt="LCL---&gt;plt"><map name="d0e760" id=
950"d0e760"></map></div>
951</div>
952</div>
953<p><br class="figure-break"></p>
954<div class="figure"><a name="fig_xxx_0701" id="fig_xxx_0701"></a>
955<p class="title"><b>Figure&nbsp;28.&nbsp;Horizontal Plot</b></p>
956<div class="figure-contents"><img src="figpng/xxx_0701.png" alt=
957"Horizontal Plot"></div>
958</div>
959<p><br class="figure-break"></p>
960</li>
961<li>
962<div class="figure"><a name="fig_mouselm" id="fig_mouselm"></a>
963<p class="title"><b>Figure&nbsp;29.&nbsp;<abbr class=
964"abbrev">LCM</abbr>---&gt;<code class=
965"constant">pltz</code></b></p>
966<div class="figure-contents">
967<div class="mediaobjectco"><img border="0" usemap="d0e784" src=
968"figpng/xxx_mouselm.png" alt="LCM---&gt;pltz"><map name="d0e784"
969id="d0e784"></map></div>
970</div>
971</div>
972<p><br class="figure-break"></p>
973<div class="figure"><a name="fig_xxx_0702" id="fig_xxx_0702"></a>
974<p class="title"><b>Figure&nbsp;30.&nbsp;Vertical Plot</b></p>
975<div class="figure-contents"><img src="figpng/xxx_0702.png" alt=
976"Vertical Plot"></div>
977</div>
978<p><br class="figure-break"></p>
979</li>
980<li>
981<div class="figure"><a name="fig_mouselr" id="fig_mouselr"></a>
982<p class="title"><b>Figure&nbsp;31.&nbsp;<abbr class=
983"abbrev">LCR</abbr>---&gt;<code class=
984"constant">pltt</code></b></p>
985<div class="figure-contents">
986<div class="mediaobjectco"><img border="0" usemap="d0e808" src=
987"figpng/xxx_mouselr.png" alt="LCR---&gt;pltt"><map name="d0e808"
988id="d0e808"></map></div>
989</div>
990</div>
991<p><br class="figure-break"></p>
992<div class="figure"><a name="fig_xxx_0703" id="fig_xxx_0703"></a>
993<p class="title"><b>Figure&nbsp;32.&nbsp;Common hovmoeller for xt
994and yt cuts</b></p>
995<div class="figure-contents"><img src="figpng/xxx_0703.png" alt=
996"Common hovmoeller for xt and yt cuts"></div>
997</div>
998<p><br class="figure-break"></p>
999</li>
1000</ul>
1001</div>
1002<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
1003<h3 class="title">Note</h3>
1004<p>If the plot selector is on something other than <code class=
1005"constant">plt</code> the indicated plot type is made.</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="multipleplots" id=
1013"multipleplots"></a>2.2.&nbsp;Create multiple plots on the same
1014sheet and make them interact</h3>
1015</div>
1016</div>
1017</div>
1018<p>Select the number of columns and rows for the page.</p>
1019<p>Create a first plot. It will appear in the first frame.</p>
1020<p>To create a plot in another frame double-click in the frame with
1021the middle button (<abbr class="abbrev">DCM</abbr>). A black dotted
1022frame will surround the designated frame, the &ldquo;<span class=
1023"quote">target</span>&rdquo; frame. A black frame will surround the
1024first plot. This is the &ldquo;<span class=
1025"quote">reference</span>&rdquo; frame, in other words the one that
1026all the XXX widgets refer to. Change for example the date and
1027create a new plot. With a left button double-click in the first
1028frame, all the widgets change and refer again to the first plot. A
1029double-click with the right button in the second frame will erase
1030the plot.</p>
1031<p>In summary:</p>
1032<div class="itemizedlist">
1033<ul type="disc">
1034<li>
1035<div class="figure"><a name="fig_mousedl" id="fig_mousedl"></a>
1036<p class="title"><b>Figure&nbsp;33.&nbsp;<abbr class=
1037"abbrev">DCL</abbr>---&gt;&ldquo;<span class=
1038"quote">reference</span>&rdquo; frame</b></p>
1039<div class="figure-contents">
1040<div class="mediaobjectco"><img border="0" usemap="d0e861" src=
1041"figpng/xxx_mousedl.png" alt="DCL---&gt;reference frame"><map name=
1042"d0e861" id="d0e861"></map></div>
1043</div>
1044</div>
1045<p><br class="figure-break"></p>
1046<div class="figure"><a name="fig_xxx_0801" id="fig_xxx_0801"></a>
1047<p class="title"><b>Figure&nbsp;34.&nbsp;The reference frame is
1048selected</b></p>
1049<div class="figure-contents"><img src="figpng/xxx_0801.png" alt=
1050"The reference frame is selected"></div>
1051</div>
1052<p><br class="figure-break"></p>
1053</li>
1054<li>
1055<div class="figure"><a name="fig_mousedm" id="fig_mousedm"></a>
1056<p class="title"><b>Figure&nbsp;35.&nbsp;<abbr class=
1057"abbrev">DCM</abbr>---&gt;&ldquo;<span class=
1058"quote">target</span>&rdquo; frame</b></p>
1059<div class="figure-contents">
1060<div class="mediaobjectco"><img border="0" usemap="d0e886" src=
1061"figpng/xxx_mousedm.png" alt="DCM---&gt;target frame"><map name=
1062"d0e886" id="d0e886"></map></div>
1063</div>
1064</div>
1065<p><br class="figure-break"></p>
1066<div class="figure"><a name="fig_xxx_0802" id="fig_xxx_0802"></a>
1067<p class="title"><b>Figure&nbsp;36.&nbsp;The target frame is
1068selected</b></p>
1069<div class="figure-contents"><img src="figpng/xxx_0802.png" alt=
1070"The target frame is selected"></div>
1071</div>
1072<p><br class="figure-break"></p>
1073</li>
1074<li>
1075<div class="figure"><a name="fig_mousedr" id="fig_mousedr"></a>
1076<p class="title"><b>Figure&nbsp;37.&nbsp;<abbr class=
1077"abbrev">DCR</abbr>---&gt;erase the frame</b></p>
1078<div class="figure-contents">
1079<div class="mediaobjectco"><img border="0" usemap="d0e908" src=
1080"figpng/xxx_mousedr.png" alt="DCR---&gt;erase the frame"><map name=
1081"d0e908" id="d0e908"></map></div>
1082</div>
1083</div>
1084<p><br class="figure-break"></p>
1085</li>
1086</ul>
1087</div>
1088<p>Here's a series of commands to show how this works.</p>
1089<div class="procedure">
1090<ol type="1">
1091<li>
1092<p>Select a 3-D field and create 6 frames for the sheet of
1093paper.</p>
1094</li>
1095<li>
1096<p>Create a horizontal plot in Frame 1</p>
1097</li>
1098<li>
1099<p><abbr class="abbrev">DCM</abbr> in frame 2, <abbr class=
1100"abbrev">LCL</abbr> on the plot in frame 1, to create a horizontal
1101zoom in frame 2.</p>
1102<p><abbr class="abbrev">DCM</abbr> in frame 3, <abbr class=
1103"abbrev">LCM</abbr> on the plot in frame 1, to create a vertical
1104cut in frame 3.</p>
1105<p><abbr class="abbrev">DCM</abbr> in frame 4, <abbr class=
1106"abbrev">LCR</abbr> on the plot in frame 1, to create a hovmoeller
1107in frame 4.</p>
1108<div class="figure"><a name="fig_xxx_0901" id="fig_xxx_0901"></a>
1109<p class="title"><b>Figure&nbsp;38.&nbsp;Frame with four
1110plot</b></p>
1111<div class="figure-contents"><img src="figpng/xxx_0901.png" alt=
1112"Frame with four plot"></div>
1113</div>
1114<p><br class="figure-break"></p>
1115</li>
1116</ol>
1117</div>
1118<div class="procedure">
1119<p>To redo the hovmoeller with the keyword</p>
1120<div class="literallayout">
1121<p>/nocontour</p>
1122</div>
1123<ol type="1">
1124<li>
1125<p><abbr class="abbrev">DCL</abbr> in frame 4 which now becomes the
1126reference and target frame.</p>
1127</li>
1128<li>
1129<p>Add the keyword</p>
1130<div class="literallayout">
1131<p>/nocontour</p>
1132</div>
1133<div class="figure"><a name="fig_xxx_0902a" id="fig_xxx_0902a"></a>
1134<p class="title"><b>Figure&nbsp;39.&nbsp;Command text area</b></p>
1135<div class="figure-contents"><img src="figpng/xxx_0902a.png" alt=
1136"Command text area"></div>
1137</div>
1138<p><br class="figure-break"></p>
1139</li>
1140<li>
1141<p>click <span class="guibutton">OK</span>, and the plot is
1142redone.</p>
1143<div class="figure"><a name="fig_xxx_0902" id="fig_xxx_0902"></a>
1144<p class="title"><b>Figure&nbsp;40.&nbsp;The fourth plot with the
1145keyword "nocontour"</b></p>
1146<div class="figure-contents"><img src="figpng/xxx_0902.png" alt=
1147"The fourth plot with the keyword &quot;nocontour&quot;"></div>
1148</div>
1149<p><br class="figure-break"></p>
1150</li>
1151</ol>
1152</div>
1153<div class="procedure">
1154<p>in frame 5, let's create the same plot as in frame 2 except with
1155different dates</p>
1156<ol type="1">
1157<li>
1158<p><abbr class="abbrev">DCL</abbr> on frame 2</p>
1159</li>
1160<li>
1161<p><abbr class="abbrev">DCM</abbr> on frame 5</p>
1162</li>
1163<li>
1164<p>change the date</p>
1165</li>
1166<li>
1167<p>click on <span class="guibutton">OK</span></p>
1168<div class="figure"><a name="fig_xxx_0903" id="fig_xxx_0903"></a>
1169<p class="title"><b>Figure&nbsp;41.&nbsp;Frame with five
1170plot</b></p>
1171<div class="figure-contents"><img src="figpng/xxx_0903.png" alt=
1172"Frame with five plot"></div>
1173</div>
1174<p><br class="figure-break"></p>
1175</li>
1176</ol>
1177</div>
1178</div>
1179</div>
1180<div class="sect1" lang="en">
1181<div class="titlepage">
1182<div>
1183<div>
1184<h2 class="title" style="clear: both"><a name="crash" id=
1185"crash"></a>3.&nbsp;What should I do when it breakdown</h2>
1186</div>
1187</div>
1188</div>
1189<div class="orderedlist">
1190<ol type="1">
1191<li>
1192<p>in the IDL window, type</p>
1193<pre class="screen">
1194<code class="prompt">idl&gt;</code> <strong class=
1195"userinput"><code>retall</code></strong>
1196</pre></li>
1197<li>
1198<p><abbr class="abbrev">DCR</abbr> to erase the problem frame.</p>
1199</li>
1200<li>
1201<p>change the orientation of the plot by pressing Flag options
1202-&gt; Portrait/Landscape. Cf <a href="#flagsubmenu" title=
1203"1.2.2.3.&nbsp;Flag options submenu">Section&nbsp;1.2.2.3,
1204&ldquo;<span class="guisubmenu">Flag options</span>
1205submenu&rdquo;</a></p>
1206</li>
1207<li>
1208<p>quit XXX cleanly using <span class="guibutton">quit</span> from
1209the <span class="guimenu">File</span> menu. Cf <a href=
1210"#filesubmenu" title=
1211"1.2.2.1.&nbsp;File submenu">Section&nbsp;1.2.2.1,
1212&ldquo;<span class="guisubmenu">File</span> submenu&rdquo;</a></p>
1213</li>
1214</ol>
1215</div>
1216<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
1217<h3 class="title">Note</h3>
1218<p>Always avoid if at all possible closing and killing the XXX
1219window, but rather select <span class="guibutton">quit</span> from
1220the <span class="guimenu">File</span> menu. XXX uses a large number
1221of pointers, and wantonly killing the window will leave a large
1222number of unused variables in memory, which could in the end
1223overflow. To clean up this memory:</p>
1224<pre class="screen">
1225<code class="prompt">idl&gt;</code> <strong class=
1226"userinput"><code>ptr_free, ptr_valid()</code></strong>
1227</pre></div>
1228</div>
1229</div>
1230</body>
1231</html>
Note: See TracBrowser for help on using the repository browser.