source: trunk/SRC/Documentation/idldoc_html_output/Computation/curl.html @ 338

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

update documentation
File size: 7.2 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>curl.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="curl.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="../../../Computation//curl.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&lt;&lt; prev file | <a href="div.html">next file &gt;&gt;</a>&nbsp;&nbsp;&nbsp;&nbsp;<a href="curl.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">Computation/</a></h1>
82      <h2 class="pro_file">curl.pro</h2>
83
84      <div id="file_attr">
85        <dl>
86        </dl>
87      </div>
88
89      <div id="file_comments">
90 Calculate the vertical component of the curl of a vectors field
91 located on Arakawa C-grid.
92</div>
93
94     
95
96     
97
98     
99
100     
101
102      <div id="routine_details">
103       
104
105        <div class="routine_details" id="_curl">
106
107          <h2><a class="top" href="#container">top</a>curl <span class="categories">
108 Calculation
109</span></h2>
110       
111          <p class="header">
112            <span class="result">result = </span>curl(<span class="result"><a href="#_curl_param_uu">uu</a>, <a href="#_curl_param_vv">vv</a></span>, <a href="#_curl_keyword_DIREC">DIREC</a>=<span class="result">scalar string</span>, <a href="#_curl_keyword_MILLION">MILLION</a>=<span class="result">scalar: 0 or 1</span>, <a href="#_curl_keyword__EXTRA">_EXTRA</a>=<span class="result">_EXTRA</span>)</p>
113       
114          <div class="comments">
115</div>
116
117          <h3>Return value</h3><div class="preformat">
118 the vertical component of the curl of the input data (with the same
119 size) located at F point (see restrictions)
120</div>
121
122         
123            <h3>Parameters</h3>
124       
125           
126            <h4 id="_curl_param_uu">uu&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
127             
128             
129             
130             
131             
132             
133             
134             
135            </h4>
136       
137          <div class="comments">
138 Matrix representing the zonal coordinates (at U point) of a field of vectors
139 A 2D (xy), 3D (xyz or yt) or a structure readable by <a href="..//ToBeReviewed/LECTURE/litchamp.html">litchamp</a> and containing
140 a 2D (xy), 3D (xyz or yt) array (4D case is not coded yet).
141 Note that the dimension of the array must suit the domain dimension.
142</div>
143           
144            <h4 id="_curl_param_vv">vv&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
145             
146             
147             
148             
149             
150             
151             
152             
153            </h4>
154       
155          <div class="comments">
156 Matrix representing the meridional coordinates (at V point) of a field of vectors
157 A 2D (xy), 3D (xyz or yt) or a structure readable by <a href="..//ToBeReviewed/LECTURE/litchamp.html">litchamp</a> and containing
158 a 2D (xy), 3D (xyz or yt) array (4D case is not coded yet).
159 Note that the dimension of the array must suit the domain dimension.
160</div>
161           
162
163         
164
165         
166
167            <h3>Keywords</h3>
168           
169            <h4 id="_curl_keyword_DIREC">DIREC&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
170             
171             
172             
173             
174             
175              <span class="attr">type:</span> <span class="value">scalar string</span>
176             
177             
178            </h4>
179       
180            <div class="comments">
181 Use if you want to call <a href="..//ToBeReviewed/CALCULS/moyenne.html">moyenne</a> or
182 <a href="..//ToBeReviewed/CALCULS/grossemoyenne.html">grossemoyenne</a> after the div computation
183 with a mean done in the DIREC direction
184</div>
185           
186            <h4 id="_curl_keyword_MILLION">MILLION&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
187             
188             
189             
190             
191             
192              <span class="attr">type:</span> <span class="value">scalar: 0 or 1</span>
193              <span class="attr">default:</span> <span class="value">0</span>
194             
195            </h4>
196       
197            <div class="comments">
198 Activate to multiply returned array by 1.e6
199 </div>
200           
201            <h4 id="_curl_keyword__EXTRA">_EXTRA&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
202             
203             
204             
205             
206             
207             
208             
209             
210            </h4>
211       
212            <div class="comments">
213 Used to declare that this routine accepts inherited keywords
214</div>
215           
216         
217
218          <h3>Examples</h3><div class="preformat"></div>
219          <h3>Version history</h3>
220         
221          <h4>Version</h4><div class="preformat">
222 $Id: curl.pro 327 2007-12-13 16:22:35Z pinsard $
223</div>
224          <h4>History</h4><div class="preformat">
225 Guillaume Roullet (grlod@ipsl.jussieu.fr)
226 Sebastien Masson (smasson@lodyc.jussieu.fr)
227 adaptation to work with a reduce domain
228 21/5/1999: missing values at !values.f_nan
229</div>
230         
231         
232          <h3>Known issues</h3>
233         
234         
235          <h4>Todo items</h4><div class="preformat">
236 code the 4D case
237</div>
238          <h4>Restrictions</h4><div class="preformat">
239
240 - Works only for Arakawa C-grid.
241 - UU must be on U grid, VV must be on V grid
242 - 4D case is not coded yet
243 - the common variable jpt is used to differ xyz (jpt=1) and xyt (jpt=1) cases.
244 - U and V arrays are cut in the same geographic domain. Because of the shift between
245   T, U, V and F grids, it is possible that these two arrays do not have the same
246   size and refer to different indexes. In this case, arrays are re-cut on
247   common indexes. To avoid these re-cuts, use the keyword /memeindice in
248 <a href="..//ToBeReviewed/GRILLE/domdef.html">domdef</a>
249 - When computing the divergence, we update, vargrid, varname, varunits and the
250   grid position parameters (firstxf, lastxf, nxf, firstyf, lastyf, nyf).
251 - points that cannot be computed (domain boundaries, coastline) are set to NaN
252</div>
253       
254          <h3>Other attributes</h3>
255         
256         
257          <h4>Uses routines</h4><div class="preformat">
258 cm_4cal
259 cm_4data
260 cm_4mesh
261</div>
262         
263         
264         
265       
266          <h3>Statistics</h3>
267          <table class="statistics">
268            <tr><td>McCabe cyclic</td><td>          61</td></tr>
269            <tr><td>McCabe essential</td><td>           1</td></tr>
270            <tr><td>McCabe modular design</td><td>           1</td></tr>
271          </table>
272         
273       
274        </div>
275       
276      </div>
277
278     
279
280      <div id="tagline">Produced by IDLdoc 2.0.</div>
281
282    </div>
283
284  </body>
285</html>
Note: See TracBrowser for help on using the repository browser.