source: trunk/SRC/Documentation/xmldoc/firststeps.html @ 416

Last change on this file since 416 was 416, checked in by pinsard, 14 years ago

remove most of wiki pages
  • Property svn:keywords set to Id
File size: 68.1 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>First steps with SAXO</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.74.3" />
11    <meta name="keywords" content="IDL, SAXO" />
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="firststeps" id="firststeps"></a> First steps with <span class="application">SAXO</span> </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 class="email" 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">Françoise</span> <span class="surname">Pinsard</span> <code class="email">&lt;<a class="email" href="mailto:Francoise.Pinsard_at_locean-ipsl.upmc.fr">Francoise.Pinsard_at_locean-ipsl.upmc.fr</a>&gt;</code></h3></div>
17    </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>
18      <tr><td align="left">Revision 0.0</td><td align="left">29 July 2005</td></tr><tr><td align="left" colspan="2">First draft</td></tr>
19      <tr><td align="left">Revision 0.1</td><td align="left">29 August 2005</td></tr><tr><td align="left" colspan="2">last Japanese version!</td></tr>
20      <tr><td align="left">Revision 0.2</td><td align="left">May 2006</td></tr><tr><td align="left" colspan="2">split with getsaxo</td></tr>
21      <tr><td align="left">Revision 0.3</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>
22
23     </table></div></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#beforefirststeps">1. Before this</a></span></dt><dt><span class="sect1"><a href="#first_plots">2.  First plots 
 </a></span></dt><dd><dl><dt><span class="sect2"><a href="#start_with_init">2.1.  Start IDL session: @init </a></span></dt><dt><span class="sect2"><a href="#basic_plots">2.2.  Basic plots 
 </a></span></dt></dl></dd><dt><span class="sect1"><a href="#gridded_data">3.  Explore gridded data (model outputs and observations) </a></span></dt><dd><dl><dt><span class="sect2"><a href="#load_grid">3.1.  Load the data grid </a></span></dt><dt><span class="sect2"><a href="#plt">3.2.  Horizontal plots and maps </a></span></dt><dt><span class="sect2"><a href="#pltz">3.3.  Vertical sections </a></span></dt><dt><span class="sect2"><a href="#pltt">3.4.  Hovmoellers and time series </a></span></dt><dt><span class="sect2"><a href="#plt1d">3.5.  1D plots </a></span></dt></dl></dd></dl></div>
24
25
26
27
28 
29
30 
31<div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="beforefirststeps" id="beforefirststeps"></a>1. Before this</h2></div></div></div>
32
33<p>
34In this document, we supposed that you followed <a class="link" href="./getsaxo.html" target="_top">Get SAXO</a> recommendations.
35</p>
36</div>
37
38  <div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="first_plots" id="first_plots"></a>2.  First plots 
 </h2></div></div></div>
39   
40    <div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="start_with_init" id="start_with_init"></a>2.1.  Start IDL session: <strong class="userinput"><code><span class="command"><strong>@init</strong></span></code></strong> </h3></div></div></div>
41     
42      <p>
43Each IDL session using <span class="application">SAXO</span> must always start with:
44</p><pre class="screen">
45 <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>@init</strong></span></code></strong>
46</pre><p>
47      </p>
48      <p>
49<span class="emphasis"><em>The @ is equivalent to an include. It is used to execute a set of IDL commands that will be directly executed without any compilation (as it is the case for a procedure or a function). All variables defined and used in the @
 file will still be accessible after the execution of the @
 is finished (which is not the case for procedures and functions that ends with the return instruction).</em></span>
50</p>
51<p>
52</p><pre class="screen">
53  <code class="prompt">$</code> <strong class="userinput"><code><span class="command"><strong>cd</strong></span> <code class="filename">${HOME}/My_IDL/</code></code></strong>
54  <code class="prompt">$</code> <strong class="userinput"><code><span class="command"><strong>idl</strong></span></code></strong>
55  <code class="computeroutput">IDL Version 6.0, Mac OS X (darwin ppc m32). (c) 2003, Research Systems, Inc.</code>
56  <code class="computeroutput">Installation number: 35411.</code>
57  <code class="computeroutput">Licensed for personal use by Jean-Philippe BOULANGER only.</code>
58  <code class="computeroutput">All other use is strictly prohibited.</code>
59  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>@init</strong></span></code></strong>
60  <code class="computeroutput">% Compiled module: KEEP_COMPATIBILITY.</code>
61  <code class="computeroutput">% Compiled module: FIND.</code>
62  <code class="computeroutput">% Compiled module: PATH_SEP.</code>
63  <code class="computeroutput">% Compiled module: STRSPLIT.</code>
64  <code class="computeroutput">% Compiled module: DEF_MYUNIQUETMPDIR.</code>
65  <code class="computeroutput">We forget the compatibility with the old version</code>
66  <code class="computeroutput">% Compiled module: DEMOMODE_COMPATIBILITY.</code>
67  <code class="computeroutput">% Compiled module: ISADIRECTORY.</code>
68  <code class="computeroutput">% Compiled module: LCT.</code>
69  <code class="computeroutput">% Compiled module: RSTRPOS.</code>
70  <code class="computeroutput">% Compiled module: REVERSE.</code>
71  <code class="computeroutput">% Compiled module: STR_SEP.</code>
72  <code class="computeroutput">% Compiled module: LOADCT.</code>
73  <code class="prompt">idl&gt;</code>
74</pre><p>
75</p>
76<p>
77As an IDL session using <span class="application">SAXO</span> must always start with :
78</p><pre class="screen">
79 <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>@init</strong></span></code></strong>
80</pre><p>
81, it could be convenient to define the environment variable <code class="envar">IDL_STARTUP</code> to <code class="filename">${HOME}/My_IDL/init.pro</code>. In that way, <code class="filename">init.pro</code> will automatically been executed when starting IDL. This can be done with the following command:
82      </p><div class="variablelist"><dl><dt><span class="term"><span class="command"><strong>csh</strong></span></span></dt><dd><pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code><span class="command"><strong>setenv</strong></span> <code class="envar">IDL_STARTUP</code> <code class="filename">${HOME}/My_IDL/init.pro</code></code></strong></pre></dd><dt><span class="term"><span class="command"><strong>ksh</strong></span></span></dt><dd><pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code><span class="command"><strong>export</strong></span> <code class="envar">IDL_STARTUP</code>=<code class="filename">${HOME}/My_IDL/init.pro</code></code></strong></pre></dd></dl></div><p>
83      </p>
84    </div>
85    <div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="basic_plots" id="basic_plots"></a>2.2.  Basic plots 
 </h3></div></div></div>
86     
87      <div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="basic_splot" id="basic_splot"></a>2.2.1.  splot </h4></div></div></div>
88     
89
90      <p>
91</p><div class="screenco">
92 
93<pre class="screen">
94   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>n = 10</strong></span></code></strong>
95   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>y = findgen(n)</strong></span></code></strong> <img src="images/callouts/1.png" alt="1" />
96   <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>plot, y</strong></span></code></strong> <a class="link" href="./figpng/basic_plot.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
97</pre>
98   <div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><img src="images/callouts/1.png" alt="1" border="0" /></p></td><td valign="top" align="left">
99      <p>
100<span class="command"><strong>findgen</strong></span> stands for <span class="bold"><strong>f</strong></span>loat <span class="bold"><strong>ind</strong></span>ex <span class="bold"><strong>gen</strong></span>erator.
101</p><pre class="screen">
102  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>print, findgen(6)</strong></span></code></strong>
103  <code class="computeroutput">      0.00000      1.00000      2.00000      3.00000      4.00000      5.00000</code>
104</pre><p>
105      </p>
106    </td></tr></table></div>
107</div><p>
108     </p>
109      <p>
110Using IDL <span class="command"><strong>plot</strong></span> command is quite inconvenient to save the figure as a postscript. In addition, positioning the figure on the window/page by using <code class="varname">!p.position</code>, <code class="varname">!p.region</code> and <code class="varname">!p.multi</code> is often a nightmare. That's why we developed <span class="command"><strong>splot</strong></span> (like super-plot) which can be used in the same way as plot but is much more convenient to make postscript and position the figure.
111</p><pre class="screen">
112  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>splot, y</strong></span></code></strong> <a class="link" href="./figpng/basic_splot1.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
113  <code class="computeroutput">% Compiled module: SPLOT.</code>
114  <code class="computeroutput">% Compiled module: REINITPLT.</code>
115  <code class="computeroutput">% Compiled module: PLACEDESSIN.</code>
116  <code class="computeroutput">% Compiled module: CALIBRE.</code>
117  <code class="computeroutput">% Compiled module: GIVEWINDOWSIZE.</code>
118  <code class="computeroutput">% Compiled module: GET_SCREEN_SIZE.</code>
119  <code class="computeroutput">% Compiled module: TERMINEDESSIN.</code>
120</pre><p>
121Save the figure seen on the screen as a (real, not a screen capture) postscript in only one command.
122</p><div class="screenco">
123 
124<pre class="screen">
125  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>@ps</strong></span></code></strong>
126  <code class="computeroutput">% Compiled module: GETFILE.</code>
127  <code class="computeroutput">% Compiled module: PUTFILE.</code>
128  <code class="computeroutput">% Compiled module: OPENPS.</code>
129  <code class="computeroutput">% Compiled module: XQUESTION.</code>
130  <code class="computeroutput">Name of the postscript file? (default answer is idl.ps)</code><strong class="userinput"><code>first_ps</code></strong> <img src="images/callouts/1.png" alt="1" />
131  <code class="computeroutput">% Compiled module: ISAFILE.</code>
132  <code class="computeroutput">% Compiled module: XNOTICE.</code>
133  <code class="computeroutput">% Compiled module: CLOSEPS.</code>
134  <code class="computeroutput">% Compiled module: PRINTPS.</code>
135  <code class="computeroutput">% Compiled module: FILE_WHICH.</code>
136  <code class="computeroutput">% Compiled module: CW_BGROUP.</code>
137  <code class="computeroutput">% Compiled module: XMANAGER.</code>
138</pre>
139  <div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><img src="images/callouts/1.png" alt="1" border="0" /></p></td><td valign="top" align="left">
140     
141If needed, the name of the postscript will automatically be completed with .ps. Just hit return, if you want to use the default postscript name: <code class="filename">idl.ps</code>.
142     
143    </td></tr></table></div>
144</div><p>
145Check that the “<span class="quote"><code class="filename">first_ps.ps</code></span>” file is now existing 

146</p><pre class="screen">
147  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>print, file_test(psdir + 'first_ps.ps')</strong></span></code></strong>
148  <code class="computeroutput">           1</code>
149  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>help, file_info(psdir + 'first_ps.ps'), /structure</strong></span></code></strong>
150  <code class="computeroutput">** Structure FILE_INFO, 21 tags, length=64, data length=63:</code>
151  <code class="computeroutput">   NAME            STRING    '/Users/sebastie/IDL/first_ps.ps'</code>
152  <code class="computeroutput">   EXISTS          BYTE         1</code>
153  <code class="computeroutput">   READ            BYTE         1</code>
154  <code class="computeroutput">   WRITE           BYTE         1</code>
155  <code class="computeroutput">   EXECUTE         BYTE         0</code>
156  <code class="computeroutput">   REGULAR         BYTE         1</code>
157  <code class="computeroutput">   DIRECTORY       BYTE         0</code>
158  <code class="computeroutput">   BLOCK_SPECIAL   BYTE         0</code>
159  <code class="computeroutput">   CHARACTER_SPECIAL</code>
160  <code class="computeroutput">                   BYTE         0</code>
161  <code class="computeroutput">   NAMED_PIPE      BYTE         0</code>
162  <code class="computeroutput">   SETUID          BYTE         0</code>
163  <code class="computeroutput">   SETGID          BYTE         0</code>
164  <code class="computeroutput">   SOCKET          BYTE         0</code>
165  <code class="computeroutput">   STICKY_BIT      BYTE         0</code>
166  <code class="computeroutput">   SYMLINK         BYTE         0</code>
167  <code class="computeroutput">   DANGLING_SYMLINK</code>
168  <code class="computeroutput">                   BYTE         0</code>
169  <code class="computeroutput">   MODE            LONG               420</code>
170  <code class="computeroutput">   ATIME           LONG64                1122424373</code>
171  <code class="computeroutput">   CTIME           LONG64                1122424373</code>
172  <code class="computeroutput">   MTIME           LONG64                1122424373</code>
173  <code class="computeroutput">   SIZE            LONG64                      4913</code>
174</pre><p>
175      </p>
176<p><a name="splot_description" id="splot_description"></a>
177<span class="command"><strong>splot</strong></span> accepts the same keywords as <span class="command"><strong>plot</strong></span> (<code class="computeroutput"><a name="plot_kwd" id="plot_kwd"></a>/ISOTROPIC, MAX_VALUE=value, MIN_VALUE=value, NSUM=value, /POLAR, THICK=value, /XLOG, /YLOG, /YNOZERO</code>), including the graphics keywords (<code class="computeroutput"><a name="gr_kwd" id="gr_kwd"></a>BACKGROUND, CHARSIZE, CHARTHICK, CLIP, COLOR, DATA, DEVICE, FONT, LINESTYLE, NOCLIP, NODATA, NOERASE, NORMAL, POSITION, PSYM, SUBTITLE, SYMSIZE, T3D, THICK, TICKLEN, TITLE, [XYZ]CHARSIZE, [XYZ]GRIDSTYLE, [XYZ]MARGIN, [XYZ]MINOR, [XYZ]RANGE, [XYZ]STYLE, [XYZ]THICK, [XYZ]TICKFORMAT, [XYZ]TICKINTERVAL, [XYZ]TICKLAYOUT, [XYZ]TICKLEN, [XYZ]TICKNAME, [XYZ]TICKS, [XYZ]TICKUNITS, [XYZ]TICKV, [XYZ]TICK_GET, [XYZ]TITLE, ZVALUE</code>).
178</p>
179<p>
180It can therefore be customized <span class="emphasis"><em>as much as you want</em></span>. See this short example:
181</p>
182<p>
183</p><pre class="screen">
184  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>splot, y, y^2, linestyle = 2, thick = 2, title = 'y = x^2', /portrait</strong></span></code></strong> <a class="link" href="./figpng/basic_splot2.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
185</pre><p>
186<span class="command"><strong>splot</strong></span> can be used to setup the graphic environment (<code class="varname">!p</code>, <code class="varname">!x</code>, <code class="varname">!y</code>, <code class="varname">!z</code> variables) needed by procedures like <span class="command"><strong>oplot</strong></span>
187</p><pre class="screen">
188  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>splot, y, yrange = [0, (n-1)^2], title = 'x and x^2'</strong></span></code></strong>
189  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>oplot, y^2, color = 50, linestyle = 2</strong></span></code></strong> <a class="link" href="./figpng/basic_splot4.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
190</pre><p>
191Use the keyword small to produce multi plots figures.
192</p><div class="screenco">
193 
194<pre class="screen">
195  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>splot, y, y^2, title = 'y = x^2', psym = 2, small <span class="inlinemediaobject"><img src="images/callouts/1.png" alt="1" /></span> = [1, 2, 1]</strong></span></code></strong>
196  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>splot, findgen(360)/36., findgen(360)*2.*!dtor, /polar $</strong></span></code></strong>
197  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>    , small <span class="inlinemediaobject"><img src="images/callouts/1.png" alt="1" /></span> = [1, 2, 2], /noerase <span class="inlinemediaobject"><img src="images/callouts/2.png" alt="2" /></span></strong></span></code></strong> <a class="link" href="./figpng/basic_splot3.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
198</pre>
199  <div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><img src="images/callouts/1.png" alt="1" border="0" /></p></td><td valign="top" align="left">
200     
201the <code class="computeroutput">small</code> keyword is a 3 elements vector which defines how we divide the page and in which case we should make the plot: [number of columns, number of rows, case number]. The case numbering is starting at 1, from top to bottom and left to right.
202     
203    </td></tr><tr><td width="5%" valign="top" align="left"><p><img src="images/callouts/2.png" alt="2" border="0" /></p></td><td valign="top" align="left">
204     
205you must put <code class="computeroutput">/noerase</code> otherwise the second plot will be done in a new window.
206     
207    </td></tr></table></div>
208</div><p>
209      </p>
210      </div>
211
212      <div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="basic_contour" id="basic_contour"></a>2.2.2.  scontour </h4></div></div></div>
213     
214      <p>
215Following <span class="command"><strong><a class="link" href="#basic_splot" title="2.2.1.  splot">splot</a></strong></span> example, we provide <span class="command"><strong>scontour</strong></span> as a “<span class="quote">super <span class="command"><strong>contour</strong></span></span>”.
216</p><pre class="screen">
217  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>z = dist(n)</strong></span></code></strong>
218  <code class="computeroutput">% Compiled module: DIST.</code>
219  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>scontour, z</strong></span></code></strong> <a class="link" href="./figpng/basic_scontour1.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
220  <code class="computeroutput">% Compiled module: SCONTOUR.</code>
221  <code class="computeroutput">% Compiled module: CHKSTRU.</code>
222</pre><p>
223<span class="command"><strong>scontour</strong></span> accepts the same keywords as <span class="command"><strong>contour</strong></span> (<code class="computeroutput">C_ANNOTATION=vector_of_strings, C_CHARSIZE=value, C_CHARTHICK=integer, C_COLORS=vector, C_LABELS=vector{each element 0 or 1}, C_LINESTYLE=vector, { /FILL | /CELL_FILL | C_ORIENTATION=degrees}, C_SPACING=value, C_THICK=vector, /CLOSED, /DOWNHILL, /FOLLOW, /IRREGULAR, /ISOTROPIC, LEVELS=vector, NLEVELS=integer{1 to 60}, MAX_VALUE=value, MIN_VALUE=value, /OVERPLOT, {/PATH_DATA_COORDS, PATH_FILENAME=string, PATH_INFO=variable, PATH_XY=variable}, TRIANGULATION=variable, /PATH_DOUBLE, /XLOG, /YLOG, ZAXIS={0 | 1 | 2 | 3 | 4}</code>), including the <a class="link" href="#gr_kwd">graphics keywords</a> (except <code class="computeroutput">LINESTYLE, PSYM, SYMSIZE</code>).
224      </p>
225      <p>It can therefore be customized <span class="emphasis"><em>as much as you want</em></span>. See these short examples:</p>
226      <p>
227</p><pre class="screen">
228  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>scontour, z, /fill, nlevels = 15, subtitle = 'nicer contour' $</strong></span></code></strong>
229  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>    , xtitle = 'x index', charsize = 1.5</strong></span></code></strong> <a class="link" href="./figpng/basic_scontour2.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
230</pre><p>
231It can be used in combination with contour to make more complex plots:
232</p><div class="screenco">
233 
234<pre class="screen">
235  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>ind = findgen(2*n)/(2.*n)</strong></span></code></strong>
236  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>scontour, z, levels = n*ind, c_orientation = 180*ind, c_spacing = 0.4*ind</strong></span></code></strong>
237  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>contour, z, /overplot, c_label = rebin([1, 0], 2, n) <span class="inlinemediaobject"><img src="images/callouts/1.png" alt="1" /></span>, levels = n*ind $</strong></span></code></strong>
238  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>    , c_charthick = 2, c_charsize = 1.5, c_colors = 250*ind</strong></span></code></strong> <a class="link" href="./figpng/basic_scontour3.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
239</pre>
240<div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><img src="images/callouts/1.png" alt="1" border="0" /></p></td><td valign="top" align="left">
241    <p>
242      <span class="command"><strong>rebin</strong></span> is used to build an array containing an alternation of 1 and 0 in order to label one contour every two contours.
243</p><pre class="screen">
244  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>print, rebin([1, 0], 2, 3)</strong></span></code></strong>
245  <code class="computeroutput">       1       0</code>
246  <code class="computeroutput">       1       0</code>
247  <code class="computeroutput">       1       0</code>
248</pre><p>
249    </p>
250  </td></tr></table></div>
251</div><p>
252<span class="command"><strong>scontour</strong></span> is compatible with the positioning method associated with the <code class="computeroutput">small</code> keyword. See for example the test file <a class="link" href="../../Tests/tst_basic.pro" target="_top"><code class="filename">tst_basic.pro</code></a>:
253</p><pre class="screen">
254  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>tst_basic</strong></span></code></strong> <a class="link" href="./figpng/tst_basic.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
255</pre><p>
256      </p>
257      </div>
258
259      <div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="tvplus" id="tvplus"></a>2.2.3.  Quick look and explore 2D arrays: <span class="command"><strong>tvplus</strong></span> </h4></div></div></div>
260
261<p>
262  <span class="command"><strong>tvplus</strong></span> is a enhanced version of <span class="command"><strong>tvscl</strong></span> and allow you to have a quick look and perform basic exploration of 2D arrays.
263</p><pre class="screen">
264 <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>tvplus, dist(20)</strong></span></code></strong> <a class="link" href="./figpng/tvplus.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
265 <code class="computeroutput">left button  : mouse position and associated array value</code>
266 <code class="computeroutput">middle button: use it twice to define a zoom box</code>
267 <code class="computeroutput">right button : quit</code>
268 <code class="computeroutput">(x, y) = (  5,   5), value = 7.07107</code>
269 <code class="computeroutput">(x, y) = ( 12,   8), value = 11.3137</code>
270 </pre><p>
271</p>
272<p>
273For more informations on <span class="command"><strong>tvplus</strong></span>, try:
274</p><pre class="screen">
275 <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>xhelp, 'tvplus'</strong></span></code></strong>
276</pre><p>
277</p>
278<p>
279To see the source code of <span class="command"><strong>tvplus</strong></span>, try:
280</p><pre class="screen">
281 <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>xfile, 'tvplus'</strong></span></code></strong>
282</pre><p>
283</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">New Feature</h3>
284<p>
285If you use an IDL 6.2 or later revision, you can simply get the help of any command by typing ?<em class="replaceable"><code>command_name</code></em>, for example:
286</p><pre class="screen">
287 <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>?tvplus</strong></span></code></strong>
288</pre><p>
289</p>
290</div><p>
291</p>
292</div>
293
294      <div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="pltv" id="pltv"></a>2.2.4.  Formal quick look at 2D arrays: pltv </h4></div></div></div>
295
296<p>
297  <span class="command"><strong>pltv</strong></span> is a mix between <a class="link" href="#tvplus" title="2.2.3.  Quick look and explore 2D arrays: tvplus">tvplus</a> and <a class="link" href="#plt" title="3.2.  Horizontal plots and maps">plt</a> and allow you to have formal quick look of 2D arrays.
298  </p><pre class="screen">
299  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>pltv, dist(20)</strong></span></code></strong> <a class="link" href="./figpng/pltv.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a>
300  </pre><p>
301</p>
302      </div>
303    </div>
304  </div>
305
306  <div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="gridded_data" id="gridded_data"></a>3.  Explore gridded data (model outputs and observations) </h2></div></div></div>
307   
308    <p>
309      This section briefly describes the main functionalities offered by SAXO to explore gridded data on regular or irregular grid.
310    </p>
311
312    <div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="load_grid" id="load_grid"></a>3.1.  Load the data grid </h3></div></div></div>
313     
314      <p>
315As we focus in this section on the gridded data, we must first load the grid informations before reading and plotting the data. Loading the grid independently of the data allow you to reload the grid only when it is strictly necessary and not every time you access the data. In <code class="filename">${HOME}/SAXO_DIR/Tests/</code>, we provide several examples to load a grid.
316      </p>
317      <div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="load_fromdata" id="load_fromdata"></a>3.1.1.  Easiest solution: load data grid (regular or not) directly from the data file </h4></div></div></div>
318
319<p>
320  Example of Levitus temperature on a regular 1x1 grid.
321  </p><pre class="screen">
322  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>@tst_initlev</strong></span></code></strong>
323  <code class="computeroutput">% Compiled module: INITNCDF.</code>
324  <code class="computeroutput">% Compiled module: ISAFILE.</code>
325  <code class="computeroutput">% Compiled module: UNIQ.</code>
326  <code class="computeroutput">% Loaded DLM: NCDF.</code>
327  <code class="computeroutput">% Compiled module: COMPUTEGRID.</code>
328  <code class="computeroutput">% Compiled module: DOMDEF.</code>
329  <code class="computeroutput">% Compiled module: INTER.</code>
330  <code class="computeroutput">% Compiled module: TRIANGULE.</code>
331  <code class="computeroutput">% Compiled module: TRIANGULE_C.</code>
332  <code class="computeroutput">% Compiled module: UNDEFINE.</code>
333  <code class="computeroutput">% Compiled module: TESTVAR.</code>
334  <code class="computeroutput">% Compiled module: DIFFERENT.</code>
335  <code class="computeroutput">% Compiled module: DEFINETRI.</code>
336  </pre><p>
337  This <a class="link" href="../../Tests/tst_initlev.pro" target="_top"><span class="command"><strong>@tst_initlev</strong></span></a> command allows us to define:
338  </p><div class="itemizedlist"><ul type="disc"><li>domain dimensions, stored in <code class="varname">jpi, jpj and jpk</code></li><li>points abscissa, stored in 2D array <code class="varname"></code>glamt</li><li>points ordinates, stored in 2D array <code class="varname"></code>gphit</li><li>points depths, stored in 1D array <code class="varname"></code>gdept</li><li>cells corners abscissa, stored in 2D array <code class="varname"></code>glamf</li><li>cells corners ordinates, stored in 2D array <code class="varname"></code>gphif</li><li>cells upper boundary depth, stored in 1D array <code class="varname"></code>gdepw</li><li>land-sea mask, stored in <code class="varname">tmask</code></li><li>the cells size in the longitudinal direction, stored in 2D array <code class="varname"></code>e1t</li><li>the cells size in the latitudinal direction, stored in 2D array <code class="varname"></code>e2t</li><li>the cells size in the vertical direction, stored in 1D array <code class="varname"></code>e3t</li><li>the triangulation used to fill the land points, stored in <code class="varname"></code>triangles_list</li></ul></div><p>
339
340  </p><pre class="screen">
341  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>help, jpi,jpj,jpk</strong></span></code></strong>
342  <code class="computeroutput">JPI (LOCAL_COORD)   LONG      =          360</code>
343  <code class="computeroutput">JPJ (LOCAL_COORD)   LONG      =          180</code>
344  <code class="computeroutput">JPK (LOCAL_COORD)   LONG      =           33</code>
345  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>help, glamt, gphit,glamf, gphif</strong></span></code></strong>
346  <code class="computeroutput">GLAMT (LONGITUDES)  FLOAT     = Array[360, 180]</code>
347  <code class="computeroutput">GPHIT (LATITUDES)   FLOAT     = Array[360, 180]</code>
348  <code class="computeroutput">GLAMF (LONGITUDES)  FLOAT     = Array[360, 180]</code>
349  <code class="computeroutput">GPHIF (LATITUDES)   FLOAT     = Array[360, 180]</code>
350  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>help, gdept, gdepw</strong></span></code></strong>
351  <code class="computeroutput">GDEPT (VERTICAL)    FLOAT     = Array[33]</code>
352  <code class="computeroutput">GDEPW (VERTICAL)    FLOAT     = Array[33]</code>
353  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>help, e1t, e2t, e3t</strong></span></code></strong>
354  <code class="computeroutput">E1T (SCALE_FACTORS) FLOAT     = Array[360, 180]</code>
355  <code class="computeroutput">E2T (SCALE_FACTORS) FLOAT     = Array[360, 180]</code>
356  <code class="computeroutput">E3T (VERTICAL)      FLOAT     = Array[33]</code>
357  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>help, tmask</strong></span></code></strong>
358  <code class="computeroutput">TMASK (MASKS)       BYTE      = Array[360, 180, 33]</code>
359  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>help, triangles_list</strong></span></code></strong>
360  <code class="computeroutput">TRIANGLES_LIST (LIEES_A_TRIANGULE) LONG      = Array[3, 128880]</code>
361  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>tvplus, glamt*tmask[*,*,0]</strong></span></code></strong>
362  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>tvplus, gphit*tmask[*,*,0]</strong></span></code></strong>
363  </pre><p>
364  We provide other initialization methods/examples
365  </p><div class="itemizedlist"><ul type="disc"><li><a class="link" href="../../Tests/tst_initorca2_short.pro" target="_top">@tst_initorca2_short</a> : ORCA2 example</li><li><a class="link" href="../../Tests/tst_initorca05_short.pro" target="_top">@tst_initorca05_short</a> : ORCA05 example</li><li><a class="link" href="../../Tests/tst_initlev_stride.pro" target="_top">@tst_initlev_stride</a> : same as @tst_initlev but we skip on point over 2 in x and y direction</li><li><a class="link" href="../../Tests/tst_initorca2_short_stride.pro" target="_top">@tst_initorca2_short_stride</a> : ORCA2 with stride</li><li><a class="link" href="../../Tests/tst_initorca05_short_stride.pro" target="_top">@tst_initorca05_short_stride</a> : ORCA05 with stride</li><li><a class="link" href="../../Tests/tst_initlev_index.pro" target="_top">@tst_initlev_index</a> : in that case we load the grid using points index as axis instead of the longitude/latitude position</li><li><a class="link" href="../../Tests/tst_initorca2_index.pro" target="_top">@tst_initorca2_index</a> : load ORCA2 as it see by the model</li><li><a class="link" href="../../Tests/tst_initorca05_index.pro" target="_top">@tst_initorca05_index</a> : load ORCA05 as it see by the model</li><li><a class="link" href="../../Tests/tst_initlev_index_stride.pro" target="_top">@tst_initlev_index_stride</a> : @tst_initlev_index with stride</li><li><a class="link" href="../../Tests/tst_initorca2_index_stride.pro" target="_top">@tst_initorca2_index_stride</a> : ORCA2 in index with stride</li><li><a class="link" href="../../Tests/tst_initorca05_index_stride.pro" target="_top">@tst_initorca05_index_stride</a> : ORCA05 in index with stride</li></ul></div><p>
366</p>
367      </div>
368      <div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="load_meshmask" id="load_meshmask"></a>3.1.2.  Load the grid from OPA <code class="filename">meshmask</code> file </h4></div></div></div>
369
370<p>
371  When the grid is really irregular (its abscissa and ordinate cannot be descried by a vector), loading the grid directly from the data forces us to make an approximation when computing the grid corners position and the cells size. In that case, it can be preferable to load the grid from the meshmask file created by OPA. As OPA use a Arakawa-C discretization, loading the grid from the meshmask will also define all parameters related to the U, V and F grids (glam[uv],gphi[uv], e[12][uvf]). Note that, when using a simple <a class="link" href="#load_fromdata" title="3.1.1.  Easiest solution: load data grid (regular or not) directly from the data file">grid definition from the data itself</a> (with <code class="filename">initncdf</code> or <code class="filename">computegrid</code>), adding the keyword /FULLCGRID leads also to the definition of all U, V and F grids parameters. There is the examples to load ORCA grids from OPA meshmask.
372  </p><div class="itemizedlist"><ul type="disc"><li><a class="link" href="../../Tests/tst_initorca2.pro" target="_top">@tst_initorca2</a> : ORCA2</li><li><a class="link" href="../../Tests/tst_initorca05.pro" target="_top">@tst_initorca05</a> : ORCA05</li><li><a class="link" href="../../Tests/tst_initorca2_stride.pro" target="_top">@tst_initorca2_stride</a> : ORCA2 with stride</li><li><a class="link" href="../../Tests/tst_initorca05_stride.pro" target="_top">@tst_initorca05_stride</a> : ORCA05 with stride</li><li><a class="link" href="../../Tests/tst_initorca2_index.pro" target="_top">@tst_initorca2_index</a> : load ORCA2 as it see by the model</li><li><a class="link" href="../../Tests/tst_initorca05_index.pro" target="_top">@tst_initorca05_index</a> : load ORCA05 as it see by the model</li><li><a class="link" href="../../Tests/tst_initorca2_index_stride.pro" target="_top">@tst_initorca2_index_stride</a> : ORCA2 in index with stride</li><li><a class="link" href="../../Tests/tst_initorca05_index_stride.pro" target="_top">@tst_initorca05_index_stride</a> : ORCA05 in index with stride</li></ul></div><p>
373</p>
374        </div>
375    </div>
376
377    <div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plt" id="plt"></a>3.2.  Horizontal plots and maps </h3></div></div></div>
378     
379<p>
380  A quick presentation of horizontal plots and maps is shown in <a class="link" href="../../Tests/tst_plt.pro" target="_top">tst_plt</a>. After loading any of the grid (for example with one of the <a class="link" href="#load_grid" title="3.1.  Load the data grid">above examples</a>). Just try:
381  </p><pre class="screen">
382  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>tst_plt</strong></span></code></strong>
383  </pre><p>
384</p>
385<p><span class="emphasis"><em>Beware, the command is <span class="command"><strong>tst_plt</strong></span> and not <span class="command"><strong>@tst_plt</strong></span> as <code class="filename">tst_plt.pro</code> is a procedure and not an include.</em></span></p>
386<p>
387  See the results with
388  </p><div class="itemizedlist"><ul type="disc"><li><span class="command"><strong>@tst_initlev</strong></span> <a class="link" href="figpng/tst_plt_lev_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca2</strong></span> <a class="link" href="figpng/tst_plt_orca2_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca05</strong></span> <a class="link" href="figpng/tst_plt_orca05_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initlev_stride</strong></span> <a class="link" href="figpng/tst_plt_lev_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_lev_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca2_stride</strong></span> <a class="link" href="figpng/tst_plt_orca2_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca2_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca05_stride</strong></span> <a class="link" href="figpng/tst_plt_orca05_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_plt_orca05_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li></ul></div><p>
389</p>
390    </div>
391
392<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="pltz" id="pltz"></a>3.3.  Vertical sections </h3></div></div></div>
393
394<p>
395  A quick presentation of vertical sections is shown in <a class="link" href="../../Tests/tst_pltz.pro" target="_top">tst_pltz</a>. After loading any of the grid (for example with one of the <a class="link" href="#load_grid" title="3.1.  Load the data grid">above examples</a>). Just try:
396  </p><pre class="screen">
397  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>tst_pltz</strong></span></code></strong>
398  </pre><p>
399</p>
400  <p><span class="emphasis"><em>Beware, the command is <span class="command"><strong>tst_pltz</strong></span> and not <span class="command"><strong>@tst_pltz</strong></span> as <code class="filename">tst_pltz.pro</code> is a procedure and not an include.</em></span></p>
401<p>
402  See the results with
403  </p><div class="itemizedlist"><ul type="disc"><li><span class="command"><strong>@tst_initlev</strong></span> <a class="link" href="figpng/tst_pltz_lev_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca2</strong></span> <a class="link" href="figpng/tst_pltz_orca2_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_12.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca05</strong></span> <a class="link" href="figpng/tst_pltz_orca05_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_12.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initlev_stride</strong></span> <a class="link" href="figpng/tst_pltz_lev_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_lev_stride_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca2_stride</strong></span> <a class="link" href="figpng/tst_pltz_orca2_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca2_stride_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca05_stride</strong></span> <a class="link" href="figpng/tst_pltz_orca05_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_07.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_08.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_09.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_10.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltz_orca05_stride_11.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li></ul></div><p>
404</p>
405    </div>
406
407    <div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="pltt" id="pltt"></a>3.4.  Hovmoellers and time series </h3></div></div></div>
408     
409<p>
410  A quick presentation of hovmoellers and time series is shown in <a class="link" href="../../Tests/tst_pltt.pro" target="_top">tst_pltt</a>. After loading any of the grid (for example with one of the <a class="link" href="#load_grid" title="3.1.  Load the data grid">above examples</a>). Just try:
411  </p><pre class="screen">
412  <code class="prompt">idl&gt;</code> <strong class="userinput"><code><span class="command"><strong>tst_pltt</strong></span></code></strong>
413  </pre><p>
414</p>
415  <p><span class="emphasis"><em>Beware, the command is <span class="command"><strong>tst_pltt</strong></span> and not <span class="command"><strong>@tst_pltt</strong></span> as <code class="filename">tst_pltt.pro</code> is a procedure and not an include.</em></span></p>
416<p>
417  See the results with
418  </p><div class="itemizedlist"><ul type="disc"><li><span class="command"><strong>@tst_initlev</strong></span> <a class="link" href="figpng/tst_pltt_lev_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca2</strong></span> <a class="link" href="figpng/tst_pltt_orca2_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca05</strong></span> <a class="link" href="figpng/tst_pltt_orca05_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initlev_stride</strong></span> <a class="link" href="figpng/tst_pltt_lev_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_lev_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca2_stride</strong></span> <a class="link" href="figpng/tst_pltt_orca2_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca2_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li><li><span class="command"><strong>@tst_initorca05_stride</strong></span> <a class="link" href="figpng/tst_pltt_orca05_stride_01.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_stride_02.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_stride_03.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_stride_04.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_stride_05.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a> <a class="link" href="figpng/tst_pltt_orca05_stride_06.png" target="_top"><span class="inlinemediaobject"><img src="images/showfig.png" alt="show result" /></span></a></li></ul></div><p>
419</p>
420    </div>
421
422<div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="plt1d" id="plt1d"></a>3.5.  1D plots </h3></div></div></div>
423
424<p>
425To be continued 

426</p>
427</div>
428
429
430</div>
431
432</div>
433  </body>
434</html>
Note: See TracBrowser for help on using the repository browser.