source: trunk/SRC/Documentation/idldoc_html_output/ToBeReviewed/PLOTS/DESSINE/plt1d.html

Last change on this file was 402, checked in by smasson, 15 years ago

update documentation

File size: 12.9 KB
Line 
1
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
5<!-- Generated by IDLdoc 2.0 -->
6
7<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
8  <head>
9    <title>plt1d.pro (SAXO Documentation)</title>
10
11   
12    <link rel="stylesheet" type="text/css" media="all" href="./../../../main_files.css" />
13    <link rel="stylesheet" type="text/css" media="print" href="./../../../main_files_print.css" />
14   
15
16    <script type="text/javascript">
17      function setTitle() {
18        parent.document.title="plt1d.pro (SAXO Documentation)";
19      }
20    </script>
21  </head>
22
23  <body onload="setTitle();">
24
25    <div id="navbar_title">
26  <h1>SAXO Documentation</h1>
27</div>
28
29
30<div id="main_navbar">
31
32  <table cellspacing="0">
33    <tr>
34     
35      <td><a href="./../../../overview.html" title="Overview of library">Overview</a></td>
36     
37
38     
39      <td >Directory</td>
40     
41
42     
43      <td><a href="./../../../idldoc-categories.html" title="Browse library by category">Categories</a></td>
44     
45
46     
47      <td><a href="./../../../idldoc-index.html" title="Index of files, routines, and parameters">Index</a></td>
48     
49
50     
51      <td><a href="./../../../search-page.html" title="Search library">Search</a></td>
52     
53
54      <td id="selected">File</td>
55
56     
57      <td><a href="../../../../../ToBeReviewed/PLOTS/DESSINE//plt1d.pro" title="Source code of a file">Source</a></td>
58     
59
60     
61      <td><a href="./../../../idldoc-help.html" title="Help on IDLdoc">Help</a></td>
62     
63
64      <td >Etc</td>
65
66      <td id="flexible">Developer&nbsp;documentation</td>
67    </tr>
68  </table>
69
70</div>
71
72<div id="secondary_navbar">
73
74<a href="plt.html">&lt;&lt;prev file</a> | <a href="pltbase.html">next file &gt;&gt;</a>&nbsp;&nbsp;&nbsp;&nbsp;<a href="plt1d.html" target="_TOP">view single page</a> | <a href="./../../../index.html" target="_TOP">view frames</a>&nbsp;&nbsp;&nbsp;&nbsp;summary: fields | routine&nbsp;&nbsp;&nbsp;&nbsp;details: <a href="#routine_details">routine</a>
75
76</div>
77
78
79    <div id="container">
80
81      <h1 class="directory"><a href="directory-overview.html">ToBeReviewed/PLOTS/DESSINE/</a></h1>
82      <h2 class="pro_file">plt1d.pro</h2>
83
84      <div id="file_attr">
85        <dl>
86        </dl>
87      </div>
88
89      <div id="file_comments">
90 Trace 1d graphs: x,y,z (or t but in this case, we recall directly pltt)
91</div>
92
93     
94
95     
96
97     
98
99     
100
101      <div id="routine_details">
102       
103
104        <div class="routine_details" id="_plt1d">
105
106          <h2><a class="top" href="#container">top</a>plt1d <span class="categories">
107 Graphics
108</span></h2>
109       
110          <p class="header">
111            plt1d<span class="result">, <a href="#_plt1d_param_tab">tab</a>, <a href="#_plt1d_param_param2">param2</a>[, <a href="#_plt1d_param_param3">param3</a>][, <a href="#_plt1d_param_param4">param4</a>]</span>, <a href="#_plt1d_keyword_BOXZOOM">BOXZOOM</a>=<span class="result">BOXZOOM</span>, <a href="#_plt1d_keyword_SIN">SIN</a>=<span class="result">SIN</span>, <a href="#_plt1d_keyword_MININ">MININ</a>=<span class="result">MININ</span>, <a href="#_plt1d_keyword_MAXIN">MAXIN</a>=<span class="result">MAXIN</span>, <a href="#_plt1d_keyword_TYPEIN">TYPEIN</a>=<span class="result">TYPEIN</span>, <a href="#_plt1d_keyword_ENDPOINTS">ENDPOINTS</a>=<span class="result">ENDPOINTS</span>, <a href="#_plt1d_keyword_COL1D">COL1D</a>=<span class="result">COL1D</span>, <a href="#_plt1d_keyword_STY1D">STY1D</a>=<span class="result">STY1D</span>, <a href="#_plt1d_keyword_OV1D">OV1D</a>=<span class="result">OV1D</span>, <a href="#_plt1d_keyword_X">X</a>=<span class="result">X</span>, <a href="#_plt1d_keyword_Y">Y</a>=<span class="result">Y</span>, <a href="#_plt1d_keyword_Z">Z</a>=<span class="result">Z</span>, <a href="#_plt1d_keyword_TT">TT</a>=<span class="result">TT</span>, <a href="#_plt1d_keyword_REVERSE_X">REVERSE_X</a>=<span class="result">REVERSE_X</span>, <a href="#_plt1d_keyword_REVERSE_Y">REVERSE_Y</a>=<span class="result">REVERSE_Y</span>, <a href="#_plt1d_keyword_SWITCHXY">SWITCHXY</a>=<span class="result">SWITCHXY</span>, <a href="#_plt1d_keyword__EXTRA">_EXTRA</a>=<span class="result">_EXTRA</span></p>
112       
113          <div class="comments">
114</div>
115
116         
117
118         
119            <h3>Parameters</h3>
120       
121           
122            <h4 id="_plt1d_param_tab">tab&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
123              <span class="attr">in</span>
124             
125             
126              <span class="attr">required</span>
127             
128             
129             
130             
131            </h4>
132       
133          <div class="comments">
134 The field whose we want to make the hovmoeller map can be 2 kind of thing:
135 1) An array which can be:
136
137   * 2d, 3d or 4d:  array xy, xyz. xyt or xyzt. In this case, the array
138     will pass in <a href="../../..//ToBeReviewed/CALCULS/moyenne.html">moyenne</a> or <a href="../../..//ToBeReviewed/CALCULS/grossemoyenne.html">grossemoyenne</a> to be
139     averaged and become an array 1d.
140   * 1d:Nevertheless, the type must be specified in order to we know which
141     trace it is about. To have a correct caption, respecify the extraction
142     zone via BOXZOOM.
143 2) a structure respecting all criterions specified by <a href="../../..//ToBeReviewed/LECTURE/litchamp.html">litchamp</a>
144    The array contained in the structure respecting criterions of case 1)
145</div>
146           
147            <h4 id="_plt1d_param_param2">param2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
148              <span class="attr">in</span>
149             
150             
151              <span class="attr">required</span>
152             
153             
154             
155             
156            </h4>
157       
158          <div class="comments">
159 Min value we want to consider in the contour's drawing.
160 Note: could also be the type of plot:'x','y','z'
161</div>
162           
163            <h4 id="_plt1d_param_param3">param3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
164              <span class="attr">in</span>
165             
166              <span class="attr">optional</span>
167             
168             
169             
170              <span class="attr">default:</span> <span class="value">min/max of tab (on ocean points)</span>
171             
172            </h4>
173       
174          <div class="comments">
175 Max value we want to consider in the contour's drawing.
176 Note: if param2 is defined as 'x','y','z' then param3 is used to define the min (see param2)
177</div>
178           
179            <h4 id="_plt1d_param_param4">param4&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
180              <span class="attr">in</span>
181             
182              <span class="attr">optional</span>
183             
184             
185             
186              <span class="attr">default:</span> <span class="value">max of tab (on ocean points)</span>
187             
188            </h4>
189       
190          <div class="comments">
191 Type of plot (can be only 'x','y','z' for plt1d).
192 Note: if param2 is defined as 'xy' then param4 is used to define the max (see param3)
193</div>
194           
195
196         
197
198         
199
200            <h3>Keywords</h3>
201           
202            <h4 id="_plt1d_keyword_BOXZOOM">BOXZOOM&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
203             
204             
205             
206             
207             
208             
209             
210             
211            </h4>
212       
213            <div class="comments">
214 Vector indicating the geographic zone (3d) on which the extraction of the
215 field must be done to do the hovmoeller.
216
217 If BOXZOOM has :
218 1 element : The extraction is made on [lon1, lon2, lat1, lat2, 0.,boxzoom[0]]
219 2 elements: The extraction is made on [lon1, lon2, lat1, lat2, boxzoom[0],boxzoom[1]]
220 4 elements: The extraction is made on [Boxzoom, vert1, vert2]
221 5 elements: The extraction is made on [Boxzoom[0:3], 0, Boxzoom[4]]
222 6 elements: The extraction is made on Boxzoom
223
224 Where lon1, lon2,lat1,lat2,vert1,vert2 are global variables defined at
225 the last <a href="../../..//ToBeReviewed/GRILLE/domdef.html">domdef</a> !
226</div>
227           
228            <h4 id="_plt1d_keyword_SIN">SIN&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
229             
230             
231             
232             
233             
234             
235             
236             
237            </h4>
238       
239            <div class="comments">
240 Activate this keyword if we want the x axis to be traced in sinus of the
241 latitude when we make a drawing f(y)
242</div>
243           
244            <h4 id="_plt1d_keyword_MININ">MININ&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
245             
246             
247             
248             
249             
250             
251             
252             
253            </h4>
254       
255            <div class="comments">
256 Allows to specify the min value we want to consider in the drawing of contour
257 helping by the keyword instead of the argument min.
258 If the argument and the keyword are specified in the same time, it is the
259 value specified by the keyword which is retained.
260</div>
261           
262            <h4 id="_plt1d_keyword_MAXIN">MAXIN&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
263             
264             
265             
266             
267             
268             
269             
270             
271            </h4>
272       
273            <div class="comments">
274 Allows to specify the max value we want to consider in the drawing of contour
275 helping by the keyword instead of the argument max.
276 If the argument and the keyword are specified in the same time, it is the
277 value specified by the keyword which is retained.
278</div>
279           
280            <h4 id="_plt1d_keyword_TYPEIN">TYPEIN&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
281             
282             
283             
284             
285             
286             
287             
288             
289            </h4>
290       
291            <div class="comments">
292 allows to specify the type of hovmoeller we want to do
293             'xt','yt','zt','t'
294 with help of a keyword rather than the argument type. If the argument and the
295 keyword are specified in the same time, it is the value specified by the
296 keyword which is retained.
297</div>
298           
299            <h4 id="_plt1d_keyword_ENDPOINTS">ENDPOINTS&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
300             
301             
302             
303             
304             
305             
306             
307             
308            </h4>
309       
310            <div class="comments">
311 keyword specifying that we want to make a vertical cut in diagonal.
312 Then coordinated of extremities of these ones are defined by the 4 elements
313 of the vector ENDPOINTS: [x1,y1,x2,y2] which are coordinates.
314</div>
315           
316            <h4 id="_plt1d_keyword_COL1D">COL1D&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
317             
318             
319             
320             
321             
322             
323             
324             
325            </h4>
326       
327            <div class="comments">
328  --OBSOLETE--Color number when we make a trace 1d by default, 0.
329 It is better to use the keyword COLOR used by plot.
330</div>
331           
332            <h4 id="_plt1d_keyword_STY1D">STY1D&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
333             
334             
335             
336             
337             
338             
339             
340             
341            </h4>
342       
343            <div class="comments">
344 --OBSOLETE--
345 Number of the style used when we make a 1d drawing. We should better use the
346 keyword LINESTYLE which is tho one of the plot. Beware, this keyword is still
347 useful if we want to d bars instead of curves, put sty1d='bar'
348</div>
349           
350            <h4 id="_plt1d_keyword_OV1D">OV1D&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
351             
352             
353             
354             
355             
356             
357             
358             
359            </h4>
360       
361            <div class="comments">
362 Allow the double exposure of an 1d curve to a precedent 1d trace.
363</div>
364           
365            <h4 id="_plt1d_keyword_X">X&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
366             
367             
368             
369             
370             
371             
372             
373             
374            </h4>
375       
376            <div class="comments"></div>
377           
378            <h4 id="_plt1d_keyword_Y">Y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
379             
380             
381             
382             
383             
384             
385             
386             
387            </h4>
388       
389            <div class="comments"></div>
390           
391            <h4 id="_plt1d_keyword_Z">Z&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
392             
393             
394             
395             
396             
397             
398             
399             
400            </h4>
401       
402            <div class="comments"></div>
403           
404            <h4 id="_plt1d_keyword_TT">TT&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
405             
406             
407             
408             
409             
410             
411             
412             
413            </h4>
414       
415            <div class="comments"></div>
416           
417            <h4 id="_plt1d_keyword_REVERSE_X">REVERSE_X&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
418             
419             
420             
421             
422             
423             
424             
425             
426            </h4>
427       
428            <div class="comments">
429 To invert the x axis (so as the drawing)
430</div>
431           
432            <h4 id="_plt1d_keyword_REVERSE_Y">REVERSE_Y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
433             
434             
435             
436             
437             
438             
439             
440             
441            </h4>
442       
443            <div class="comments">
444 To invert the y axis (so as the drawing)
445</div>
446           
447            <h4 id="_plt1d_keyword_SWITCHXY">SWITCHXY&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
448             
449             
450             
451             
452             
453             
454             
455             
456            </h4>
457       
458            <div class="comments"></div>
459           
460            <h4 id="_plt1d_keyword__EXTRA">_EXTRA&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
461             
462             
463             
464             
465             
466             
467             
468             
469            </h4>
470       
471            <div class="comments">
472 Used to pass keywords
473</div>
474           
475         
476
477         
478          <h3>Version history</h3>
479         
480          <h4>Version</h4><div class="preformat">
481 $Id: plt1d.pro 378 2008-08-12 12:35:46Z pinsard $
482</div>
483          <h4>History</h4><div class="preformat">
484 creation 24/6/99 Eric Guilyardi
485 (a partir routine pltt de Sebastien Masson)
486 8/7/1999 Sebastien Masson (smasson@lodyc.jussieu.fr)
487 inspection des travaux finis
488 8/2/2000 Sebastien Masson: checkfield
489</div>
490         
491         
492         
493         
494         
495         
496         
497       
498         
499         
500         
501         
502         
503         
504         
505       
506          <h3>Statistics</h3>
507          <table class="statistics">
508            <tr><td>McCabe cyclic</td><td>          61</td></tr>
509            <tr><td>McCabe essential</td><td>           3</td></tr>
510            <tr><td>McCabe modular design</td><td>           1</td></tr>
511          </table>
512         
513       
514        </div>
515       
516      </div>
517
518     
519
520      <div id="tagline">Produced by IDLdoc 2.0.</div>
521
522    </div>
523
524  </body>
525</html>
Note: See TracBrowser for help on using the repository browser.