source: trunk/SRC/Documentation/idldoc_assistant_output/ToBeReviewed/STATISTICS/c_timecorrelate.html @ 242

Last change on this file since 242 was 242, checked in by pinsard, 17 years ago

improvements/corrections of some *.pro headers + replace some message by some report

File size: 8.1 KB
Line 
1
2
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4  <head>
5    <title>c_timecorrelate.pro (SAXO Documentation Assistant)</title>
6  </head>
7
8  <body text="#000000" bgcolor="#FFFFFF">
9
10   
11<!-- Navbar template takes a structure with the following fields:
12       overview_href :
13       overview_selected :
14       dir_overview_href :
15       dir_overview_selected :
16       categories_href :
17       categories_selected :
18       index_href :
19       index_selected :
20       search_href :
21       search_selected :
22       file_selected :
23       source_href :
24       source_selected :
25       help_href :
26       help_selected :
27       etc_selected :
28
29       prev_file_href :
30       next_file_href :
31
32       view_single_page_href :
33       view_frames_href :
34
35       summary_fields_href :
36       summary_routine_href :
37       details_routine_href :
38
39       title :
40       subtitle :
41       user :
42-->
43
44
45<table border="0" cellpadding="0" cellspacing="0" width="98%" bgcolor="#F0F0FF" valign="bottom">
46  <tr>
47    <td width="10%">
48<a href="a_timecorrelate.html"><img src="./../../prev.gif" border="0" alt="Previous"></a></td>
49    <td width="80%" align="center" valign="center">
50<font size=-1><i>SAXO Documentation Assistant</i>: <a href="./../../home.html">Overview</a></font></td>
51    <td width="10%" align="right">
52<a href=""><img src="./../../next.gif" border="0" alt="Next"></a></td>
53  </tr>
54</table>
55
56
57    <h1><font size="-2">ToBeReviewed/STATISTICS/</font></h1>
58    <h2>c_timecorrelate.pro</h2>
59
60    <dl>
61    </dl>
62
63   
64
65
66 This function computes the "time cross correlation" Pxy(L) or
67 the "time cross covariance" between 2 arrays (this is some
68 kind of c_correlate but for multidimensional arrays) as a
69 function of the lag (L).
70
71
72   
73    <h2>Routine summary</h2>
74
75    <dl>
76     
77      <dt><a href="#_timecross_cov"><i>result = </i>timecross_cov(<i>Xd, Yd, M, nT, Ndim</i>, Double=<i>Double</i>, ZERO2NAN=<i>ZERO2NAN</i>)</a><dt>
78      <dd><font size="-1"> </font></dd>
79     
80      <dt><a href="#_c_timecorrelate"><i>result = </i>c_timecorrelate(<i>X, Y, Lag</i>, Covariance=<i>Covariance</i>, Double=<i>Double</i>)</a><dt>
81      <dd><font size="-1"> </font></dd>
82     
83    </dl>
84
85    <p>&nbsp;</p>
86   
87
88     
89      <a name="#_timecross_cov"></a>
90
91      <h2>timecross_cov  <font size="-1" color="#006633">
92 Statistics
93</font></h2>
94
95      <p><font face="Courier"><i>result = </i>timecross_cov(<i><a href="#_timecross_cov_keyword_Xd">Xd</a>, <a href="#_timecross_cov_keyword_Yd">Yd</a>, <a href="#_timecross_cov_keyword_M">M</a>, <a href="#_timecross_cov_keyword_nT">nT</a>, <a href="#_timecross_cov_keyword_Ndim">Ndim</a></i>, <a href="#_timecross_cov_keyword_Double">Double</a>=<i>Double</i>, <a href="#_timecross_cov_keyword_ZERO2NAN">ZERO2NAN</a>=<i>ZERO2NAN</i>)</font></p>
96
97   
98
99
100   
101
102   
103    <h3>Parameters</h3>
104   
105
106    <a name="#_timecross_cov_keyword_Xd"></a>
107    <h4>Xd&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
108     
109     
110     
111     
112     
113     
114     
115     
116    </h4>
117
118   
119
120   
121
122    <a name="#_timecross_cov_keyword_Yd"></a>
123    <h4>Yd&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
124     
125     
126     
127     
128     
129     
130     
131     
132    </h4>
133
134   
135
136   
137
138    <a name="#_timecross_cov_keyword_M"></a>
139    <h4>M&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
140     
141     
142     
143     
144     
145     
146     
147     
148    </h4>
149
150   
151
152   
153
154    <a name="#_timecross_cov_keyword_nT"></a>
155    <h4>nT&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
156     
157     
158     
159     
160     
161     
162     
163     
164    </h4>
165
166   
167
168   
169
170    <a name="#_timecross_cov_keyword_Ndim"></a>
171    <h4>Ndim&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
172     
173     
174     
175     
176     
177     
178     
179     
180    </h4>
181
182   
183
184   
185   
186
187   
188    <h3>Keywords</h3>
189
190   
191    <a name="#_timecross_cov_keyword_Double"></a>
192    <h4>Double&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
193     
194     
195     
196     
197     
198     
199     
200     
201    </h4>
202
203   
204 If set to a non-zero value, computations are done in
205 double precision arithmetic.
206
207   
208    <a name="#_timecross_cov_keyword_ZERO2NAN"></a>
209    <h4>ZERO2NAN&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
210     
211     
212     
213     
214     
215     
216     
217     
218    </h4>
219
220   
221
222   
223   
224
225    <h3>Examples</h3><pre>
226
227    </pre><h3>Version history</h3>
228   
229    <h4>Version</h4>
230 $Id: c_timecorrelate.pro 232 2007-03-20 16:59:36Z pinsard $
231
232    <h4>History</h4>
233
234   
235
236   
237   
238   
239   
240   
241
242   
243   
244   
245   
246   
247   
248   
249
250    <font size="-3"><p>&nbsp;</p></font>
251    <hr size="1" color="#CCCCCC"/>
252     
253      <a name="#_c_timecorrelate"></a>
254
255      <h2>c_timecorrelate  <font size="-1" color="#006633">
256 Statistics
257</font></h2>
258
259      <p><font face="Courier"><i>result = </i>c_timecorrelate(<i><a href="#_c_timecorrelate_keyword_X">X</a>, <a href="#_c_timecorrelate_keyword_Y">Y</a>, <a href="#_c_timecorrelate_keyword_Lag">Lag</a></i>, <a href="#_c_timecorrelate_keyword_Covariance">Covariance</a>=<i>Covariance</i>, <a href="#_c_timecorrelate_keyword_Double">Double</a>=<i>Double</i>)</font></p>
260
261   
262
263
264   
265
266   
267    <h3>Parameters</h3>
268   
269
270    <a name="#_c_timecorrelate_keyword_X"></a>
271    <h4>X&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
272      <font size="-1" color="#006633">in</font>
273     
274     
275      <font size="-1" color="#006633">required</font>
276     
277      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>array</i></font>
278     
279     
280    </h4>
281
282   
283 An array which last dimension is the time dimension of
284 size n, float or double.
285
286   
287
288    <a name="#_c_timecorrelate_keyword_Y"></a>
289    <h4>Y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
290      <font size="-1" color="#006633">in</font>
291     
292     
293      <font size="-1" color="#006633">required</font>
294     
295      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>array</i></font>
296     
297     
298    </h4>
299
300   
301 An array which last dimension is the time dimension of
302 size n, float or double.
303
304   
305
306    <a name="#_c_timecorrelate_keyword_Lag"></a>
307    <h4>Lag&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
308      <font size="-1" color="#006633">in</font>
309     
310     
311      <font size="-1" color="#006633">required</font>
312     
313      <font size="-1" color="#006633">type:</font> <font size="-1" color="#006633"><i>scalar or vector</i></font>
314     
315     
316    </h4>
317
318   
319 A scalar or n-elements vector, in the interval [-(n-2),(n-2)],
320 of type integer that specifies the absolute distance(s) between
321 indexed elements of X.
322
323   
324   
325
326   
327    <h3>Keywords</h3>
328
329   
330    <a name="#_c_timecorrelate_keyword_Covariance"></a>
331    <h4>Covariance&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
332     
333     
334     
335     
336     
337     
338     
339     
340    </h4>
341
342   
343 If set to a non-zero value, the sample cross
344 covariance is computed.
345
346   
347    <a name="#_c_timecorrelate_keyword_Double"></a>
348    <h4>Double&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
349     
350     
351     
352     
353     
354     
355     
356     
357    </h4>
358
359   
360 If set to a non-zero value, computations are done in
361 double precision arithmetic.
362
363   
364   
365
366    <h3>Examples</h3><pre>
367
368 Define two n-elements sample populations.
369 IDL> x = [3.73, 3.67, 3.77, 3.83, 4.67, 5.87, 6.70, 6.97, 6.40, 5.57]
370 IDL> y = [2.31, 2.76, 3.02, 3.13, 3.72, 3.88, 3.97, 4.39, 4.34, 3.95]
371
372 Compute the cross correlation of X and Y for LAG = -5, 0, 1, 5, 6, 7
373 IDL> lag = [-5, 0, 1, 5, 6, 7]
374 IDL> result = c_timecorrelate(x, y, lag)
375
376 The result should be:
377 [-0.428246, 0.914755, 0.674547, -0.405140, -0.403100, -0.339685]
378
379    </pre><h3>Version history</h3>
380   
381    <h4>Version</h4>
382 $Id: c_timecorrelate.pro 232 2007-03-20 16:59:36Z pinsard $
383
384    <h4>History</h4>
385       - 01/03/2000 Sebastien Masson (smasson@lodyc.jussieu.fr)
386       Based on the C_CORRELATE procedure of IDL
387       - August 2003 Sebastien Masson
388       update according to the update made in C_CORRELATE by
389       W. Biagiotti and available in IDL 5.5
390
391       INTRODUCTION TO STATISTICAL TIME SERIES
392       Wayne A. Fuller
393       ISBN 0-471-28715-6
394
395   
396
397   
398   
399   
400   
401   
402
403   
404   
405   
406   
407   
408   
409   
410
411    <font size="-3"><p>&nbsp;</p></font>
412    <hr size="1" color="#CCCCCC"/>
413     
414
415   
416
417    <p><font color="gray" size="-3">&nbsp;&nbsp;Produced by IDLdoc 2.0.</font></p>
418
419  </body>
420</html>
Note: See TracBrowser for help on using the repository browser.