source: trunk/SRC/Documentation/idldoc_html_output/ReadWrite/read_grads.html @ 402

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

update documentation
File size: 7.3 KB
RevLine 
[89]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>
[104]9    <title>read_grads.pro (SAXO Documentation)</title>
[89]10
11   
[191]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" />
[89]14   
15
16    <script type="text/javascript">
17      function setTitle() {
[104]18        parent.document.title="read_grads.pro (SAXO Documentation)";
[89]19      }
20    </script>
21  </head>
22
23  <body onload="setTitle();">
24
25    <div id="navbar_title">
[104]26  <h1>SAXO Documentation</h1>
[89]27</div>
28
29
30<div id="main_navbar">
31
32  <table cellspacing="0">
33    <tr>
34     
[189]35      <td><a href="./../overview.html" title="Overview of library">Overview</a></td>
[89]36     
37
38     
39      <td >Directory</td>
40     
41
42     
[189]43      <td><a href="./../idldoc-categories.html" title="Browse library by category">Categories</a></td>
[89]44     
45
46     
[189]47      <td><a href="./../idldoc-index.html" title="Index of files, routines, and parameters">Index</a></td>
[89]48     
49
50     
[189]51      <td><a href="./../search-page.html" title="Search library">Search</a></td>
[89]52     
53
54      <td id="selected">File</td>
55
56     
[189]57      <td><a href="../../../ReadWrite//read_grads.pro" title="Source code of a file">Source</a></td>
[89]58     
59
60     
[189]61      <td><a href="./../idldoc-help.html" title="Help on IDLdoc">Help</a></td>
[89]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
[290]74<a href="ncdf_gettime.html">&lt;&lt;prev file</a> | <a href="read_oasis.html">next file &gt;&gt;</a>&nbsp;&nbsp;&nbsp;&nbsp;<a href="read_grads.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>
[89]75
76</div>
77
78
79    <div id="container">
80
[189]81      <h1 class="directory"><a href="directory-overview.html">ReadWrite/</a></h1>
[89]82      <h2 class="pro_file">read_grads.pro</h2>
83
84      <div id="file_attr">
85        <dl>
86        </dl>
87      </div>
88
[138]89      <div id="file_comments">
90 reading grads file (except "data type station" or "grib")
[106]91 from the grads control file even if there is multiple data files.
92</div>
93
[89]94     
95
96     
97
98     
99
100     
101
102      <div id="routine_details">
103       
104
105        <div class="routine_details" id="_read_grads">
106
[234]107          <h2><a class="top" href="#container">top</a>read_grads <span class="categories">
[157]108 Reading
[106]109</span></h2>
[89]110       
111          <p class="header">
[338]112            <span class="result">result = </span>read_grads(<span class="result"><a href="#_read_grads_param_var">var</a>, <a href="#_read_grads_param_date1">date1</a>[, <a href="#_read_grads_param_date2">date2</a>]</span>, <a href="#_read_grads_keyword_FILENAME">FILENAME</a>=<span class="result">FILENAME</span>, <a href="#_read_grads_keyword_BOX">BOX</a>=<span class="result">A 4 or 6 elements 1d array, [lon1,lon2,lat1,lat2, depth1, depth2]</span>, <a href="#_read_grads_keyword_TIMESTEP">TIMESTEP</a>=<span class="result">TIMESTEP</span>, <a href="#_read_grads_keyword_EVERYTHING">EVERYTHING</a>=<span class="result">EVERYTHING</span>, <a href="#_read_grads_keyword_NOSTRUCT">NOSTRUCT</a>=<span class="result">NOSTRUCT</span>, <a href="#_read_grads_keyword__EXTRA">_EXTRA</a>=<span class="result">_EXTRA</span>)</p>
[89]113       
[234]114          <div class="comments">
115</div>
[89]116
[338]117          <h3>Return value</h3><div class="preformat">
118 an array
119</div>
[89]120
121         
122            <h3>Parameters</h3>
123       
124           
125            <h4 id="_read_grads_param_var">var&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
[106]126              <span class="attr">in</span>
[89]127             
128             
[106]129              <span class="attr">required</span>
[89]130             
131             
132             
133             
134            </h4>
135       
[138]136          <div class="comments">
137 the variable name
138</div>
[89]139           
140            <h4 id="_read_grads_param_date1">date1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
[106]141              <span class="attr">in</span>
[89]142             
143             
[106]144              <span class="attr">required</span>
[89]145             
146             
147             
148             
149            </h4>
150       
[138]151          <div class="comments">
152 date of the beginning (yyyymmdd if TIMESTEP is not activate)
153</div>
[89]154           
155            <h4 id="_read_grads_param_date2">date2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
[106]156              <span class="attr">in</span>
[89]157             
[106]158              <span class="attr">optional</span>
[89]159             
160             
161             
162             
163             
164            </h4>
165       
[138]166          <div class="comments">
167 last date. Optional, if not specified date2=date1
168</div>
[89]169           
170
171         
172
173         
174
175            <h3>Keywords</h3>
176           
177            <h4 id="_read_grads_keyword_FILENAME">FILENAME&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
178             
179             
180             
181             
182             
183             
184             
185             
186            </h4>
187       
[138]188            <div class="comments">
189 the grads control file name: 'xxxx.ctl'
[106]190</div>
[89]191           
192            <h4 id="_read_grads_keyword_BOX">BOX&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
193             
194             
195             
196             
197             
[338]198              <span class="attr">type:</span> <span class="value">A 4 or 6 elements 1d array, [lon1,lon2,lat1,lat2, depth1, depth2]</span>
[89]199             
200             
201            </h4>
202       
[338]203            <div class="comments">
204 It specifies the area where data must be read
205</div>
[89]206           
207            <h4 id="_read_grads_keyword_TIMESTEP">TIMESTEP&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
208             
209             
210             
211             
212             
213             
214             
215             
216            </h4>
217       
[138]218            <div class="comments">
219 to specify that the dates are time steps instead of true calendar.
[338]220
221 NOT yet available
[106]222</div>
[89]223           
224            <h4 id="_read_grads_keyword_EVERYTHING">EVERYTHING&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
225             
226             
227             
228             
229             
230             
231             
232             
233            </h4>
234       
[338]235            <div class="comments">
236</div>
[89]237           
238            <h4 id="_read_grads_keyword_NOSTRUCT">NOSTRUCT&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
239             
240             
241             
242             
243             
244             
245             
246             
247            </h4>
248       
[338]249            <div class="comments">
250</div>
[89]251           
252            <h4 id="_read_grads_keyword__EXTRA">_EXTRA&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
253             
254             
255             
256             
257             
258             
259             
260             
261            </h4>
262       
[338]263            <div class="comments">
264 Used to pass keywords
265</div>
[89]266           
267         
268
[338]269          <h3>Examples</h3><div class="preformat">
[402]270
271   IDL> a=read_grads('sst',19900101,19900131,filename='outputs.ctl')
272   IDL> plt, a
[338]273</div>
274          <h3>Version history</h3>
[89]275         
[338]276          <h4>Version</h4><div class="preformat">
[402]277 $Id: read_grads.pro 370 2008-08-07 07:59:15Z pinsard $
[338]278</div>
279          <h4>History</h4><div class="preformat">
280 Sebastien Masson (smasson@lodyc.jussieu.fr)
281</div>
[89]282         
283         
[338]284          <h3>Known issues</h3>
[89]285         
286         
287         
[338]288          <h4>Restrictions</h4><div class="preformat">
[402]289 define all the grid parameters (defined in <a href="..//Obsolete/common.html">common</a>)
[338]290 associated to the data.
291
[402]292 this function call the procedure <a href="..//ToBeReviewed/WIDGET/AUTOUR_de_XXX/scanfile.html">scanfile</a> that use the
[338]293 unix commands grep and sed
294</div>
[89]295       
[338]296          <h3>Other attributes</h3>
[89]297         
298         
[338]299          <h4>Uses routines</h4><div class="preformat">
[402]300 <a href="..//Obsolete/common.html">common</a>
[338]301</div>
[89]302         
303         
304         
305       
[163]306          <h3>Statistics</h3>
307          <table class="statistics">
308            <tr><td>McCabe cyclic</td><td>          55</td></tr>
309            <tr><td>McCabe essential</td><td>           2</td></tr>
310            <tr><td>McCabe modular design</td><td>           1</td></tr>
311          </table>
[89]312         
313       
314        </div>
315       
316      </div>
317
318     
319
320      <div id="tagline">Produced by IDLdoc 2.0.</div>
321
322    </div>
323
324  </body>
[249]325</html>
Note: See TracBrowser for help on using the repository browser.