1 | <?xml version='1.0' encoding='iso-8859-1'?> |
---|
2 | <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
---|
3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
---|
4 | [ |
---|
5 | <!ENTITY promptidl "idl>"> |
---|
6 | ] |
---|
7 | > |
---|
8 | <!-- |
---|
9 | |
---|
10 | ./SAXO_DIR/SRC/Documentation/xmldoc/mini_notice.xml |
---|
11 | |
---|
12 | update : |
---|
13 | fplod 2006-07-20T08:45:14Z aedon.locean-ipsl.upmc.fr (Darwin) |
---|
14 | . creation by hand made migration from mini_notice.html to XML/Docbook |
---|
15 | . installation part has been removed |
---|
16 | . add images |
---|
17 | ++ fake graphics callouts see forxxxdoc.sh |
---|
18 | |
---|
19 | --> |
---|
20 | <article lang="en"> |
---|
21 | <title> |
---|
22 | Mini Guide for Basic Commands in the XXX Program |
---|
23 | </title> |
---|
24 | <articleinfo> |
---|
25 | <authorgroup> |
---|
26 | <author><firstname>Sébastien</firstname><surname>Masson</surname><email>Sebastien.Masson_at_locean-ipsl.upmc.fr</email></author> |
---|
27 | <author><firstname>Albert</firstname><surname>Fisher</surname></author> |
---|
28 | <author><firstname>Françoise</firstname><surname>Pinsard</surname><email>Francoise.Pinsard_at_locean-ipsl.upmc.fr</email></author> |
---|
29 | <author><firstname>Steve</firstname><surname>Navarro</surname></author> |
---|
30 | </authorgroup> |
---|
31 | <keywordset> |
---|
32 | <keyword>idl</keyword> |
---|
33 | <keyword>SAXO</keyword> |
---|
34 | <keyword>xxx</keyword> |
---|
35 | </keywordset> |
---|
36 | <revhistory> |
---|
37 | <revision> |
---|
38 | <revnumber>0.0</revnumber> |
---|
39 | <date>May 29, 2000</date> |
---|
40 | <revremark>French release by Sébastien Masson</revremark> |
---|
41 | </revision> |
---|
42 | <revision> |
---|
43 | <revnumber>0.1</revnumber> |
---|
44 | <date>July, 2002</date> |
---|
45 | <revremark>Translation by Albert Fisher</revremark> |
---|
46 | </revision> |
---|
47 | <revision> |
---|
48 | <revnumber>0.2</revnumber> |
---|
49 | <date>July 20, 2006</date> |
---|
50 | <revremark>HTML to XML/Docbook migration by Françoise Pinsard</revremark> |
---|
51 | </revision> |
---|
52 | </revhistory> |
---|
53 | <pubdate>$Id$</pubdate> |
---|
54 | </articleinfo> |
---|
55 | |
---|
56 | |
---|
57 | <!-- |
---|
58 | La partie suivante n'a plus tellement de sens maintenant que tout SAXO est disponible sur forge |
---|
59 | <para> |
---|
60 | Where to find the source code |
---|
61 | </para> |
---|
62 | The scripts are available in the IDL_29_5_2000 directory. |
---|
63 | </para> |
---|
64 | <para> |
---|
65 | In this directory are |
---|
66 | <itemizedlist> |
---|
67 | <listitem><para>a tar file IDL_29_5_2000.tar with all the files</para></listitem> |
---|
68 | <listitem><para>the scripts in ASCII, in subdirectories by theme</para></listitem> |
---|
69 | </itemizedlist> |
---|
70 | |
---|
71 | <para> |
---|
72 | This IDL_29_5_2000 directory is available: |
---|
73 | <itemizedlist> |
---|
74 | <listitem><para>at LODYC: adonis.lodyc.jussieu.fr:/usr/home/smasson/IDL_29_5_2000</para></listitem> |
---|
75 | <listitem><para>at IPSL: cook.ipsl.jussieu.fr:/home/smlod/IDL_29_5_2000</para></listitem> |
---|
76 | <listitem><para>at IDRIS: rhodes.idris.fr:/home/rech/eee/reee217/IDL_29_5_2000</para></listitem> |
---|
77 | <listitem><para>on the anonymous ftp site of LODYC (contact <ulink url="mailto:smasson@lodyc.jussieu.fr">smasson@lodyc.jussieu.fr</ulink> |
---|
78 | for access).</para></listitem> |
---|
79 | <listitem><para>soon, from <ulink url="http://www.lodyc.jussieu.fr/~opatlod/SAXO/"/></para></listitem> |
---|
80 | </itemizedlist> |
---|
81 | </para> |
---|
82 | <para> |
---|
83 | This mini guide is also found in the IDL_29_5_2000 directory, in |
---|
84 | different formats. It is also consultable on the web at: |
---|
85 | </para> |
---|
86 | <para> |
---|
87 | <ulink url="http://www.ipsl.jussieu.fr/~smlod/mini_notice.html"/> |
---|
88 | </para> |
---|
89 | |
---|
90 | --> |
---|
91 | <!-- ++ n'a plus rien à faire ici |
---|
92 | <sect1 id="intro"><title>Introduction and assumptions</title> |
---|
93 | |
---|
94 | <para> |
---|
95 | This micro guide is unfortunately not a user's guide for all the |
---|
96 | scripts that have been written for IDL (version 5.2 or higher |
---|
97 | required). The goal is simply to clarify a few points on the use of the <filename>xxx.pro</filename> |
---|
98 | program. |
---|
99 | </para> |
---|
100 | <para> |
---|
101 | For further help on the furnished scripts, here are |
---|
102 | several possibilities: |
---|
103 | |
---|
104 | <itemizedlist> |
---|
105 | <listitem><para>execute in IDL the command |
---|
106 | <screen format="linespecific"> |
---|
107 | <prompt>&promptidl;</prompt> <userinput>xhelp, '<replaceable>script_name</replaceable>'</userinput> |
---|
108 | </screen> |
---|
109 | </para></listitem> |
---|
110 | <listitem><para>consult the IDL online help for scripts whose source is unavailable</para></listitem> |
---|
111 | <listitem><para> |
---|
112 | subscribe to the mailing list for updates and user questions/responses |
---|
113 | </para> |
---|
114 | <para> |
---|
115 | to subscribe, send a mail to: <ulink url="mailto:majordomo@lmd.jussieu.fr">majordomo@lmd.jussieu.fr</ulink> |
---|
116 | with no subject, containing the message: |
---|
117 | <userinput>subscribe forum-idl <replaceable>e-mail address</replaceable></userinput> |
---|
118 | </para></listitem> |
---|
119 | <listitem><para>consult the archives of this mail list: |
---|
120 | <ulink url="http://www.lmd.jussieu.fr/archives/form-idl/last/mail1.html"/></para></listitem> |
---|
121 | <listitem><para>consult in desperation the feeble web pages we have started to write |
---|
122 | (while waiting for something better) |
---|
123 | <ulink url="http://www.ipsl.jussieu.fr/~smlod/"/></para></listitem> |
---|
124 | <listitem><para>wait until we write a full user's manual!</para></listitem> |
---|
125 | </itemizedlist> |
---|
126 | </para> |
---|
127 | |
---|
128 | <para> |
---|
129 | The XXX widget is a layer on top of the scripts in the <application>SAXO</application> package |
---|
130 | (themselves layered on top of IDL). It is designed to permit the |
---|
131 | visualization and rapid exploration of data, offering a maximum in |
---|
132 | options, while not necessarily all those offered by the package and by |
---|
133 | IDL. |
---|
134 | </para> |
---|
135 | <para> |
---|
136 | Based on the use of files in the NetCDF format, it can easily work |
---|
137 | with other file formats. For this, all that is necessary is to write |
---|
138 | an IDL function capable of extracting a matrix from a file as a |
---|
139 | function of the following parameters: the variable name, two dates, an |
---|
140 | experiment name, and a domain. |
---|
141 | </para> |
---|
142 | <para> |
---|
143 | Developed to visualize the output of the OPA model, the <application>SAXO</application> package was |
---|
144 | conceived to work on C grids. To use it on grids where the T, U, and |
---|
145 | V points are the same, one must nevertheless declare the parameters of |
---|
146 | the grid that correspond to the U and V points. Careful, for this |
---|
147 | type of discretization, the calculation scripts of type <filename>div.pro</filename> and |
---|
148 | <filename>curl.pro</filename> are wrong. |
---|
149 | </para> |
---|
150 | <para> |
---|
151 | The averaging routines are not adapted to warped grids, they sum |
---|
152 | following the i, j, and k indices, weighting each point by scale |
---|
153 | factors and the land-sea mask. Slices and Hovmoellers do not work in |
---|
154 | the diagonal, but are always done following i, j, or k. When a domain |
---|
155 | is given to one of the scripts, an average over the domain in the |
---|
156 | directions perpendicular to that displayed is automatically made before |
---|
157 | display. |
---|
158 | </para> |
---|
159 | <para> |
---|
160 | Before continuing on to the practical part of this guide, the |
---|
161 | installation and use of the <application>SAXO</application> package, I'd like to thank Guillaume |
---|
162 | Roullet, who also participated in the writing of the scripts in the |
---|
163 | package (notably the drawing of vectors on warped grids). |
---|
164 | </para> |
---|
165 | </sect1> |
---|
166 | |
---|
167 | <sect1 id="beforefirststeps"> |
---|
168 | <title>Before this</title> |
---|
169 | <para> |
---|
170 | In this document, we supposed that you followed <ulink url="getsaxo.html?format=raw">Get SAXO</ulink> recommandations. |
---|
171 | </para> |
---|
172 | </sect1> |
---|
173 | |
---|
174 | |
---|
175 | <sect1 id="initfiles"><title>Install the files <filename>init.pro</filename> and |
---|
176 | <filename>initgrid.pro</filename></title> |
---|
177 | |
---|
178 | <para> |
---|
179 | This version of the <application>SAXO</application> package depends a certain number of common |
---|
180 | variables that are primarily environmental parameters (working paths, |
---|
181 | color management, Postscript formatting) and the parameters of the |
---|
182 | grid on which you are working (longitude, latitude, depth, land-sea |
---|
183 | mask, scale factors, position of the zoom in relation to the original |
---|
184 | grid). |
---|
185 | </para> |
---|
186 | <para> |
---|
187 | These two types of parameters are kept separately: |
---|
188 | <itemizedlist> |
---|
189 | <listitem><para>environmental parameters are defined at the very beginning of the |
---|
190 | IDL session, and are in principle never changed. They are initialized |
---|
191 | by the <filename>init.pro</filename> script.</para></listitem> |
---|
192 | <listitem><para>Those that belong to the grid are reinitialized every time the |
---|
193 | grid is changed. They can therefore be called at any time during a |
---|
194 | session. These parameters are initialized by the <filename>initgrid.pro</filename> |
---|
195 | scripts, and are specific to each particular grid. |
---|
196 | </para> |
---|
197 | <para> |
---|
198 | For example: <filename>initorca.pro</filename> for the ORCA 2° grid, |
---|
199 | <filename>initorca05.pro</filename> for |
---|
200 | the ORCA 0.5° grid, or <filename>initorcapac.pro</filename> for the ORCA grid zoomed on |
---|
201 | the Pacific.</para></listitem> |
---|
202 | </itemizedlist> |
---|
203 | </para> |
---|
204 | <para> |
---|
205 | To begin, one must therefore copy <filename><replaceable>packagedir</replaceable>/INIT/init.pro</filename> |
---|
206 | into <replaceable>homedir</replaceable>, and create in <replaceable>homedir</replaceable> a script of the |
---|
207 | type <filename>initgrid.pro</filename>. |
---|
208 | </para> |
---|
209 | |
---|
210 | <sect2 id="modifinit"><title>Modification of the <filename>init.pro</filename> script</title> |
---|
211 | |
---|
212 | <para> |
---|
213 | It is necessary to personalize the lines that correspond to the 6 |
---|
214 | directories defined in § 1.1. That is: |
---|
215 | <itemizedlist> |
---|
216 | <listitem><para>The definition of !path.</para><para> |
---|
217 | The first expand_path must contain <replaceable>homedir</replaceable>, the second |
---|
218 | <replaceable>packagedir</replaceable>. The directory declaration must be preceded by a + |
---|
219 | sign, and must take the form of a character chain. The + sign |
---|
220 | specifies that subdirectories must also be considered. For those |
---|
221 | working on a Mac, <literallayout>"+':'+"</literallayout> must be replaced by <literallayout>"+','+"</literallayout> and for Windows |
---|
222 | by <literallayout>"+';'+"</literallayout>.</para> |
---|
223 | <warning> |
---|
224 | <para> |
---|
225 | In their definition, the directories must not finish with the |
---|
226 | directory separation character ("/" under UNIX/Linux). |
---|
227 | </para> |
---|
228 | </warning> |
---|
229 | </listitem> |
---|
230 | <listitem><para>Definition of the rest of the directories:</para><para> |
---|
231 | Define as necessary the variables homedir, workdir, iodir, animdir, |
---|
232 | psdir, and imagedir.</para> |
---|
233 | <warning> |
---|
234 | <para> |
---|
235 | Despite precautions taken, in order to avoid bugs it is |
---|
236 | recommended that these directories be defined with the directory |
---|
237 | separation character as the final character ("/" under UNIX/Linux). |
---|
238 | </para> |
---|
239 | </warning> |
---|
240 | </listitem> |
---|
241 | </itemizedlist> |
---|
242 | </para> |
---|
243 | <note> |
---|
244 | <para> |
---|
245 | Depending on the resolution of your screen and the type of |
---|
246 | machine used, it is possible that the graphics window which is created |
---|
247 | will be too large. If this is the case, change the ccwindowsize |
---|
248 | variable which is a multiplicative coefficient applied to the window |
---|
249 | size. |
---|
250 | </para> |
---|
251 | </note> |
---|
252 | </sect2> |
---|
253 | <sect2 id="modifinitgrid"><title>Modification or creation of the <filename>initgrid.pro</filename> script</title> |
---|
254 | |
---|
255 | <para> |
---|
256 | In the <replaceable>packagedir</replaceable>/INIT directory you will find a certain |
---|
257 | number of scripts associated with the latest grids on which I've |
---|
258 | worked. If you are also working on one of these grids, for example |
---|
259 | ORCA, copy the file <filename><replaceable>packagedir</replaceable>/INIT/initorca.pro</filename> to your |
---|
260 | <replaceable>homedir</replaceable>. If not, copy it nevertheless to use as a model. In |
---|
261 | the file <filename>initgrid.pro</filename>, adjust the zoom parameters (if it has not |
---|
262 | already been done). |
---|
263 | </para> |
---|
264 | <para> |
---|
265 | Careful: unlike in previous versions of the <application>SAXO</application> package, all the zoom |
---|
266 | parameters must be defined. If you do not know them in advance, |
---|
267 | define their values to be -1. |
---|
268 | </para> |
---|
269 | <para> |
---|
270 | In the rest of the script, define iodir as <replaceable>iodir</replaceable>, and verify |
---|
271 | the name of the mask file, if one exists. |
---|
272 | </para> |
---|
273 | </sect2> |
---|
274 | </sect1> |
---|
275 | --> |
---|
276 | <sect1 id="introxxx"><title>XXX widget functions</title> |
---|
277 | <sect2 id="launchxxx"><title>Launching XXX</title> |
---|
278 | |
---|
279 | <para> |
---|
280 | The first command to type is |
---|
281 | |
---|
282 | <screen format="linespecific"> |
---|
283 | <prompt>&promptidl;</prompt> <userinput>@init</userinput> |
---|
284 | </screen> |
---|
285 | |
---|
286 | </para> |
---|
287 | <para> |
---|
288 | Afterwards, to work directly with XXX, type: |
---|
289 | |
---|
290 | <screen format="linespecific"> |
---|
291 | |
---|
292 | <prompt>&promptidl;</prompt> <userinput>xxx</userinput> |
---|
293 | </screen> |
---|
294 | |
---|
295 | </para> |
---|
296 | |
---|
297 | |
---|
298 | A window will open with 2 lines to complete. |
---|
299 | <figure id="fig_xxx_0101"> |
---|
300 | <title>Window xxx 1</title> |
---|
301 | <mediaobjectco> |
---|
302 | <imageobjectco> |
---|
303 | <areaspec units="calspair"> |
---|
304 | <area id="datafile" coords="500,1715 9326,3074"/> |
---|
305 | <area id="initmethod" coords="1500,3268 8326,4919"/> |
---|
306 | <area id="initprogram" coords="57,5145 9961,8996"/> |
---|
307 | </areaspec> |
---|
308 | <imageobject> |
---|
309 | <imagedata fileref="figpng/xxx_0101.png"/> <!-- ++ instead of figpng/xxx_0101_org.png --> |
---|
310 | </imageobject> |
---|
311 | <calloutlist> |
---|
312 | <callout arearefs="datafile"> |
---|
313 | <para>Data file</para> |
---|
314 | </callout> |
---|
315 | <callout arearefs="initmethod"> |
---|
316 | <para>Init method</para> |
---|
317 | </callout> |
---|
318 | <callout arearefs="initprogram"> |
---|
319 | <para>Init program</para> |
---|
320 | </callout> |
---|
321 | </calloutlist> |
---|
322 | </imageobjectco> |
---|
323 | <!-- ++ si on met textobject, on ne voit plus l'image !! |
---|
324 | <textobject>[plot figpng/xxx_0101.png]</textobject> |
---|
325 | --> |
---|
326 | </mediaobjectco> |
---|
327 | </figure> |
---|
328 | <sect3 id="datafiletxt"><title>File name</title> |
---|
329 | <para> |
---|
330 | the name of the data file. The name can be typed directly in the window |
---|
331 | provided, or selected with the help of the <guibutton>browse</guibutton> button. |
---|
332 | </para> |
---|
333 | </sect3> |
---|
334 | <sect3 id="initmethodtxt"><title>Grid initalization method</title> |
---|
335 | <para> |
---|
336 | By default, "automatic grid construction with initncdf.pro" is checked. |
---|
337 | </para> |
---|
338 | <para> |
---|
339 | But you can choose an other grid by checking "grid construction with other IDL batch or procedure" |
---|
340 | </para> |
---|
341 | </sect3> |
---|
342 | <sect3 id="initprogramtxt"><title>Grid initalization parameters</title> |
---|
343 | <para> |
---|
344 | <figure id="fig_xxx_0102"> |
---|
345 | <title>Window xxx 1</title> |
---|
346 | <mediaobjectco> |
---|
347 | <imageobjectco> |
---|
348 | <imageobject> |
---|
349 | <imagedata fileref="figpng/xxx_0102.png"/> |
---|
350 | </imageobject> |
---|
351 | </imageobjectco> |
---|
352 | </mediaobjectco> |
---|
353 | </figure> |
---|
354 | </para> |
---|
355 | <para> |
---|
356 | the second the name of |
---|
357 | the <filename>initgrid.pro</filename> script which will permit the reading and processing of the |
---|
358 | grid associated with the data file. |
---|
359 | </para> |
---|
360 | <para> |
---|
361 | Once these two lines have been completed, click on <guibutton>let's go</guibutton>. |
---|
362 | </para> |
---|
363 | <para>For example, we choose the mask "tst_initlev". Compare the result with "automatic grid construction with initncdf.pro" checked. Cf <xref linkend="fig_xxx_0404"/> </para> |
---|
364 | <para> |
---|
365 | <figure id="fig_xxx_0103"> |
---|
366 | <title>Oceania at 125 metters of depth with a mask</title> |
---|
367 | <imageobject> |
---|
368 | <imagedata fileref="figpng/xxx_0103.png"/> |
---|
369 | </imageobject> |
---|
370 | </figure> |
---|
371 | </para> |
---|
372 | </sect3> |
---|
373 | </sect2> |
---|
374 | |
---|
375 | <sect2 id="wigdets"><title>Description of XXX window</title> |
---|
376 | |
---|
377 | <para> |
---|
378 | Now the XXX window will open. |
---|
379 | <!-- cf example in http://www.docbook.org/tdg/en/html/area.html |
---|
380 | sauf que dans l'exemple en question on ne donne que 2 nombres et pas 4 |
---|
381 | voir aussi message http://www.oasis-open.org/archives/docbook-apps/200501/msg00089.html |
---|
382 | peut-etre du nouveau dans les xsl depuis le 16 janvier 2005 |
---|
383 | peut-être essayé http://lists.kde.org/?l=kde-doc-english&m=112780764426265&w=2 |
---|
384 | ce produit klickety est installable via fink sous mac |
---|
385 | --> |
---|
386 | <figure id="fig_xxx_0201"> |
---|
387 | <title>Window xxx 2</title> |
---|
388 | <mediaobjectco> |
---|
389 | <imageobjectco> |
---|
390 | <areaspec units="calspair"> |
---|
391 | <area id="plottype" coords="69,380 2261,809"/> |
---|
392 | <area id="menu" coords="2517,380 7575,841"/> |
---|
393 | <area id="ok" coords="116,936 1025,1365"/> |
---|
394 | <area id="pagelayout" coords="1631,936 4498,1365"/> |
---|
395 | <area id="variableslist" coords="4871,952 7529,1349"/> |
---|
396 | <area id="fileslist" coords="46,1507 8018,1857"/> |
---|
397 | <area id="commandtext" coords="46,2000 8065,2539"/> |
---|
398 | <area id="calendar" coords="46,2682 4941,3428"/> |
---|
399 | <area id="domdef" coords="372,3603 7179,7095"/> |
---|
400 | <area id="specifications" coords="23,7269 8041,9206"/> |
---|
401 | </areaspec> |
---|
402 | <imageobject> |
---|
403 | <imagedata fileref="figpng/xxx_0201.png"/> <!-- ++ instead of figpng/xxx_0201_org.png --> |
---|
404 | </imageobject> |
---|
405 | <calloutlist> |
---|
406 | <callout arearefs="plottype"> |
---|
407 | <para>Plot type</para> |
---|
408 | </callout> |
---|
409 | <callout arearefs="menu"> |
---|
410 | <para>Menu</para> |
---|
411 | </callout> |
---|
412 | <callout arearefs="ok"> |
---|
413 | <para>OK</para> |
---|
414 | </callout> |
---|
415 | <callout arearefs="pagelayout"> |
---|
416 | <para>Page layout</para> |
---|
417 | </callout> |
---|
418 | <callout arearefs="variableslist"> |
---|
419 | <para>Variables list</para> |
---|
420 | </callout> |
---|
421 | <callout arearefs="fileslist"> |
---|
422 | <para>Files list</para> |
---|
423 | </callout> |
---|
424 | <callout arearefs="commandtext"> |
---|
425 | <para>Command text</para> |
---|
426 | </callout> |
---|
427 | <callout arearefs="calendar"> |
---|
428 | <para>Calendar</para> |
---|
429 | </callout> |
---|
430 | <callout arearefs="domdef"> |
---|
431 | <para>Domdef</para> |
---|
432 | </callout> |
---|
433 | <callout arearefs="specifications"> |
---|
434 | <para>Spefications</para> |
---|
435 | </callout> |
---|
436 | </calloutlist> |
---|
437 | </imageobjectco> |
---|
438 | <!-- ++ si on met textobject, on ne voit plus l'image |
---|
439 | <textobject>[plot figpng/xxx_0201.png]</textobject> |
---|
440 | --> |
---|
441 | </mediaobjectco> |
---|
442 | </figure> |
---|
443 | </para> |
---|
444 | <para> |
---|
445 | It's configuration will change |
---|
446 | depending on whether you are in portrait or in landscape, but here are |
---|
447 | the different parts available for your use. |
---|
448 | </para> |
---|
449 | |
---|
450 | <sect3 id="plottypetxt"><title>Plot type list</title> |
---|
451 | <para>allows specification of the type of plot desired.</para> |
---|
452 | <para> |
---|
453 | <figure id="fig_xxx_0202"> |
---|
454 | <title>Differents plot types avaibles</title> |
---|
455 | <imageobject> |
---|
456 | <imagedata fileref="figpng/xxx_0202.png"/> |
---|
457 | </imageobject> |
---|
458 | </figure> |
---|
459 | </para> |
---|
460 | <note> |
---|
461 | <para> |
---|
462 | If the type <constant>plt</constant> is selected, the selection of plot type |
---|
463 | is made by mouse. Cf <xref linkend="mouse"/></para> |
---|
464 | </note> |
---|
465 | </sect3> |
---|
466 | |
---|
467 | <sect3 id="menutxt"><title>The menu bar made up of 3 submenus</title> |
---|
468 | <sect4 id="filesubmenu"><title><guisubmenu>File</guisubmenu> submenu</title> |
---|
469 | <para> |
---|
470 | <figure id="fig_xxx_0203"> |
---|
471 | <title>The File menu</title> |
---|
472 | <imageobject> |
---|
473 | <imagedata fileref="figpng/xxx_0203.png"/> |
---|
474 | </imageobject> |
---|
475 | </figure> |
---|
476 | </para> |
---|
477 | |
---|
478 | <para> |
---|
479 | <itemizedlist> |
---|
480 | <listitem> |
---|
481 | <para> |
---|
482 | <guimenuitem>Open:</guimenuitem> to open a second file. Same procedure as during the |
---|
483 | launching of XXX. The new file can be on a different grid, with |
---|
484 | different variables, with a different time base. |
---|
485 | </para></listitem> |
---|
486 | <listitem><para><guimenuitem>New XXX:</guimenuitem> to open a second XXX window identical to the first.</para></listitem> |
---|
487 | <listitem><para><guimenuitem>Close:</guimenuitem> to close the XXX window.</para></listitem> |
---|
488 | </itemizedlist> |
---|
489 | </para> |
---|
490 | |
---|
491 | </sect4> |
---|
492 | <sect4 id="saveassubmenu"><title><guisubmenu>Save As</guisubmenu> submenu</title> |
---|
493 | <para> |
---|
494 | <figure id="fig_xxx_0204"> |
---|
495 | <title>The Save As menu</title> |
---|
496 | <imageobject> |
---|
497 | <imagedata fileref="figpng/xxx_0204.png"/> |
---|
498 | </imageobject> |
---|
499 | </figure> |
---|
500 | </para> |
---|
501 | |
---|
502 | <para> |
---|
503 | <itemizedlist> |
---|
504 | <listitem><para><guimenuitem>Postscript:</guimenuitem> to save in Postscript format</para></listitem> |
---|
505 | <listitem><para><guimenuitem>Animated gif:</guimenuitem> to create an animation from the XXX window. |
---|
506 | Careful, the creation of an animation is only possible if none of the |
---|
507 | plots have a time axis, and if the plots are all on the same time base |
---|
508 | (calendar). On the other hand, animations of horizontal and vertical |
---|
509 | plots, with different color palettes (for those not on an X-terminal), |
---|
510 | are possible. |
---|
511 | <note> |
---|
512 | <para> |
---|
513 | the creation of animations has a tendency to saturate the video |
---|
514 | memory of X-terminals, crashing the entire program...</para> |
---|
515 | </note> |
---|
516 | </para></listitem> |
---|
517 | <listitem><para><guimenuitem>Gif:</guimenuitem> to save a gif of the XXX graphics window.</para></listitem> |
---|
518 | <listitem><para><guimenuitem>IDL procedure:</guimenuitem> to save the command history that has created the |
---|
519 | plot. For example if I save the commands in <filename>xxx_figure.pro</filename>, I can |
---|
520 | then launch a new IDL session and type: |
---|
521 | <screen format="linespecific"> |
---|
522 | <prompt>&promptidl;</prompt> <userinput>@init</userinput> |
---|
523 | <prompt>&promptidl;</prompt> <userinput>xxx_figure</userinput> |
---|
524 | </screen> |
---|
525 | </para> |
---|
526 | <para> |
---|
527 | and I'll obtain the saved figure. |
---|
528 | <screen format="linespecific"> |
---|
529 | <prompt>&promptidl;</prompt> <userinput>xxx_figure,/post </userinput> |
---|
530 | </screen> |
---|
531 | or |
---|
532 | <screen format="linespecific"> |
---|
533 | <prompt>&promptidl;</prompt> <userinput>@ps</userinput> |
---|
534 | </screen> |
---|
535 | will then create a Postscript file of the figure.</para><para></para></listitem> |
---|
536 | <listitem><para><guimenuitem>RESTORE kwd of xxx:</guimenuitem></para></listitem> |
---|
537 | <listitem><para><guimenuitem>Print to prompt:</guimenuitem> lists in the IDL window the command history that |
---|
538 | created the last plot. Useful primarily for debugging...</para></listitem> |
---|
539 | </itemizedlist> |
---|
540 | </para> |
---|
541 | </sect4> |
---|
542 | <para>Test the various possibilities in the <guimenu>Save As</guimenu> menu.</para> |
---|
543 | <sect4 id="flagsubmenu"><title><guisubmenu>Flag options</guisubmenu> submenu</title> |
---|
544 | <para> |
---|
545 | <figure id="fig_xxx_0205"> |
---|
546 | <title>The Flag Option menu</title> |
---|
547 | <imageobject> |
---|
548 | <imagedata fileref="figpng/xxx_0205.png"/> |
---|
549 | </imageobject> |
---|
550 | </figure> |
---|
551 | </para> |
---|
552 | |
---|
553 | <para> |
---|
554 | <itemizedlist> |
---|
555 | <listitem><para><guibutton>Portrait/Landscape:</guibutton> changes the configuration of the plot.</para></listitem> |
---|
556 | <listitem><para><guibutton>Overlay:</guibutton> to plot contours of a different field on top the |
---|
557 | one represented as color-filled contours. It is necessary to relaunch the |
---|
558 | entire plot to make this work!</para></listitem> |
---|
559 | <listitem><para><guibutton>Vecteur:</guibutton> to plot a vector field on top of contours. Only |
---|
560 | works on horizontal plots (<filename>plt.pro</filename>). As for Overlay, a relaunch of |
---|
561 | the entire plot is necessary.</para></listitem> |
---|
562 | <listitem><para><guibutton>Longitude / x index:</guibutton> switches longitude labelling of the plot |
---|
563 | subdomain from degrees to indices following i. </para></listitem> |
---|
564 | <listitem><para><guibutton>Latitude / y index:</guibutton> switches latitude labelling of the plot |
---|
565 | subdomain from degrees to indices following j. </para></listitem> |
---|
566 | </itemizedlist> |
---|
567 | </para> |
---|
568 | </sect4> |
---|
569 | <para> |
---|
570 | Test the various possibilities in the <guimenu>Flag options</guimenu> menu. |
---|
571 | </para> |
---|
572 | <caution> |
---|
573 | <para> |
---|
574 | Careful, a selected option remains selected until it is reclicked. |
---|
575 | </para> |
---|
576 | </caution> |
---|
577 | </sect3> |
---|
578 | |
---|
579 | <sect3 id="oktxt"><title>OK button</title> |
---|
580 | <para>click on this <guibutton>OK</guibutton> button is required to make a new plot appear</para> |
---|
581 | </sect3> |
---|
582 | |
---|
583 | <sect3 id="pagelayouttxt"><title>Page Layout</title> |
---|
584 | <para>specify the number of columns and rows for plots on the sheet of paper.</para> |
---|
585 | <para> |
---|
586 | <figure id="fig_xxx_0206"> |
---|
587 | <title>Number of Column</title> |
---|
588 | <imageobject> |
---|
589 | <imagedata fileref="figpng/xxx_0206.png"/> |
---|
590 | </imageobject> |
---|
591 | </figure> |
---|
592 | </para> |
---|
593 | <para>For example: For 2 cln and 2 row. For explanations, see further.</para> |
---|
594 | <para> |
---|
595 | <figure id="fig_xxx_0206a"> |
---|
596 | <title>A frame with several graphics</title> |
---|
597 | <imageobject> |
---|
598 | <imagedata fileref="figpng/xxx_0206a.png"/> |
---|
599 | </imageobject> |
---|
600 | </figure> |
---|
601 | </para> |
---|
602 | </sect3> |
---|
603 | |
---|
604 | <sect3 id="variableslisttxt"><title><guimenuitem>List of variables</guimenuitem></title> |
---|
605 | <para> you can choose the variable to work on.</para> |
---|
606 | <para> |
---|
607 | <figure id="fig_xxx_0207"> |
---|
608 | <title>differents Variables avaible</title> |
---|
609 | <imageobject> |
---|
610 | <imagedata fileref="figpng/xxx_0207.png"/> |
---|
611 | </imageobject> |
---|
612 | </figure> |
---|
613 | </para> |
---|
614 | </sect3> |
---|
615 | |
---|
616 | <sect3 id="fileslisttxt"><title><guimenuitem>List of open files</guimenuitem></title> |
---|
617 | <para> you can choose the file to work on.</para> |
---|
618 | <para> |
---|
619 | <figure id="fig_xxx_0208"> |
---|
620 | <title>List of open files</title> |
---|
621 | <imageobject> |
---|
622 | <imagedata fileref="figpng/xxx_0208.png"/> |
---|
623 | </imageobject> |
---|
624 | </figure> |
---|
625 | </para> |
---|
626 | </sect3> |
---|
627 | |
---|
628 | <sect3 id="commandtexttxt"><title><guimenuitem>Command text</guimenuitem></title> |
---|
629 | <para>To specify the computation you want to do. |
---|
630 | Examples: </para> |
---|
631 | <sect4 id="withoutcommandtexttxt"><title><guimenuitem> Without any Command Text</guimenuitem></title> |
---|
632 | <para> |
---|
633 | <figure id="fig_xxx_0209"> |
---|
634 | <title>Graphic by default</title> |
---|
635 | <imageobject> |
---|
636 | <imagedata fileref="figpng/xxx_0209.png"/> |
---|
637 | </imageobject> |
---|
638 | </figure> |
---|
639 | </para> |
---|
640 | </sect4> |
---|
641 | |
---|
642 | <sect4 id="withrealcont"><title><guimenuitem> With the command text /realcont</guimenuitem></title> |
---|
643 | <para> |
---|
644 | <figure id="fig_xxx_0210a"> |
---|
645 | <title>Command text area</title> |
---|
646 | <imageobject> |
---|
647 | <imagedata fileref="figpng/xxx_0210a.png"/> |
---|
648 | </imageobject> |
---|
649 | </figure> |
---|
650 | </para> |
---|
651 | <para> |
---|
652 | <figure id="fig_xxx_0210"> |
---|
653 | <title>Graphic with the command text "/realcont"</title> |
---|
654 | <imageobject> |
---|
655 | <imagedata fileref="figpng/xxx_0210.png"/> |
---|
656 | </imageobject> |
---|
657 | </figure> |
---|
658 | </para> |
---|
659 | </sect4> |
---|
660 | |
---|
661 | <sect4 id="withmaportho"><title><guimenuitem>With the command text /realcont+ map=[90,0,0]+ /ortho+ cell_fill=2.</guimenuitem></title> |
---|
662 | <para> |
---|
663 | <figure id="fig_xxx_0211a"> |
---|
664 | <title>Command text area with the right syntax</title> |
---|
665 | <imageobject> |
---|
666 | <imagedata fileref="figpng/xxx_0211a.png"/> |
---|
667 | </imageobject> |
---|
668 | </figure> |
---|
669 | </para> |
---|
670 | <para> |
---|
671 | <figure id="fig_xxx_0211"> |
---|
672 | <title>Polar Projection</title> |
---|
673 | <imageobject> |
---|
674 | <imagedata fileref="figpng/xxx_0211.png"/> |
---|
675 | </imageobject> |
---|
676 | </figure> |
---|
677 | </para> |
---|
678 | </sect4> |
---|
679 | |
---|
680 | <note><para>In the default case, the name given to a field is of no importance.</para></note> |
---|
681 | </sect3> |
---|
682 | |
---|
683 | <sect3 id="calendartxt"><title>Calendar</title> |
---|
684 | <para> |
---|
685 | The calendar is made up of two droplists, which allow specification of |
---|
686 | two dates, the beginning and end of a time series, or the period over |
---|
687 | which to average before plotting.</para> |
---|
688 | <para>Example: The first plot is during January.</para> |
---|
689 | <para> The second plot is from January to December.</para> |
---|
690 | <para> |
---|
691 | <figure id="fig_xxx_0301"> |
---|
692 | <title>Graphic with 2 different period of study</title> |
---|
693 | <imageobject> |
---|
694 | <imagedata fileref="figpng/xxx_0301.png"/> |
---|
695 | </imageobject> |
---|
696 | </figure> |
---|
697 | </para> |
---|
698 | </sect3> |
---|
699 | |
---|
700 | <sect3 id="domdeftxt"><title>Define the domain</title> |
---|
701 | <para> |
---|
702 | A series of widgets that allow specification of the min/max limits of |
---|
703 | the domain in longitude/x-index, latitude/y-index, and depth in levels |
---|
704 | or meters. For depth, one can specify in levels for a horizontal |
---|
705 | plot, and in meters for a vertical plot. |
---|
706 | </para> |
---|
707 | |
---|
708 | <sect4 id="withoutdomainspecification"><title><guimenuitem>Without any domain specification</guimenuitem></title> |
---|
709 | <para> |
---|
710 | <figure id="fig_xxx_0210"> |
---|
711 | <title>Domain by default</title> |
---|
712 | <imageobject> |
---|
713 | <imagedata fileref="figpng/xxx_0210.png"/> |
---|
714 | </imageobject> |
---|
715 | </figure> |
---|
716 | </para> |
---|
717 | </sect4> |
---|
718 | |
---|
719 | <sect4 id="withzoom"><title><guimenuitem>With a zoom on Oceania</guimenuitem></title> |
---|
720 | <para>We can zoom, between 0 and 1 meter of depth, on the Oceania, by playing with the part Domdef, with this configuration</para> |
---|
721 | <para> |
---|
722 | <figure id="fig_xxx_0401"> |
---|
723 | <title>Change Domain area</title> |
---|
724 | <imageobject> |
---|
725 | <imagedata fileref="figpng/xxx_0401.png"/> |
---|
726 | </imageobject> |
---|
727 | </figure> |
---|
728 | </para> |
---|
729 | <para>This configuration give us:</para> |
---|
730 | <para> |
---|
731 | <figure id="fig_xxx_0402"> |
---|
732 | <title>Graphic with a specified domain</title> |
---|
733 | <imageobject> |
---|
734 | <imagedata fileref="figpng/xxx_0402.png"/> |
---|
735 | </imageobject> |
---|
736 | </figure> |
---|
737 | </para> |
---|
738 | </sect4> |
---|
739 | </sect3> |
---|
740 | |
---|
741 | <sect4 id="depthspecificationtxt"><title><guimenuitem>With the specification of the depth</guimenuitem></title> |
---|
742 | <para>If we want to see the temperature of the ocean between 125 and 126 meters of depth</para> |
---|
743 | <para> |
---|
744 | <figure id="fig_xxx_0403"> |
---|
745 | <title>Change depth area</title> |
---|
746 | <imageobject> |
---|
747 | <imagedata fileref="figpng/xxx_0403.png"/> |
---|
748 | </imageobject> |
---|
749 | </figure> |
---|
750 | </para> |
---|
751 | <para> |
---|
752 | <figure id="fig_xxx_0404"> |
---|
753 | <title>Oceania at 125 metters of depth without a mask</title> |
---|
754 | <imageobject> |
---|
755 | <imagedata fileref="figpng/xxx_0404.png"/> |
---|
756 | </imageobject> |
---|
757 | </figure> |
---|
758 | </para> |
---|
759 | <para>As you can see, at this depth, we can see the difference between the continent at the surface and the real goegraphy of the terrain. If we want to see only the terrain at the specified depth, we have to put a mask. Cf <xref linkend="fig_xxx_0103"/></para> |
---|
760 | <para>You can define precisely the depth you want to see:</para> |
---|
761 | <para> |
---|
762 | <figure id="fig_xxx_0405"> |
---|
763 | <title>The Precise Depth menu</title> |
---|
764 | <imageobject> |
---|
765 | <imagedata fileref="figpng/xxx_0405.png"/> |
---|
766 | </imageobject> |
---|
767 | </figure> |
---|
768 | </para> |
---|
769 | </sect4> |
---|
770 | |
---|
771 | |
---|
772 | <sect3 id="specificationstxt"><title>specify your plot</title> |
---|
773 | <sect4 id="minmaxintervaltxt"><title><guimenuitem>Specify the min, the max and the interval</guimenuitem></title> |
---|
774 | <para> |
---|
775 | You can specify the min, max, and contour interval by filling out the |
---|
776 | provided boxes! |
---|
777 | </para> |
---|
778 | <para> |
---|
779 | You can restore configuration by default by pressing the "default" button. |
---|
780 | </para> |
---|
781 | <para> |
---|
782 | <figure id="fig_xxx_0501"> |
---|
783 | <title>Specification area</title> |
---|
784 | <imageobject> |
---|
785 | <imagedata fileref="figpng/xxx_0501.png"/> |
---|
786 | </imageobject> |
---|
787 | </figure> |
---|
788 | </para> |
---|
789 | </sect4> |
---|
790 | |
---|
791 | <sect4 id="colortxt"><title><guimenuitem>Specify the palette to be used</guimenuitem></title> |
---|
792 | <para>For the color palette, you can either specify the name |
---|
793 | or go search for one among the palettes available. |
---|
794 | </para> |
---|
795 | <para> |
---|
796 | <figure id="fig_xxx_0502"> |
---|
797 | <title>The Color menu</title> |
---|
798 | <imageobject> |
---|
799 | <imagedata fileref="figpng/xxx_0502.png"/> |
---|
800 | </imageobject> |
---|
801 | </figure> |
---|
802 | </para> |
---|
803 | </sect4> |
---|
804 | |
---|
805 | <para> |
---|
806 | The "keywords" window allows specification of all desired |
---|
807 | keywords. These keywords can be those of |
---|
808 | <filename>plt.pro</filename>, <filename>pltt.pro</filename>, <filename>pltz.pro</filename>, |
---|
809 | <filename>plt1d.pro</filename>, or those of contour, plot, or all other programs that are |
---|
810 | used. Cf <xref linkend="commandtexttxt"/> |
---|
811 | </para> |
---|
812 | </sect3> |
---|
813 | |
---|
814 | |
---|
815 | </sect2> |
---|
816 | </sect1> |
---|
817 | <sect1 id="mouseactions"><title>Mouse Actions</title> |
---|
818 | |
---|
819 | <sect2 id="mouse"><title>In the graphics window on a horizontal plot</title> |
---|
820 | <para> |
---|
821 | Select a domain and select the horizontal plot (<constant>plt</constant>), vertical plot |
---|
822 | (<constant>pltz</constant>), or the hovmoeller plot (<constant>pltt</constant>):</para> |
---|
823 | <para> |
---|
824 | The domain we'd like to select for the plot is determined by one of |
---|
825 | its diagonals, defined therefore by two points. The first point is |
---|
826 | defined when the mouse button is pushed, then the mouse is moved, and |
---|
827 | the second point is defined as the mouse button is released |
---|
828 | (click-drag). The domains are thus defined by a long click (<abbrev>LC</abbrev>). To |
---|
829 | determine which type of plot should be made of selection, use: |
---|
830 | </para> |
---|
831 | <para> |
---|
832 | If the plot selector is on <constant>plt</constant> |
---|
833 | <itemizedlist> |
---|
834 | <listitem><para>the left mouse button to create horizontal plots (<constant>plt</constant>)</para></listitem> |
---|
835 | <listitem><para>the middle mouse button to create vertical plots (<constant>pltz</constant>)</para></listitem> |
---|
836 | <listitem><para>the right mouse button to create common hovmoellers for xt and yt cuts (<constant>pltt</constant>)</para></listitem> |
---|
837 | </itemizedlist> |
---|
838 | </para> |
---|
839 | |
---|
840 | <para>In summary:</para> |
---|
841 | <para> |
---|
842 | <itemizedlist> |
---|
843 | <listitem><para> |
---|
844 | <figure id="fig_mousell"> |
---|
845 | <title><abbrev>LCL</abbrev>---><constant>plt</constant></title> |
---|
846 | <mediaobjectco> |
---|
847 | <imageobjectco> |
---|
848 | <imageobject> |
---|
849 | <imagedata fileref="figpng/xxx_mousell.png"/> |
---|
850 | </imageobject> |
---|
851 | </imageobjectco> |
---|
852 | </mediaobjectco> |
---|
853 | </figure> |
---|
854 | <para> |
---|
855 | <figure id="fig_xxx_0701"> |
---|
856 | <title>Horizontal Plot</title> |
---|
857 | <imageobject> |
---|
858 | <imagedata fileref="figpng/xxx_0701.png"/> |
---|
859 | </imageobject> |
---|
860 | </figure> |
---|
861 | </para> |
---|
862 | |
---|
863 | </para></listitem> |
---|
864 | <listitem><para> |
---|
865 | <figure id="fig_mouselm"> |
---|
866 | <title><abbrev>LCM</abbrev>---><constant>pltz</constant></title> |
---|
867 | <mediaobjectco> |
---|
868 | <imageobjectco> |
---|
869 | <imageobject> |
---|
870 | <imagedata fileref="figpng/xxx_mouselm.png"/> |
---|
871 | </imageobject> |
---|
872 | </imageobjectco> |
---|
873 | </mediaobjectco> |
---|
874 | </figure> |
---|
875 | <para> |
---|
876 | <figure id="fig_xxx_0702"> |
---|
877 | <title>Vertical Plot</title> |
---|
878 | <imageobject> |
---|
879 | <imagedata fileref="figpng/xxx_0702.png"/> |
---|
880 | </imageobject> |
---|
881 | </figure> |
---|
882 | </para> |
---|
883 | |
---|
884 | </para></listitem> |
---|
885 | <listitem><para> |
---|
886 | <figure id="fig_mouselr"> |
---|
887 | <title><abbrev>LCR</abbrev>---><constant>pltt</constant></title> |
---|
888 | <mediaobjectco> |
---|
889 | <imageobjectco> |
---|
890 | <imageobject> |
---|
891 | <imagedata fileref="figpng/xxx_mouselr.png"/> |
---|
892 | </imageobject> |
---|
893 | </imageobjectco> |
---|
894 | </mediaobjectco> |
---|
895 | </figure> |
---|
896 | <para> |
---|
897 | <figure id="fig_xxx_0703"> |
---|
898 | <title>Common hovmoeller for xt and yt cuts</title> |
---|
899 | <imageobject> |
---|
900 | <imagedata fileref="figpng/xxx_0703.png"/> |
---|
901 | </imageobject> |
---|
902 | </figure> |
---|
903 | </para> |
---|
904 | |
---|
905 | </para></listitem> |
---|
906 | </itemizedlist> |
---|
907 | </para> |
---|
908 | |
---|
909 | <note><para>If the plot selector is on something other than <constant>plt</constant> the indicated plot type is made.</para></note> |
---|
910 | |
---|
911 | </sect2> |
---|
912 | <sect2 id="multipleplots"><title>Create multiple plots on the same sheet and make them interact</title> |
---|
913 | |
---|
914 | <para> |
---|
915 | Select the number of columns and rows for the page.</para> |
---|
916 | <para> |
---|
917 | Create a first plot. It will appear in the first frame.</para> |
---|
918 | <para> |
---|
919 | To create a plot in another frame double-click in the frame with the |
---|
920 | middle button (<abbrev>DCM</abbrev>). A black dotted frame will surround the |
---|
921 | designated frame, the <quote>target</quote> frame. A black frame will surround the |
---|
922 | first plot. This is the <quote>reference</quote> frame, in other words the one |
---|
923 | that all the XXX widgets refer to. Change for example the date and |
---|
924 | create a new plot. With a left button double-click in the first |
---|
925 | frame, all the widgets change and refer again to the first plot. A |
---|
926 | double-click with the right button in the second frame will erase the |
---|
927 | plot.</para> |
---|
928 | <para>In summary: </para> |
---|
929 | <itemizedlist> |
---|
930 | <listitem><para> |
---|
931 | <figure id="fig_mousedl"> |
---|
932 | <title><abbrev>DCL</abbrev>---><quote>reference</quote> frame</title> |
---|
933 | <mediaobjectco> |
---|
934 | <imageobjectco> |
---|
935 | <imageobject> |
---|
936 | <imagedata fileref="figpng/xxx_mousedl.png"/> |
---|
937 | </imageobject> |
---|
938 | </imageobjectco> |
---|
939 | </mediaobjectco> |
---|
940 | </figure> |
---|
941 | <para> |
---|
942 | <figure id="fig_xxx_0801"> |
---|
943 | <title>The reference frame is selected</title> |
---|
944 | <imageobject> |
---|
945 | <imagedata fileref="figpng/xxx_0801.png"/> |
---|
946 | </imageobject> |
---|
947 | </figure> |
---|
948 | </para> |
---|
949 | |
---|
950 | </para></listitem> |
---|
951 | <listitem><para> |
---|
952 | <figure id="fig_mousedm"> |
---|
953 | <title><abbrev>DCM</abbrev>---><quote>target</quote> frame</title> |
---|
954 | <mediaobjectco> |
---|
955 | <imageobjectco> |
---|
956 | <imageobject> |
---|
957 | <imagedata fileref="figpng/xxx_mousedm.png"/> |
---|
958 | </imageobject> |
---|
959 | </imageobjectco> |
---|
960 | </mediaobjectco> |
---|
961 | </figure> |
---|
962 | <para> |
---|
963 | <figure id="fig_xxx_0802"> |
---|
964 | <title>The target frame is selected</title> |
---|
965 | <imageobject> |
---|
966 | <imagedata fileref="figpng/xxx_0802.png"/> |
---|
967 | </imageobject> |
---|
968 | </figure> |
---|
969 | </para> |
---|
970 | </para></listitem> |
---|
971 | <listitem><para> |
---|
972 | <figure id="fig_mousedr"> |
---|
973 | <title><abbrev>DCR</abbrev>--->erase the frame</title> |
---|
974 | <mediaobjectco> |
---|
975 | <imageobjectco> |
---|
976 | <imageobject> |
---|
977 | <imagedata fileref="figpng/xxx_mousedr.png"/> |
---|
978 | </imageobject> |
---|
979 | </imageobjectco> |
---|
980 | </mediaobjectco> |
---|
981 | </figure> |
---|
982 | |
---|
983 | </para></listitem> |
---|
984 | </itemizedlist> |
---|
985 | <para>Here's a series of commands to show how this works.</para> |
---|
986 | <procedure> |
---|
987 | <step> |
---|
988 | <para> |
---|
989 | Select a 3-D field and create 6 frames for the sheet of paper. |
---|
990 | </para> |
---|
991 | </step> |
---|
992 | <step> |
---|
993 | <para> |
---|
994 | Create a horizontal plot in Frame 1 |
---|
995 | </para> |
---|
996 | </step> |
---|
997 | <!-- je n'arrive pas à utliser <stepalternatives> --> |
---|
998 | <step> |
---|
999 | <para> |
---|
1000 | <abbrev>DCM</abbrev> in frame 2, <abbrev>LCL</abbrev> on the plot in frame 1, to create a horizontal |
---|
1001 | zoom in frame 2.</para> |
---|
1002 | <para> |
---|
1003 | <abbrev>DCM</abbrev> in frame 3, <abbrev>LCM</abbrev> on the plot in frame 1, to create a vertical cut |
---|
1004 | in frame 3.</para> |
---|
1005 | <para> |
---|
1006 | <abbrev>DCM</abbrev> in frame 4, <abbrev>LCR</abbrev> on the plot in frame 1, to create a hovmoeller in frame 4. |
---|
1007 | </para> |
---|
1008 | <para> |
---|
1009 | <figure id="fig_xxx_0901"> |
---|
1010 | <title>Frame with four plot</title> |
---|
1011 | <imageobject> |
---|
1012 | <imagedata fileref="figpng/xxx_0901.png"/> |
---|
1013 | </imageobject> |
---|
1014 | </figure> |
---|
1015 | </para> |
---|
1016 | </step> |
---|
1017 | </procedure> |
---|
1018 | <procedure> |
---|
1019 | <para> |
---|
1020 | To redo the hovmoeller with the keyword <literallayout>/nocontour</literallayout> |
---|
1021 | </para> |
---|
1022 | <step> |
---|
1023 | <para> |
---|
1024 | <abbrev>DCL</abbrev> in frame 4 which now becomes the reference and target frame. |
---|
1025 | </para> |
---|
1026 | </step> |
---|
1027 | <step> |
---|
1028 | <para> |
---|
1029 | Add the keyword |
---|
1030 | <literallayout>/nocontour</literallayout> |
---|
1031 | <para> |
---|
1032 | <figure id="fig_xxx_0902a"> |
---|
1033 | <title>Command text area</title> |
---|
1034 | <imageobject> |
---|
1035 | <imagedata fileref="figpng/xxx_0902a.png"/> |
---|
1036 | </imageobject> |
---|
1037 | </figure> |
---|
1038 | </para> |
---|
1039 | </para> |
---|
1040 | </step> |
---|
1041 | <step> |
---|
1042 | <para> |
---|
1043 | click <guibutton>OK</guibutton>, and the plot is redone. |
---|
1044 | </para> |
---|
1045 | <para> |
---|
1046 | <figure id="fig_xxx_0902"> |
---|
1047 | <title>The fourth plot with the keyword "nocontour"</title> |
---|
1048 | <imageobject> |
---|
1049 | <imagedata fileref="figpng/xxx_0902.png"/> |
---|
1050 | </imageobject> |
---|
1051 | </figure> |
---|
1052 | </para> |
---|
1053 | </step> |
---|
1054 | </procedure> |
---|
1055 | <procedure> |
---|
1056 | <para> |
---|
1057 | in frame 5, let's create the same plot as in frame 2 except with different dates |
---|
1058 | </para> |
---|
1059 | <step> |
---|
1060 | <para> |
---|
1061 | <abbrev>DCL</abbrev> on frame 2 |
---|
1062 | </para> |
---|
1063 | </step> |
---|
1064 | <step> |
---|
1065 | <para> |
---|
1066 | <abbrev>DCM</abbrev> on frame 5 |
---|
1067 | </para> |
---|
1068 | </step> |
---|
1069 | <step> |
---|
1070 | <para> |
---|
1071 | change the date |
---|
1072 | </para> |
---|
1073 | </step> |
---|
1074 | <step> |
---|
1075 | <para> |
---|
1076 | click on <guibutton>OK</guibutton> |
---|
1077 | </para> |
---|
1078 | <para> |
---|
1079 | <figure id="fig_xxx_0903"> |
---|
1080 | <title>Frame with five plot</title> |
---|
1081 | <imageobject> |
---|
1082 | <imagedata fileref="figpng/xxx_0903.png"/> |
---|
1083 | </imageobject> |
---|
1084 | </figure> |
---|
1085 | </para> |
---|
1086 | </step> |
---|
1087 | </procedure> |
---|
1088 | </sect2> |
---|
1089 | </sect1> |
---|
1090 | <sect1 id="crash"><title>What should I do when it breakdown</title> |
---|
1091 | |
---|
1092 | <para> |
---|
1093 | <orderedlist> |
---|
1094 | <listitem> |
---|
1095 | <para> |
---|
1096 | in the IDL window, type |
---|
1097 | <screen format="linespecific"> |
---|
1098 | <prompt>&promptidl;</prompt> <userinput>retall</userinput> |
---|
1099 | </screen> |
---|
1100 | </para></listitem> |
---|
1101 | <listitem> |
---|
1102 | <para><abbrev>DCR</abbrev> to erase the problem frame. |
---|
1103 | </para> |
---|
1104 | </listitem> |
---|
1105 | <listitem><para>change the orientation of the plot by pressing Flag options -> Portrait/Landscape. Cf <xref linkend="flagsubmenu"/> |
---|
1106 | </para></listitem> |
---|
1107 | <listitem><para>quit XXX cleanly using <guibutton>quit</guibutton> from the <guimenu>File</guimenu> menu. Cf <xref linkend="filesubmenu"/> |
---|
1108 | </para></listitem> |
---|
1109 | </orderedlist> |
---|
1110 | </para> |
---|
1111 | <note> |
---|
1112 | <para> |
---|
1113 | Always avoid if at all possible closing and killing the XXX |
---|
1114 | window, but rather select <guibutton>quit</guibutton> from the <guimenu>File</guimenu> menu. XXX uses a |
---|
1115 | large number of pointers, and wantonly killing the window will leave a |
---|
1116 | large number of unused variables in memory, which could in the end |
---|
1117 | overflow. To clean up this memory: |
---|
1118 | <screen format="linespecific"> |
---|
1119 | <prompt>&promptidl;</prompt> <userinput>ptr_free, ptr_valid()</userinput> |
---|
1120 | </screen> |
---|
1121 | </para> |
---|
1122 | </note> |
---|
1123 | </sect1> |
---|
1124 | </article> |
---|