source: trunk/SRC/Documentation/xmldoc/wiki/MiniNotice @ 347

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

add wiki production tools and outputs
File size: 51.9 KB
Line 
1{{{
2#!html
3<div xmlns="http://www.w3.org/1999/xhtml" class="article" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="mini_notice" id="mini_notice"/> Mini Guide for Basic Commands in the XXX Program </h2></div><div><div class="authorgroup">
4      <div class="author"><h3 class="author"><span class="firstname">Sébastien</span> <span class="surname">Masson</span> <code class="email">&lt;<a href="mailto:Sebastien.Masson_at_locean-ipsl.upmc.fr">Sebastien.Masson_at_locean-ipsl.upmc.fr</a>&gt;</code></h3></div>
5      <div class="author"><h3 class="author"><span class="firstname">Albert</span> <span class="surname">Fisher</span> </h3></div>
6      <div class="author"><h3 class="author"><span class="firstname">Françoise</span> <span class="surname">Pinsard</span> <code class="email">&lt;<a href="mailto:Francoise.Pinsard_at_locean-ipsl.upmc.fr">Francoise.Pinsard_at_locean-ipsl.upmc.fr</a>&gt;</code></h3></div>
7      <div class="author"><h3 class="author"><span class="firstname">Steve</span> <span class="surname">Navarro</span> </h3></div>
8    </div></div><div><span class="pubdate">svn Id of xml source file : $Id: mini_notice.xml 345 2008-04-16 09:15:20Z pinsard $<br/><br/></span></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="2"><b>Revision History</b></th></tr>
9      <tr><td align="left">Revision 0.0</td><td align="left">May 29, 2000</td></tr><tr><td align="left" colspan="2">French release by Sébastien Masson</td></tr>
10      <tr><td align="left">Revision 0.1</td><td align="left">July, 2002</td></tr><tr><td align="left" colspan="2">Translation by Albert Fisher</td></tr>
11      <tr><td align="left">Revision 0.2</td><td align="left">July 20, 2006</td></tr><tr><td align="left" colspan="2">HTML to XML/Docbook migration by Françoise Pinsard</td></tr>
12      <tr><td align="left">Revision 1.0</td><td align="left">August, 2006</td></tr><tr><td align="left" colspan="2">Major update by Steve Navarro</td></tr>
13      <tr><td align="left">Revision 1.1</td><td align="left">September, 2006</td></tr><tr><td align="left" colspan="2">Review by Sébastien Masson</td></tr>
14      <tr><td align="left">Revision 1.2</td><td align="left">April 2008</td></tr><tr><td align="left" colspan="2">migration from DocBook 4.2 to Docbook 5.0</td></tr>
15
16     </table></div></div></div><hr/></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#launchxxx">1. Launching XXX</a></span></dt><dd><dl><dt><span class="sect2"><a href="#launch_xxx_1">1.1. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span></code></strong></a></span></dt><dt><span class="sect2"><a href="#launch_xxx_2">1.2. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>/separate</code></em></code></strong></a></span></dt><dt><span class="sect2"><a href="#launch_xxx_3">1.3. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>restore = 'file.dat'</code></em></code></strong></a></span></dt><dt><span class="sect2"><a href="#launch_xxx_4">1.4. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em></code></strong></a></span></dt><dt><span class="sect2"><a href="#launch_xxx_5">1.5. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>keywd1 = 
</code></em>, <em class="parameter"><code>keywd2 = 
</code></em></code></strong></a></span></dt><dt><span class="sect2"><a href="#launch_xxx_6">1.6. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>'initgrid'</code></em></code></strong></a></span></dt><dt><span class="sect2"><a href="#launch_xxx_7">1.7. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>'initgrid'</code></em>, <em class="parameter"><code>keywd1 = 
</code></em>, <em class="parameter"><code>keywd2 = 
</code></em></code></strong></a></span></dt><dt><span class="sect2"><a href="#launch_xxx_8">1.8. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>'initgrid'</code></em>, <em class="parameter"><code>'arg1, arg2, 
'</code></em></code></strong></a></span></dt></dl></dd><dt><span class="sect1"><a href="#wigdets">2. Description of XXX window</a></span></dt><dd><dl><dt><span class="sect2"><a href="#plottypetxt">2.1. Plot type list</a></span></dt><dt><span class="sect2"><a href="#menutxt">2.2. The menu bar made up of 3 sub-menus</a></span></dt><dt><span class="sect2"><a href="#oktxt">2.3. OK button</a></span></dt><dt><span class="sect2"><a href="#pagelayouttxt">2.4. Page Layout</a></span></dt><dt><span class="sect2"><a href="#variableslisttxt">2.5. List of variables</a></span></dt><dt><span class="sect2"><a href="#fileslisttxt">2.6. List of open files</a></span></dt><dt><span class="sect2"><a href="#commandtexttxt">2.7. <span class="guimenuitem">Command text</span></a></span></dt><dt><span class="sect2"><a href="#calendartxt">2.8. Calendar</a></span></dt><dt><span class="sect2"><a href="#domdeftxt">2.9. Define the domain</a></span></dt><dt><span class="sect2"><a href="#specificationstxt">2.10. Specify your plot</a></span></dt></dl></dd><dt><span class="sect1"><a href="#mouseactions">3. Mouse Actions</a></span></dt><dd><dl><dt><span class="sect2"><a href="#mouse">3.1. In the graphics window on a horizontal plot</a></span></dt><dt><span class="sect2"><a href="#multipleplots">3.2. Create multiple plots on the same sheet and make them interact</a></span></dt></dl></dd><dt><span class="sect1"><a href="#crash">4. What should I do when it breakdown</a></span></dt></dl></div>
17
18
19 
20
21
22<div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="launchxxx" id="launchxxx"/>1. Launching XXX</h2></div></div></div>
23
24<p>
25There is several ways to launch XXX which we will detail in the next sections:
26  </p><pre class="screen">
27    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span></code></strong>
28    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>/separate</code></em></code></strong>
29    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>restore = 'file.dat'</code></em></code></strong>
30    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em></code></strong>
31    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>keywd1 = 
</code></em>, <em class="parameter"><code>keywd2 = 
</code></em></code></strong>
32    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>'initgrid'</code></em></code></strong>
33    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>'initgrid'</code></em>, <em class="parameter"><code>keywd1 = 
</code></em>, <em class="parameter"><code>keywd2 = 
</code></em></code></strong>
34    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>'initgrid'</code></em>, <em class="parameter"><code>'arg1, arg2, 
'</code></em></code></strong>
35  </pre><p>
36</p>
37
38<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_1" id="launch_xxx_1"/>1.1. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span></code></strong></h3></div></div></div>
39  <p>
40    A window will open with 3 parts to consider.
41</p><div class="figure"><a name="fig_xxx_0101" id="fig_xxx_0101"/><p class="title"><b>Figure 1. Window xxx 1</b></p><div class="figure-contents">
42
43<div class="mediaobject"><img border="0" usemap="id2572796" src="figpng/xxx_0101.png" alt="Window xxx 1"/><map name="id2572796" id="id2572796"><area shape="rect" coords="27,298,504,249"/><area shape="rect" coords="81,242,450,183"/><area shape="rect" coords="3,175,538,36"/></map><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><img src="images/callouts/1.png" alt="1" border="0"/></td><td valign="top" align="left">
44<p>Data file name</p>
45</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/2.png" alt="2" border="0"/></td><td valign="top" align="left">
46<p>Grid initialization method</p>
47</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/3.png" alt="3" border="0"/></td><td valign="top" align="left">
48<p>Grid initialization parameters</p>
49</td></tr></table></div></div>
50</div></div><p><br class="figure-break"/>
51  </p>
52
53<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="datafiletxt" id="datafiletxt"/>1.1.1. Data file name</h4></div></div></div>
54  <p>
55    The name of the data file. It can be typed directly in the window provided, or selected with the help of the <span class="guibutton">browse</span> button.
56  </p>
57</div>
58<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="initmethodtxt" id="initmethodtxt"/>1.1.2. Grid initialization method</h4></div></div></div>
59  <p>
60    For visualising grilled data, you need to <a href="./firststeps.html#load_grid" target="_top">define the grid</a> on which are located the data. By default, "automatic grid construction with initncdf.pro" is checked. This means that the grid will be defined by using the informations contained in the data file (through the IDL prodecure <span><strong class="command">initncdf</strong></span>) without needing any other auxiliary file. If you checked "grid construction with other IDL batch or procedure", this means that you don't want to use the default <span><strong class="command">initncdf</strong></span> procedure to define the grid and you will provide your own IDL procedure or the so-called IDL batch file (a file which is called by using @, see IDL documentation).
61  </p>
62</div>
63<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="initprogramtxt" id="initprogramtxt"/>1.1.3. Grid initialization parameters</h4></div></div></div>
64  <p>
65    This third part allows you to specify the name, the argument and the keywords of the routine you want to use to initialize the grid.
66By default the name of the procedure is <span><strong class="command">initncdf</strong></span>, its argument will be automatically defined so you cannot change them. If you If you checked "grid construction with other IDL batch or procedure", you have to select the name of the IDL procedure or batch file and its suitable arguments and keywords. Note that if you select an IDL batch file you cannot give any parameter or keyword.
67    </p><div class="figure"><a name="fig_xxx_0102" id="fig_xxx_0102"/><p class="title"><b>Figure 2. Window xxx 1</b></p><div class="figure-contents">
68     
69      <div class="mediaobject"><img src="figpng/xxx_0102.png" alt="Window xxx 1"/></div>
70    </div></div><p><br class="figure-break"/>
71  </p>
72  <p>
73    Once these two lines have been completed, click on <span class="guibutton">let's go</span>.
74  </p>
75  <p>For example, we choose the IDL batch file "tst_initlev". Compare the result with "automatic grid construction with initncdf.pro" checked. Cf <a href="#fig_xxx_0404" title="Figure&#xA0;18.&#xA0;temperature of the ocean at depth 125 meters without proper land/sea mask">Figure 18, “temperature of the ocean at depth 125 meters without proper land/sea mask”</a>
76  </p>
77<p>
78  </p><div class="figure"><a name="fig_xxx_0103" id="fig_xxx_0103"/><p class="title"><b>Figure 3. Oceania at 125 meters of depth with proper grid initialization</b></p><div class="figure-contents">
79     
80<div class="mediaobject"><img src="figpng/xxx_0103.png" alt="Oceania at 125 meters of depth with proper grid initialization"/></div>
81  </div></div><p><br class="figure-break"/>
82</p>
83</div>
84</div>
85
86<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_2" id="launch_xxx_2"/>1.2. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>/separate</code></em></code></strong></h3></div></div></div>
87<p>
88This is the same as the simple <a href="#launch_xxx_1" title="1.1.&#xA0;idl&gt; xxx"><code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span></code></strong></a> except that once the xxx window open, you will have 2 separate windows (command and plotting window) instead of one.
89</p>
90</div>
91
92<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_3" id="launch_xxx_3"/>1.3. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>restore = 'file.dat'</code></em></code></strong></h3></div></div></div>
93<p>
94In that case xxx window will open directly in the same state as it was when the file "file.dat" was created. see <a href="#restore">+++++++</a>
95</p>
96</div>
97
98<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_4" id="launch_xxx_4"/>1.4. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em></code></strong></h3></div></div></div>
99<p>
100In this case, the xxx window directly open the data file 'file.nc' and build the grid automatically with the IDL procedure <span><strong class="command">initncdf</strong></span>. For example:
101  </p><pre class="screen">
102    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_1x1.nc'</code></em></code></strong>
103  </pre><p>
104</p>
105</div>
106
107<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_5" id="launch_xxx_5"/>1.5. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>keywd1 = 
</code></em>, <em class="parameter"><code>keywd2 = 
</code></em></code></strong></h3></div></div></div>
108<p>
109In this case, the xxx window directly open the data file 'file.nc', build the grid automatically with the IDL procedure <span><strong class="command">initncdf</strong></span> and use the keywords <strong class="userinput"><code><em class="parameter"><code>keywd1 = 
</code></em>, <em class="parameter"><code>keywd2 = 
</code></em></code></strong> in the call of <span><strong class="command">initncdf</strong></span>. For example:
110  </p><pre class="screen">
111    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_1x1.nc'</code></em>, <em class="parameter"><code>useasmask = 'votemper'</code></em>, <em class="parameter"><code>missing_value = 31.0720</code></em></code></strong>
112  </pre><p>
113</p>
114</div>
115
116<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_6" id="launch_xxx_6"/>1.6. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>'initgrid'</code></em></code></strong></h3></div></div></div>
117<p>
118In this case, the xxx window directly open the data file 'file.nc' and build the grid directly with the IDL procedure or batch file <span><strong class="command">initgrid</strong></span>
119  </p><pre class="screen">
120    <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'Levitus98_1m_01_12_Temperature_Pot_ORCA2.nc'</code></em>, <em class="parameter"><code>'tst_initorca2'</code></em></code></strong>
121  </pre><p>
122</p>
123</div>
124
125<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_7" id="launch_xxx_7"/>1.7. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>'initgrid'</code></em>, <em class="parameter"><code>keywd1 = 
</code></em>, <em class="parameter"><code>keywd2 = 
</code></em></code></strong></h3></div></div></div>
126<p>
127In this case, the xxx window directly open the data file 'file.nc', build the grid directly with the IDL procedure <span><strong class="command">initgrid</strong></span> and use the keywords <strong class="userinput"><code><em class="parameter"><code>keywd1 = 
</code></em>, <em class="parameter"><code>keywd2 = 
</code></em></code></strong> in the call of <span><strong class="command">initgrid</strong></span>.
128</p>
129</div>
130
131<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launch_xxx_8" id="launch_xxx_8"/>1.8. <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span><strong class="command">xxx</strong></span>, <em class="parameter"><code>'file.nc'</code></em>, <em class="parameter"><code>'initgrid'</code></em>, <em class="parameter"><code>'arg1, arg2, 
'</code></em></code></strong></h3></div></div></div>
132<p>
133In this case, the xxx window directly open the data file 'file.nc', build the grid directly with the IDL procedure <span><strong class="command">initgrid</strong></span> and use the string <strong class="userinput"><code><em class="parameter"><code>'arg1, arg2, 
'</code></em></code></strong> to specify the input arguments in the call of <span><strong class="command">initgrid</strong></span>.
134</p>
135</div>
136
137</div>
138
139<div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="wigdets" id="wigdets"/>2. Description of XXX window</h2></div></div></div>
140
141<p>
142
143</p><div class="figure"><a name="fig_xxx_0201" id="fig_xxx_0201"/><p class="title"><b>Figure 4. Window xxx 2</b></p><div class="figure-contents">
144
145<div class="mediaobject"><img border="0" usemap="id2573385" src="figpng/xxx_0201.png" alt="Window xxx 2"/><map name="id2573385" id="id2573385"><area shape="rect" coords="4,346,122,331"/><area shape="rect" coords="136,346,409,330"/><area shape="rect" coords="6,326,55,311"/><area shape="rect" coords="88,326,243,311"/><area shape="rect" coords="263,326,407,311"/><area shape="rect" coords="2,306,433,293"/><area shape="rect" coords="2,288,436,269"/><area shape="rect" coords="2,263,267,237"/><area shape="rect" coords="20,230,388,105"/><area shape="rect" coords="1,98,434,29"/></map><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><img src="images/callouts/1.png" alt="1" border="0"/></td><td valign="top" align="left">
146<p>Plot type</p>
147</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/2.png" alt="2" border="0"/></td><td valign="top" align="left">
148<p>Menu</p>
149</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/3.png" alt="3" border="0"/></td><td valign="top" align="left">
150<p>OK</p>
151</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/4.png" alt="4" border="0"/></td><td valign="top" align="left">
152<p>Page layout</p>
153</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/5.png" alt="5" border="0"/></td><td valign="top" align="left">
154<p>Variables list</p>
155</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/6.png" alt="6" border="0"/></td><td valign="top" align="left">
156<p>Files list</p>
157</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/7.png" alt="7" border="0"/></td><td valign="top" align="left">
158<p>Command text</p>
159</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/8.png" alt="8" border="0"/></td><td valign="top" align="left">
160<p>Calendar</p>
161</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/9.png" alt="9" border="0"/></td><td valign="top" align="left">
162<p>Domdef</p>
163</td></tr><tr><td width="5%" valign="top" align="left"><img src="images/callouts/10.png" alt="10" border="0"/></td><td valign="top" align="left">
164<p>Spefications</p>
165</td></tr></table></div></div>
166</div></div><p><br class="figure-break"/>
167</p>
168
169<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plottypetxt" id="plottypetxt"/>2.1. Plot type list</h3></div></div></div>
170<p>Allows specification of the type of plot desired.</p>
171<p>
172    </p><div class="figure"><a name="fig_xxx_0202" id="fig_xxx_0202"/><p class="title"><b>Figure 5. Different plot types available</b></p><div class="figure-contents">
173     
174<div class="mediaobject"><img src="figpng/xxx_0202.png" alt="Different plot types available"/></div>
175    </div></div><p><br class="figure-break"/>
176</p>
177<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
178<p>
179If the type <code class="constant">plt</code> is selected, the selection of plot type
180is made by mouse. Cf <a href="#mouse" title="3.1.&#xA0;In the graphics window on a horizontal plot">Section 3.1, “In the graphics window on a horizontal plot”</a></p>
181</div>
182</div>
183
184<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="menutxt" id="menutxt"/>2.2. The menu bar made up of 3 sub-menus</h3></div></div></div>
185<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="filesubmenu" id="filesubmenu"/>2.2.1. <span class="guibutton">File</span> sub-menu</h4></div></div></div>
186<p>
187    </p><div class="figure"><a name="fig_xxx_0203" id="fig_xxx_0203"/><p class="title"><b>Figure 6. The File menu</b></p><div class="figure-contents">
188     
189<div class="mediaobject"><img src="figpng/xxx_0203.png" alt="The File menu"/></div>
190    </div></div><p><br class="figure-break"/>
191</p>
192<p>
193</p><div class="itemizedlist"><ul type="disc"><li><p><span class="guisubmenu">Open:</span> to open a new file. Same procedure as during the <a href="#launch_xxx_1" title="1.1.&#xA0;idl&gt; xxx">launch of XXX</a>.
194The new file can be on a different grid, with different variables, with a different time base 

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