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

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

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

206</p></li><li><p><span class="guisubmenu">New XXX:</span> to open a second XXX window identical to the first one.</p></li><li><p><span class="guisubmenu">Quit:</span> to close the XXX window.</p></li></ul></div><p>
207</p>
208</div>
209<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="saveassubmenu" id="saveassubmenu"></a>2.2.2. <span class="guibutton">Save As</span> sub-menu</h4></div></div></div>
210<p>
211    </p><div class="figure"><a name="fig_xxx_0204" id="fig_xxx_0204"></a><p class="title"><b>Figure 7. The Save As menu</b></p><div class="figure-contents">
212     
213<div class="mediaobject"><img src="figpng/xxx_0204.png" alt="The Save As menu" /></div>
214    </div></div><p><br class="figure-break" />
215</p>
216<p>
217</p><div class="itemizedlist"><ul type="disc"><li><p><span class="guisubmenu">Postscript:</span> to save the plotting window in Postscript format</p></li><li><p><span class="guisubmenu">Animated gif:</span> to create an animation of the plotting window.
218</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The creation of an animation is only possible if none of the plots have a time axis, and if the plots are all on the same time base (calendar). On the other hand, animations of horizontal and vertical plots, with different color palettes (for those not on an X-terminal), are possible.</p></div><p>
219</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The creation of animations has a tendency to saturate the video memory of X-terminals, crashing the entire program 
</p></div><p>
220</p></li><li><p><span class="guisubmenu">Gif:</span> to save a gif of the plotting window.</p></li><li><p><span class="guisubmenu">IDL procedure:</span> to save the command history that has created the plot in an IDL procedure that can be re-executed later. For example if I save the commands in <code class="filename">xxx_figure.pro</code> file, when ever I want, I can then launch a new IDL session and type:
221  </p><pre class="screen">
222<code class="prompt">idl&gt;</code> <strong class="userinput"><code>@init</code></strong>
223<code class="prompt">idl&gt;</code> <strong class="userinput"><code>xxx_figure</code></strong>
224</pre><p>
225and I'll obtain the saved figure.
226  </p><pre class="screen">
227<code class="prompt">idl&gt;</code> <strong class="userinput"><code>xxx_figure,/post</code></strong>
228</pre><p>
229or
230  </p><pre class="screen">
231<code class="prompt">idl&gt;</code> <strong class="userinput"><code>@ps</code></strong>
232</pre><p>
233will then create a Postscript file of the figure.
234</p></li><li>
235<p><a name="restore" id="restore"></a><span class="guisubmenu">RESTORE kwd of xxx:</span> to save the xxx widget (all buttons and parameters stored in memory 
) in a binary file in order to quit xxx and relaunch it later like in <a href="#launch_xxx_3" title="1.3. idl&gt; xxx, restore = 'file.dat'">Section 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> and get exactly the same configuration.
236</p>
237</li><li>
238<p>
239<span class="guisubmenu">Print to prompt:</span> lists in the IDL window the command history that created the last plot. Useful primarily for debugging

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