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

Last change on this file since 338 was 338, checked in by smasson, 16 years ago

update documentation

File size: 12.8 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          * 2d, 3d or 4d:  array xy, xyz. xyt or xyzt. In this case, the array will pass
137          in moyenne or grossemoyenne to be averaged and become  an array 1d.
138          * 1d:Nevertheless, the type must be specified in order to we know which trace
139          it is about. To have a correct caption, respecify the  extraction zone via BOXZOOM.
140       2) a structure respecting all criterions specified by <a href="../../..//ToBeReviewed/LECTURE/litchamp.html">litchamp</a>
141          See IDL> xhelp,'litchamp'. The array contained in the structure
142          respecting criterions of case 1)
143</div>
144           
145            <h4 id="_plt1d_param_param2">param2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
146              <span class="attr">in</span>
147             
148             
149              <span class="attr">required</span>
150             
151             
152             
153             
154            </h4>
155       
156          <div class="comments">
157 Min value we want to consider in the contour's drawing.
158 Note: could also be the type of plot:'x','y','z'
159</div>
160           
161            <h4 id="_plt1d_param_param3">param3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
162              <span class="attr">in</span>
163             
164              <span class="attr">optional</span>
165             
166             
167             
168              <span class="attr">default:</span> <span class="value">min/max of tab (on ocean points)</span>
169             
170            </h4>
171       
172          <div class="comments">
173 Max value we want to consider in the contour's drawing.
174 Note: if param2 is defined as 'x','y','z' then param3 is used to define the min (see param2)
175</div>
176           
177            <h4 id="_plt1d_param_param4">param4&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
178              <span class="attr">in</span>
179             
180              <span class="attr">optional</span>
181             
182             
183             
184              <span class="attr">default:</span> <span class="value">max of tab (on ocean points)</span>
185             
186            </h4>
187       
188          <div class="comments">
189 Type of plot (can be only 'x','y','z' for plt1d).
190 Note: if param2 is defined as 'xy' then param4 is used to define the max (see param3)
191</div>
192           
193
194         
195
196         
197
198            <h3>Keywords</h3>
199           
200            <h4 id="_plt1d_keyword_BOXZOOM">BOXZOOM&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
201             
202             
203             
204             
205             
206             
207             
208             
209            </h4>
210       
211            <div class="comments">
212 Vector indicating the geographic zone (3d) on which the extraction of the field must
213 be done to do the hovmoeller.
214  If BOXZOOM has :
215 1 element : The extraction is made on [lon1, lon2, lat1, lat2, 0.,boxzoom[0]]
216 2 elements: The extraction is made on [lon1, lon2, lat1, lat2, boxzoom[0],boxzoom[1]]
217 4 elements: The extraction is made on [Boxzoom, vert1, vert2]
218 5 elements: The extraction is made on [Boxzoom[0:3], 0, Boxzoom[4]]
219 6 elements: The extraction is made on Boxzoom
220
221 Where lon1, lon2,lat1,lat2,vert1,vert2 are global variables defined at the last
222 <a href="../../..//ToBeReviewed/GRILLE/domdef.html">domdef</a> !
223</div>
224           
225            <h4 id="_plt1d_keyword_SIN">SIN&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
226             
227             
228             
229             
230             
231             
232             
233             
234            </h4>
235       
236            <div class="comments">
237 Activate this keyword if we want the x axis to be traced in sinus of the
238 latitude when we make a drawing f(y)
239</div>
240           
241            <h4 id="_plt1d_keyword_MININ">MININ&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
242             
243             
244             
245             
246             
247             
248             
249             
250            </h4>
251       
252            <div class="comments">
253 Allows to specify the min value we want to consider in the drawing of contour
254 helping by the keyword instead of the argument min.
255 If the argument and the keyword are specified in the same time, it is the
256 value specified by the keyword which is retained.
257</div>
258           
259            <h4 id="_plt1d_keyword_MAXIN">MAXIN&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
260             
261             
262             
263             
264             
265             
266             
267             
268            </h4>
269       
270            <div class="comments">
271 Allows to specify the max value we want to consider in the drawing of contour
272 helping by the keyword instead of the argument max.
273 If the argument and the keyword are specified in the same time, it is the
274 value specified by the keyword which is retained.
275</div>
276           
277            <h4 id="_plt1d_keyword_TYPEIN">TYPEIN&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
278             
279             
280             
281             
282             
283             
284             
285             
286            </h4>
287       
288            <div class="comments">
289 allows to specify the type of hovmoeller we want to do
290             'xt','yt','zt','t'
291 with help of a keyword rather than the argument type. If the argument and the
292 keyword are specified in the same time, it is the value specified by the
293 keyword which is retained.
294</div>
295           
296            <h4 id="_plt1d_keyword_ENDPOINTS">ENDPOINTS&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
297             
298             
299             
300             
301             
302             
303             
304             
305            </h4>
306       
307            <div class="comments">
308 keyword specifying that we want to make a vertical cut in diagonal.
309 Then coordinated of extremities of these one are defined by the 4 elements
310 of the vector ENDPOINTS: [x1,y1,x2,y2] which are coordinates.
311</div>
312           
313            <h4 id="_plt1d_keyword_COL1D">COL1D&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
314             
315             
316             
317             
318             
319             
320             
321             
322            </h4>
323       
324            <div class="comments">
325  --OBSOLETE--Color number when we make a trace 1d by default, 0.
326 It is better to use the keyword COLOR used by plot.
327</div>
328           
329            <h4 id="_plt1d_keyword_STY1D">STY1D&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
330             
331             
332             
333             
334             
335             
336             
337             
338            </h4>
339       
340            <div class="comments">
341 --OBSOLETE--
342 Number of the style used when we make a 1d drawing. We should better use the
343 keyword LINESTYLE which is tho one of the plot. Beware, this keyword is still
344 useful if we want to d bars instead of curves, put sty1d='bar'
345</div>
346           
347            <h4 id="_plt1d_keyword_OV1D">OV1D&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
348             
349             
350             
351             
352             
353             
354             
355             
356            </h4>
357       
358            <div class="comments">
359 Allow the double exposure of an 1d curve to a precedent 1d trace.
360</div>
361           
362            <h4 id="_plt1d_keyword_X">X&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
363             
364             
365             
366             
367             
368             
369             
370             
371            </h4>
372       
373            <div class="comments"></div>
374           
375            <h4 id="_plt1d_keyword_Y">Y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
376             
377             
378             
379             
380             
381             
382             
383             
384            </h4>
385       
386            <div class="comments"></div>
387           
388            <h4 id="_plt1d_keyword_Z">Z&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
389             
390             
391             
392             
393             
394             
395             
396             
397            </h4>
398       
399            <div class="comments"></div>
400           
401            <h4 id="_plt1d_keyword_TT">TT&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
402             
403             
404             
405             
406             
407             
408             
409             
410            </h4>
411       
412            <div class="comments"></div>
413           
414            <h4 id="_plt1d_keyword_REVERSE_X">REVERSE_X&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
415             
416             
417             
418             
419             
420             
421             
422             
423            </h4>
424       
425            <div class="comments">
426 To invert the x axis (so as the drawing)
427</div>
428           
429            <h4 id="_plt1d_keyword_REVERSE_Y">REVERSE_Y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
430             
431             
432             
433             
434             
435             
436             
437             
438            </h4>
439       
440            <div class="comments">
441 To invert the y axis (so as the drawing)
442</div>
443           
444            <h4 id="_plt1d_keyword_SWITCHXY">SWITCHXY&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
445             
446             
447             
448             
449             
450             
451             
452             
453            </h4>
454       
455            <div class="comments"></div>
456           
457            <h4 id="_plt1d_keyword__EXTRA">_EXTRA&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
458             
459             
460             
461             
462             
463             
464             
465             
466            </h4>
467       
468            <div class="comments">
469 Used to pass keywords
470</div>
471           
472         
473
474         
475          <h3>Version history</h3>
476         
477          <h4>Version</h4><div class="preformat">
478 $Id: plt1d.pro 327 2007-12-13 16:22:35Z pinsard $
479</div>
480          <h4>History</h4><div class="preformat">
481 creation 24/6/99 Eric Guilyardi
482 (a partir routine pltt de Sebastien Masson)
483 8/7/1999 Sebastien Masson (smasson@lodyc.jussieu.fr)
484 inspection des travaux finis
485 8/2/2000 Sebastien Masson: checkfield
486</div>
487         
488         
489         
490         
491         
492         
493         
494       
495         
496         
497         
498         
499         
500         
501         
502       
503          <h3>Statistics</h3>
504          <table class="statistics">
505            <tr><td>McCabe cyclic</td><td>          61</td></tr>
506            <tr><td>McCabe essential</td><td>           3</td></tr>
507            <tr><td>McCabe modular design</td><td>           1</td></tr>
508          </table>
509         
510       
511        </div>
512       
513      </div>
514
515     
516
517      <div id="tagline">Produced by IDLdoc 2.0.</div>
518
519    </div>
520
521  </body>
522</html>
Note: See TracBrowser for help on using the repository browser.