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

Last change on this file since 156 was 149, checked in by smasson, 18 years ago

work on xxx documentation

  • Property svn:keywords set to Id
File size: 29.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 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 147 2006-07-26 09:09:08Z smasson $<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</table>
80</div>
81</div>
82</div>
83<hr></div>
84<div class="toc">
85<p><b>Table of Contents</b></p>
86<dl>
87<dt><span class="sect1"><a href="#introxxx">1. XXX widget
88functions</a></span></dt>
89<dd>
90<dl>
91<dt><span class="sect2"><a href="#launchxxx">1.1. Launching
92XXX</a></span></dt>
93<dt><span class="sect2"><a href="#wigdets">1.2. Description of XXX
94window</a></span></dt>
95</dl>
96</dd>
97<dt><span class="sect1"><a href="#examples">2. Concrete examples of
98XXX in practice</a></span></dt>
99<dd>
100<dl>
101<dt><span class="sect2"><a href="#example1">2.1. First
102plots</a></span></dt>
103<dt><span class="sect2"><a href="#example2">2.2. Work with more
104than one file</a></span></dt>
105<dt><span class="sect2"><a href="#mouse">2.3. Mouse actions in the
106graphics window on a horizontal plot</a></span></dt>
107<dt><span class="sect2"><a href="#multipleplots">2.4. Create
108multiple plots on the same sheet and make them
109interact</a></span></dt>
110</dl>
111</dd>
112<dt><span class="sect1"><a href="#crash">3. How to quit when it
113crashes</a></span></dt>
114</dl>
115</div>
116<div class="sect1" lang="en">
117<div class="titlepage">
118<div>
119<div>
120<h2 class="title" style="clear: both"><a name="introxxx" id=
121"introxxx"></a>1.&nbsp;XXX widget functions</h2>
122</div>
123</div>
124</div>
125<div class="sect2" lang="en">
126<div class="titlepage">
127<div>
128<div>
129<h3 class="title"><a name="launchxxx" id=
130"launchxxx"></a>1.1.&nbsp;Launching XXX</h3>
131</div>
132</div>
133</div>
134<p>The first command to type is</p>
135<pre class="screen">
136<code class="prompt">idl&gt;</code> <strong class=
137"userinput"><code>@init</code></strong>
138</pre>
139<p>Afterwards, to work directly with XXX, type:</p>
140<pre class="screen">
141
142<code class="prompt">idl&gt;</code> <strong class=
143"userinput"><code>xxx</code></strong>
144</pre>
145A window will open with 2 lines to complete.
146<div class="figure"><a name="fig_xxx_0101" id="fig_xxx_0101"></a>
147<p class="title"><b>Figure&nbsp;1.&nbsp;Window xxx 1</b></p>
148<div class="figure-contents">
149<div class="mediaobjectco"><img border="0" usemap="d0e102" src=
150"figpng/xxx_0101.png" alt="Window xxx 1"><map name="d0e102" id=
151"d0e102">
152<area shape="rect" coords="26,256,485,214">
153<area shape="rect" coords="78,208,433,157">
154<area shape="rect" coords="3,150,518,31"></map>
155<div class="calloutlist">
156<table border="0" summary="Callout list">
157<tr>
158<td width="5%" valign="top" align="left"><img src=
159"images/callouts/1.png" alt="1" border="0"></td>
160<td valign="top" align="left">
161<p>Data file</p>
162</td>
163</tr>
164<tr>
165<td width="5%" valign="top" align="left"><img src=
166"images/callouts/2.png" alt="2" border="0"></td>
167<td valign="top" align="left">
168<p>Init method</p>
169</td>
170</tr>
171<tr>
172<td width="5%" valign="top" align="left"><img src=
173"images/callouts/3.png" alt="3" border="0"></td>
174<td valign="top" align="left">
175<p>Init program</p>
176</td>
177</tr>
178</table>
179</div>
180</div>
181</div>
182</div>
183<br class="figure-break">
184<div class="sect3" lang="en">
185<div class="titlepage">
186<div>
187<div>
188<h4 class="title"><a name="datafiletxt" id=
189"datafiletxt"></a>1.1.1.&nbsp;File name</h4>
190</div>
191</div>
192</div>
193<p>the name of the data file. The name can be typed directly in the
194window provided, or selected with the help of the <span class=
195"guibutton">browse</span> button.</p>
196</div>
197<div class="sect3" lang="en">
198<div class="titlepage">
199<div>
200<div>
201<h4 class="title"><a name="initmethodtxt" id=
202"initmethodtxt"></a>1.1.2.&nbsp;Grid initalization method</h4>
203</div>
204</div>
205</div>
206<p>+++</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.&nbsp;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&nbsp;2.&nbsp;Window xxx 1</b></p>
219<div class="figure-contents">
220<div class="mediaobjectco"><img border="0" usemap="d0e143" src=
221"figpng/xxx_0102.png" alt="Window xxx 1"><map name="d0e143" id=
222"d0e143"></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</div>
232</div>
233<div class="sect2" lang="en">
234<div class="titlepage">
235<div>
236<div>
237<h3 class="title"><a name="wigdets" id=
238"wigdets"></a>1.2.&nbsp;Description of XXX window</h3>
239</div>
240</div>
241</div>
242<p>Now the XXX window will open.</p>
243<div class="figure"><a name="fig_xxx_0201" id="fig_xxx_0201"></a>
244<p class="title"><b>Figure&nbsp;3.&nbsp;Window xxx 2</b></p>
245<div class="figure-contents">
246<div class="mediaobjectco"><img border="0" usemap="d0e168" src=
247"figpng/xxx_0201.png" alt="Window xxx 2"><map name="d0e168" id=
248"d0e168">
249<area shape="rect" coords="3,606,97,579">
250<area shape="rect" coords="108,606,325,577">
251<area shape="rect" coords="5,571,44,544">
252<area shape="rect" coords="70,571,193,544">
253<area shape="rect" coords="209,570,323,545">
254<area shape="rect" coords="2,535,344,513">
255<area shape="rect" coords="2,504,346,470">
256<area shape="rect" coords="2,461,212,414">
257<area shape="rect" coords="16,403,308,183">
258<area shape="rect" coords="1,172,345,50"></map>
259<div class="calloutlist">
260<table border="0" summary="Callout list">
261<tr>
262<td width="5%" valign="top" align="left"><img src=
263"images/callouts/1.png" alt="1" border="0"></td>
264<td valign="top" align="left">
265<p>Plot type</p>
266</td>
267</tr>
268<tr>
269<td width="5%" valign="top" align="left"><img src=
270"images/callouts/2.png" alt="2" border="0"></td>
271<td valign="top" align="left">
272<p>Menu</p>
273</td>
274</tr>
275<tr>
276<td width="5%" valign="top" align="left"><img src=
277"images/callouts/3.png" alt="3" border="0"></td>
278<td valign="top" align="left">
279<p>OK</p>
280</td>
281</tr>
282<tr>
283<td width="5%" valign="top" align="left"><img src=
284"images/callouts/4.png" alt="4" border="0"></td>
285<td valign="top" align="left">
286<p>Page layout</p>
287</td>
288</tr>
289<tr>
290<td width="5%" valign="top" align="left"><img src=
291"images/callouts/5.png" alt="5" border="0"></td>
292<td valign="top" align="left">
293<p>Variables list</p>
294</td>
295</tr>
296<tr>
297<td width="5%" valign="top" align="left"><img src=
298"images/callouts/6.png" alt="6" border="0"></td>
299<td valign="top" align="left">
300<p>Files list</p>
301</td>
302</tr>
303<tr>
304<td width="5%" valign="top" align="left"><img src=
305"images/callouts/7.png" alt="7" border="0"></td>
306<td valign="top" align="left">
307<p>Command text</p>
308</td>
309</tr>
310<tr>
311<td width="5%" valign="top" align="left"><img src=
312"images/callouts/8.png" alt="8" border="0"></td>
313<td valign="top" align="left">
314<p>Calendar</p>
315</td>
316</tr>
317<tr>
318<td width="5%" valign="top" align="left"><img src=
319"images/callouts/9.png" alt="9" border="0"></td>
320<td valign="top" align="left">
321<p>Domdef</p>
322</td>
323</tr>
324<tr>
325<td width="5%" valign="top" align="left"><img src=
326"images/callouts/10.png" alt="10" border="0"></td>
327<td valign="top" align="left">
328<p>Spefications</p>
329</td>
330</tr>
331</table>
332</div>
333</div>
334</div>
335</div>
336<p><br class="figure-break"></p>
337<p>It's configuration will change depending on whether you are in
338portrait or in landscape, but here are the different parts
339available for your use.</p>
340<div class="sect3" lang="en">
341<div class="titlepage">
342<div>
343<div>
344<h4 class="title"><a name="plottypetxt" id=
345"plottypetxt"></a>1.2.1.&nbsp;Plot type list</h4>
346</div>
347</div>
348</div>
349<p>allows specification of the type of plot desired.</p>
350<div class="figure"><a name="fig_xxx_0202" id="fig_xxx_0202"></a>
351<p class="title"><b>Figure&nbsp;4.&nbsp;</b></p>
352<div class="figure-contents">
353<div class="mediaobjectco"><img border="0" usemap="d0e228" src=
354"figpng/xxx_0202.png"><map name="d0e228" id="d0e228"></map></div>
355</div>
356</div>
357<p><br class="figure-break"></p>
358<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
359<h3 class="title">Note</h3>
360<p>If the type <code class="constant">plt</code> is selected, the
361selection of plot type is made by mouse. Cf <a href="#mouse" title=
362"2.3.&nbsp;Mouse actions in the graphics window on a horizontal plot">
363Section&nbsp;2.3, &ldquo;Mouse actions in the graphics window on a
364horizontal plot&rdquo;</a></p>
365</div>
366</div>
367<div class="sect3" lang="en">
368<div class="titlepage">
369<div>
370<div>
371<h4 class="title"><a name="menutxt" id=
372"menutxt"></a>1.2.2.&nbsp;The menu bar made up of 3 submenus</h4>
373</div>
374</div>
375</div>
376<div class="sect4" lang="en">
377<div class="titlepage">
378<div>
379<div>
380<h5 class="title"><a name="filesubmenu" id=
381"filesubmenu"></a>1.2.2.1.&nbsp;<span class=
382"guisubmenu">File</span> submenu</h5>
383</div>
384</div>
385</div>
386<div class="figure"><a name="fig_xxx_0203" id="fig_xxx_0203"></a>
387<p class="title"><b>Figure&nbsp;5.&nbsp;</b></p>
388<div class="figure-contents">
389<div class="mediaobjectco"><img border="0" usemap="d0e252" src=
390"figpng/xxx_0203.png"><map name="d0e252" id="d0e252"></map></div>
391</div>
392</div>
393<p><br class="figure-break"></p>
394<div class="itemizedlist">
395<ul type="disc">
396<li>
397<p><span class="guimenuitem">Open:</span> to open a second file.
398Same procedure as during the launching of XXX. The new file can be
399on a different grid, with different variables, with a different
400time base.</p>
401</li>
402<li>
403<p><span class="guimenuitem">New XXX:</span> to open a second XXX
404window identical to the first.</p>
405</li>
406<li>
407<p><span class="guimenuitem">Close:</span> to close the XXX
408window.</p>
409</li>
410</ul>
411</div>
412</div>
413<div class="sect4" lang="en">
414<div class="titlepage">
415<div>
416<div>
417<h5 class="title"><a name="saveassubmenu" id=
418"saveassubmenu"></a>1.2.2.2.&nbsp;<span class="guisubmenu">Save
419As</span> submenu</h5>
420</div>
421</div>
422</div>
423<div class="figure"><a name="fig_xxx_0204" id="fig_xxx_0204"></a>
424<p class="title"><b>Figure&nbsp;6.&nbsp;</b></p>
425<div class="figure-contents">
426<div class="mediaobjectco"><img border="0" usemap="d0e286" src=
427"figpng/xxx_0204.png"><map name="d0e286" id="d0e286"></map></div>
428</div>
429</div>
430<p><br class="figure-break"></p>
431<div class="itemizedlist">
432<ul type="disc">
433<li>
434<p><span class="guimenuitem">Postscript:</span> to save in
435Postscript format</p>
436</li>
437<li>
438<p><span class="guimenuitem">Animations:</span> to create an
439animation from the XXX window. Careful, the creation of an
440animation is only possible if none of the plots have a time axis,
441and if the plots are all on the same time base (calendar). On the
442other hand, animations of horizontal and vertical plots, with
443different color palettes (for those not on an X-terminal), are
444possible.</p>
445</li>
446<li>
447<p><span class="guimenuitem">Image:</span> to save a gif of the XXX
448graphics window.</p>
449</li>
450<li>
451<p><span class="guimenuitem">Script:</span> to save the command
452history that has created the plot. For example if I save the
453commands in <code class="filename">xxx_figure.pro</code>, I can
454then launch a new IDL session and type:</p>
455<pre class="screen">
456<code class="prompt">idl&gt;</code> <strong class=
457"userinput"><code>@init</code></strong>
458<code class="prompt">idl&gt;</code> <strong class=
459"userinput"><code>xxx_figure</code></strong>
460</pre>
461<p>and I'll obtain the saved figure.</p>
462<pre class="screen">
463<code class="prompt">idl&gt;</code> <strong class=
464"userinput"><code>xxx_figure,/post </code></strong>
465</pre>
466<p>or</p>
467<pre class="screen">
468<code class="prompt">idl&gt;</code> <strong class=
469"userinput"><code>@ps</code></strong>
470</pre>
471<p>will then create a Postscript file of the figure.</p>
472</li>
473<li>
474<p><span class="guimenuitem">Prompt:</span> lists in the IDL window
475the command history that created the last plot. Useful primarily
476for debugging...</p>
477</li>
478</ul>
479</div>
480</div>
481<div class="sect4" lang="en">
482<div class="titlepage">
483<div>
484<div>
485<h5 class="title"><a name="flagsubmenu" id=
486"flagsubmenu"></a>1.2.2.3.&nbsp;<span class="guisubmenu">Flag
487options</span> submenu</h5>
488</div>
489</div>
490</div>
491<div class="figure"><a name="fig_xxx_0205" id="fig_xxx_0205"></a>
492<p class="title"><b>Figure&nbsp;7.&nbsp;</b></p>
493<div class="figure-contents">
494<div class="mediaobjectco"><img border="0" usemap="d0e368" src=
495"figpng/xxx_0205.png"><map name="d0e368" id="d0e368"></map></div>
496</div>
497</div>
498<p><br class="figure-break"></p>
499<div class="itemizedlist">
500<ul type="disc">
501<li>
502<p><span class="guibutton">Portrait/Landscape:</span> changes the
503configuration of the plot.</p>
504</li>
505<li>
506<p><span class="guibutton">Overlay:</span> to plot contours of a
507different field on top the one represented as color-filled
508contours. It is necessary to relaunch the entire plot to make this
509work!</p>
510</li>
511<li>
512<p><span class="guibutton">Vecteur:</span> to plot a vector field
513on top of contours. Only works on horizontal plots (<code class=
514"filename">plt.pro</code>). As for Overlay, a relaunch of the
515entire plot is necessary.</p>
516</li>
517<li>
518<p><span class="guibutton">Longitude / x index:</span> switches
519longitude labelling of the plot subdomain from degrees to indices
520following i.</p>
521</li>
522<li>
523<p><span class="guibutton">Latitude / y index:</span> switches
524latitude labelling of the plot subdomain from degrees to indices
525following j.</p>
526</li>
527</ul>
528</div>
529</div>
530</div>
531<div class="sect3" lang="en">
532<div class="titlepage">
533<div>
534<div>
535<h4 class="title"><a name="oktxt" id="oktxt"></a>1.2.3.&nbsp;OK
536button</h4>
537</div>
538</div>
539</div>
540<p>click on this <span class="guibutton">OK</span> button is
541required to make a new plot appear</p>
542</div>
543<div class="sect3" lang="en">
544<div class="titlepage">
545<div>
546<div>
547<h4 class="title"><a name="pagelayouttxt" id=
548"pagelayouttxt"></a>1.2.4.&nbsp;Page Layout</h4>
549</div>
550</div>
551</div>
552<p>specify the number of columns and rows for plots on the sheet of
553paper.</p>
554<div class="figure"><a name="fig_xxx_0206" id="fig_xxx_0206"></a>
555<p class="title"><b>Figure&nbsp;8.&nbsp;</b></p>
556<div class="figure-contents">
557<div class="mediaobjectco"><img border="0" usemap="d0e422" src=
558"figpng/xxx_0206.png"><map name="d0e422" id="d0e422"></map></div>
559</div>
560</div>
561<p><br class="figure-break"></p>
562</div>
563<div class="sect3" lang="en">
564<div class="titlepage">
565<div>
566<div>
567<h4 class="title"><a name="variableslisttxt" id=
568"variableslisttxt"></a>1.2.5.&nbsp;<span class="guimenuitem">List
569of variables</span></h4>
570</div>
571</div>
572</div>
573<p>you can choose the variable to work on.</p>
574<div class="figure"><a name="fig_xxx_0207" id="fig_xxx_0207"></a>
575<p class="title"><b>Figure&nbsp;9.&nbsp;</b></p>
576<div class="figure-contents">
577<div class="mediaobjectco"><img border="0" usemap="d0e437" src=
578"figpng/xxx_0207.png"><map name="d0e437" id="d0e437"></map></div>
579</div>
580</div>
581<p><br class="figure-break"></p>
582</div>
583<div class="sect3" lang="en">
584<div class="titlepage">
585<div>
586<div>
587<h4 class="title"><a name="fileslisttxt" id=
588"fileslisttxt"></a>1.2.6.&nbsp;<span class="guimenuitem">List of
589open files</span></h4>
590</div>
591</div>
592</div>
593<p>you can choose the file to work on.</p>
594<div class="figure"><a name="fig_xxx_0208" id="fig_xxx_0208"></a>
595<p class="title"><b>Figure&nbsp;10.&nbsp;</b></p>
596<div class="figure-contents">
597<div class="mediaobjectco"><img border="0" usemap="d0e452" src=
598"figpng/xxx_0208.png"><map name="d0e452" id="d0e452"></map></div>
599</div>
600</div>
601<p><br class="figure-break"></p>
602</div>
603<div class="sect3" lang="en">
604<div class="titlepage">
605<div>
606<div>
607<h4 class="title"><a name="commandtexttxt" id=
608"commandtexttxt"></a>1.2.7.&nbsp;<span class="guimenuitem">Command
609text</span></h4>
610</div>
611</div>
612</div>
613<p>To specify the computation you want to do +++ donner plus
614d'infos et des examples</p>
615<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
616<h3 class="title">Note</h3>
617<p>In the default case, the name given to a field is of no
618importance.</p>
619</div>
620</div>
621<div class="sect3" lang="en">
622<div class="titlepage">
623<div>
624<div>
625<h4 class="title"><a name="calendartxt" id=
626"calendartxt"></a>1.2.8.&nbsp;Calendar</h4>
627</div>
628</div>
629</div>
630<p>The calendar is made up of two droplists, which allow
631specification of two dates, the beginning and end of a time series,
632or the period over which to average before plotting.</p>
633</div>
634<div class="sect3" lang="en">
635<div class="titlepage">
636<div>
637<div>
638<h4 class="title"><a name="domdeftxt" id=
639"domdeftxt"></a>1.2.9.&nbsp;Define the domain</h4>
640</div>
641</div>
642</div>
643<p>A series of widgets that allow specification of the min/max
644limits of the domain in longitude/x-index, latitude/y-index, and
645depth in levels or meters. For depth, one can specify in levels for
646a horizontal plot, and in meters for a vertical plot.</p>
647</div>
648<div class="sect3" lang="en">
649<div class="titlepage">
650<div>
651<div>
652<h4 class="title"><a name="specificationstxt" id=
653"specificationstxt"></a>1.2.10.&nbsp;specify your plot</h4>
654</div>
655</div>
656</div>
657<p>You can specify the min, max, and contour interval by filling
658out the provided boxes! For the color palette, you can either
659specify the name or go search for one among the palettes
660available.</p>
661<p>The "keywords" window allows specification of all desired
662keywords. These keywords can be those of <code class=
663"filename">plt.pro</code>, <code class="filename">pltt.pro</code>,
664<code class="filename">pltz.pro</code>, <code class=
665"filename">plt1d.pro</code>, or those of contour, plot, or all
666other programs that are used. Cf <a href="#example1" title=
667"2.1.&nbsp;First plots">Section&nbsp;2.1, &ldquo;First
668plots&rdquo;</a></p>
669</div>
670</div>
671</div>
672<div class="sect1" lang="en">
673<div class="titlepage">
674<div>
675<div>
676<h2 class="title" style="clear: both"><a name="examples" id=
677"examples"></a>2.&nbsp;Concrete examples of XXX in practice</h2>
678</div>
679</div>
680</div>
681<div class="sect2" lang="en">
682<div class="titlepage">
683<div>
684<div>
685<h3 class="title"><a name="example1" id=
686"example1"></a>2.1.&nbsp;First plots</h3>
687</div>
688</div>
689</div>
690<p>One single file, one single plot per page</p>
691<p>Click on OK.</p>
692<p>Test the various basic functions: change the dates, the zoom,
693the field...</p>
694<p>Specify the min, max, and contour interval in the provided
695boxes.</p>
696<p>Add some keywords in the "keywords:" box, for example:</p>
697<div class="blockquote">
698<blockquote class="blockquote">
699<p>/nocontour, /carte</p>
700</blockquote>
701</div>
702<p>or the keywords for a northern hortographic polar
703projection:</p>
704<div class="blockquote">
705<blockquote class="blockquote">
706<p>/nocontour, map=[90,0,0], /horto</p>
707</blockquote>
708</div>
709<p>Test the various possibilities in the <span class="guimenu">Save
710As</span> menu.</p>
711<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
712<h3 class="title">Note</h3>
713<p>the creation of animations has a tendency to saturate the video
714memory of X-terminals, crashing the entire program...</p>
715</div>
716<p>Test the various possibilities in the <span class="guimenu">Flag
717options</span> menu.</p>
718<div class="caution" style=
719"margin-left: 0.5in; margin-right: 0.5in;">
720<h3 class="title">Caution</h3>
721<p>Careful, a selected option remains selected until it is
722reclicked.</p>
723</div>
724</div>
725<div class="sect2" lang="en">
726<div class="titlepage">
727<div>
728<div>
729<h3 class="title"><a name="example2" id=
730"example2"></a>2.2.&nbsp;Work with more than one file</h3>
731</div>
732</div>
733</div>
734<p>Open some other files and go between them by selecting them from
735the file list... Note that the different widgets (calendar, domain,
736...) follow the different file characteristics.</p>
737</div>
738<div class="sect2" lang="en">
739<div class="titlepage">
740<div>
741<div>
742<h3 class="title"><a name="mouse" id="mouse"></a>2.3.&nbsp;Mouse
743actions in the graphics window on a horizontal plot</h3>
744</div>
745</div>
746</div>
747<p>Select a domain and select the horizontal plot (<code class=
748"constant">plt</code>), vertical plot (<code class=
749"constant">pltz</code>), or the hovmoeller plot (<code class=
750"constant">pltt</code>):</p>
751<p>The domain we'd like to select for the plot is determined by one
752of its diagonals, defined therefore by two points. The first point
753is defined when the mouse button is pushed, then the mouse is
754moved, and the second point is defined as the mouse button is
755released (click-drag). The domains are thus defined by a long click
756(<abbr class="abbrev">LC</abbr>). To determine which type of plot
757should be made of selection, use:</p>
758<p>If the plot selector is on <code class="constant">plt</code></p>
759<div class="itemizedlist">
760<ul type="disc">
761<li>
762<p>the left mouse button to create horizontal plots (<code class=
763"constant">plt</code>)</p>
764</li>
765<li>
766<p>the middle mouse button to create vertical plots (<code class=
767"constant">pltz</code>)</p>
768</li>
769<li>
770<p>the right mouse button to create common hovmoellers for xt and
771yt cuts (<code class="constant">pltt</code>)</p>
772</li>
773</ul>
774</div>
775<p>In summary:</p>
776<div class="itemizedlist">
777<ul type="disc">
778<li>
779<div class="figure"><a name="fig_mousell" id="fig_mousell"></a>
780<p class="title"><b>Figure&nbsp;11.&nbsp;<abbr class=
781"abbrev">LCL</abbr>---&gt;<code class="constant">plt</code></b></p>
782<div class="figure-contents">
783<div class="mediaobjectco"><img border="0" usemap="d0e602" src=
784"figpng/xxx_mousell.png" alt="LCL---&gt;plt"><map name="d0e602" id=
785"d0e602"></map></div>
786</div>
787</div>
788<p><br class="figure-break"></p>
789</li>
790<li>
791<div class="figure"><a name="fig_mouselm" id="fig_mouselm"></a>
792<p class="title"><b>Figure&nbsp;12.&nbsp;<abbr class=
793"abbrev">LCM</abbr>---&gt;<code class=
794"constant">pltz</code></b></p>
795<div class="figure-contents">
796<div class="mediaobjectco"><img border="0" usemap="d0e617" src=
797"figpng/xxx_mouselm.png" alt="LCM---&gt;pltz"><map name="d0e617"
798id="d0e617"></map></div>
799</div>
800</div>
801<p><br class="figure-break"></p>
802</li>
803<li>
804<div class="figure"><a name="fig_mouselr" id="fig_mouselr"></a>
805<p class="title"><b>Figure&nbsp;13.&nbsp;<abbr class=
806"abbrev">LCR</abbr>---&gt;<code class=
807"constant">pltt</code></b></p>
808<div class="figure-contents">
809<div class="mediaobjectco"><img border="0" usemap="d0e632" src=
810"figpng/xxx_mouselr.png" alt="LCR---&gt;pltt"><map name="d0e632"
811id="d0e632"></map></div>
812</div>
813</div>
814<p><br class="figure-break"></p>
815</li>
816</ul>
817</div>
818<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
819<h3 class="title">Note</h3>
820<p>If the plot selector is on something other than <code class=
821"constant">plt</code> the indicated plot type is made.</p>
822</div>
823</div>
824<div class="sect2" lang="en">
825<div class="titlepage">
826<div>
827<div>
828<h3 class="title"><a name="multipleplots" id=
829"multipleplots"></a>2.4.&nbsp;Create multiple plots on the same
830sheet and make them interact</h3>
831</div>
832</div>
833</div>
834<p>Select the number of columns and rows for the page.</p>
835<p>Create a first plot. It will appear in the first frame.</p>
836<p>To create a plot in another frame double-click in the frame with
837the middle button (<abbr class="abbrev">DCM</abbr>). A black dotted
838frame will surround the designated frame, the &ldquo;<span class=
839"quote">target</span>&rdquo; frame. A black frame will surround the
840first plot. This is the &ldquo;<span class=
841"quote">reference</span>&rdquo; frame, in other words the one that
842all the XXX widgets refer to. Change for example the date and
843create a new plot. With a left button double-click in the first
844frame, all the widgets change and refer again to the first plot. A
845double-click with the right button in the second frame will erase
846the plot.</p>
847<p>In summary:</p>
848<div class="itemizedlist">
849<ul type="disc">
850<li>
851<div class="figure"><a name="fig_mousedl" id="fig_mousedl"></a>
852<p class="title"><b>Figure&nbsp;14.&nbsp;<abbr class=
853"abbrev">DCL</abbr>---&gt;&ldquo;<span class=
854"quote">reference</span>&rdquo; frame</b></p>
855<div class="figure-contents">
856<div class="mediaobjectco"><img border="0" usemap="d0e676" src=
857"figpng/xxx_mousedl.png" alt="DCL---&gt;reference frame"><map name=
858"d0e676" id="d0e676"></map></div>
859</div>
860</div>
861<p><br class="figure-break"></p>
862</li>
863<li>
864<div class="figure"><a name="fig_mousedm" id="fig_mousedm"></a>
865<p class="title"><b>Figure&nbsp;15.&nbsp;<abbr class=
866"abbrev">DCM</abbr>---&gt;&ldquo;<span class=
867"quote">target</span>&rdquo; frame</b></p>
868<div class="figure-contents">
869<div class="mediaobjectco"><img border="0" usemap="d0e692" src=
870"figpng/xxx_mousedm.png" alt="DCM---&gt;target frame"><map name=
871"d0e692" id="d0e692"></map></div>
872</div>
873</div>
874<p><br class="figure-break"></p>
875</li>
876<li>
877<div class="figure"><a name="fig_mousedr" id="fig_mousedr"></a>
878<p class="title"><b>Figure&nbsp;16.&nbsp;<abbr class=
879"abbrev">DCR</abbr>---&gt;erase the frame</b></p>
880<div class="figure-contents">
881<div class="mediaobjectco"><img border="0" usemap="d0e705" src=
882"figpng/xxx_mousedr.png" alt="DCR---&gt;erase the frame"><map name=
883"d0e705" id="d0e705"></map></div>
884</div>
885</div>
886<p><br class="figure-break"></p>
887</li>
888</ul>
889</div>
890<p>Here's a series of commands to show how this works.</p>
891<div class="procedure">
892<ol type="1">
893<li>
894<p>Select a 3-D field and create 6 frames for the sheet of
895paper.</p>
896</li>
897<li>
898<p>Create a horizontal plot in Frame 1</p>
899</li>
900<li>
901<p><abbr class="abbrev">DCM</abbr> in frame 2, <abbr class=
902"abbrev">LCL</abbr> on the plot in frame 1, to create a horizontal
903zoom in frame 2.</p>
904<p><abbr class="abbrev">DCM</abbr> in frame 3, <abbr class=
905"abbrev">LCM</abbr> on the plot in frame 1, to create a vertical
906cut in frame 3.</p>
907<p><abbr class="abbrev">DCM</abbr> in frame 4, <abbr class=
908"abbrev">LCR</abbr> on the plot in frame 1, to create a hovmoeller
909in frame 4.</p>
910</li>
911</ol>
912</div>
913<div class="procedure">
914<p>To redo the hovmoeller with the keyword</p>
915<div class="literallayout">
916<p>/nocontour</p>
917</div>
918<ol type="1">
919<li>
920<p><abbr class="abbrev">DCL</abbr> in frame 4 which now becomes the
921reference and target frame.</p>
922</li>
923<li>
924<p>Add the keyword</p>
925<div class="literallayout">
926<p>/nocontour</p>
927</div>
928</li>
929<li>
930<p>click <span class="guibutton">OK</span>, and the plot is
931redone.</p>
932</li>
933</ol>
934</div>
935<div class="procedure">
936<p>in frame 5, let's create the same plot as in frame 2 except with
937different dates</p>
938<ol type="1">
939<li>
940<p><abbr class="abbrev">DCL</abbr> on frame 2</p>
941</li>
942<li>
943<p><abbr class="abbrev">DCM</abbr> on frame 5</p>
944</li>
945<li>
946<p>change the date</p>
947</li>
948<li>
949<p>click on <span class="guibutton">OK</span> , and voil&agrave;,
950the new plot.</p>
951</li>
952</ol>
953</div>
954</div>
955</div>
956<div class="sect1" lang="en">
957<div class="titlepage">
958<div>
959<div>
960<h2 class="title" style="clear: both"><a name="crash" id=
961"crash"></a>3.&nbsp;How to quit when it crashes</h2>
962</div>
963</div>
964</div>
965<div class="orderedlist">
966<ol type="1">
967<li>
968<p>in the IDL window, type</p>
969<pre class="screen">
970<code class="prompt">idl&gt;</code> <strong class=
971"userinput"><code>retall</code></strong>
972</pre></li>
973<li>
974<p><abbr class="abbrev">DCR</abbr> to erase the problem frame</p>
975</li>
976<li>
977<p>press the <span class="guibutton">clear</span> button</p>
978</li>
979<li>
980<p>change the orientation of the plot</p>
981</li>
982<li>
983<p>quit XXX cleanly using <span class="guibutton">quit</span> from
984the <span class="guimenu">File</span> menu</p>
985</li>
986</ol>
987</div>
988<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
989<h3 class="title">Note</h3>
990<p>Always avoid if at all possible closing and killing the XXX
991window, but rather select <span class="guibutton">quit</span> from
992the <span class="guimenu">File</span> menu. XXX uses a large number
993of pointers, and wantonly killing the window will leave a large
994number of unused variables in memory, which could in the end
995overflow. To clean up this memory:</p>
996<pre class="screen">
997<code class="prompt">idl&gt;</code> <strong class=
998"userinput"><code>ptr_free, ptr_valid()</code></strong>
999</pre></div>
1000</div>
1001</div>
1002</body>
1003</html>
Note: See TracBrowser for help on using the repository browser.