gentooboontoo-gphys 0.6.1.3 → 1.3.1.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/ChangeLog +5631 -464
- data/LICENSE.txt +34 -0
- data/README +23 -25
- data/bin/gdir_client +25 -7
- data/bin/gdir_server +19 -13
- data/bin/gpaop +41 -28
- data/bin/gpcat +19 -11
- data/bin/gpcut +20 -11
- data/bin/gpedit +37 -1
- data/bin/gplist +5 -4
- data/bin/gpmath +21 -14
- data/bin/gpmaxmin +9 -7
- data/bin/gpprint +15 -11
- data/bin/gpvect +217 -96
- data/bin/gpview +278 -123
- data/bin/grads2nc_with_gphys +11 -6
- data/doc/attribute.html +1 -1
- data/doc/axis.html +85 -66
- data/doc/coordmapping.html +22 -22
- data/doc/dclext.html +709 -0
- data/doc/derivative/gphys-derivative.html +33 -13
- data/doc/derivative/numru-derivative.html +60 -31
- data/doc/gdir.html +76 -76
- data/doc/gdir_server.html +28 -16
- data/doc/ggraph.html +493 -706
- data/doc/gpcat.html +28 -11
- data/doc/gpcut.html +26 -11
- data/doc/gphys.html +195 -71
- data/doc/gphys_fft.html +162 -21
- data/doc/gphys_grads_io.html +9 -9
- data/doc/gphys_grib_io.html +7 -7
- data/doc/gphys_io.html +118 -31
- data/doc/gphys_io_common.html +1 -1
- data/doc/gphys_netcdf_io.html +14 -14
- data/doc/gplist.html +6 -5
- data/doc/gpmath.html +32 -14
- data/doc/gpmaxmin.html +9 -7
- data/doc/gpprint.html +14 -11
- data/doc/gpview.html +254 -146
- data/doc/grads2nc_with_gphys.html +6 -8
- data/doc/grads_gridded.html +77 -77
- data/doc/grib.html +102 -59
- data/doc/grid.html +45 -61
- data/doc/index.html +51 -41
- data/doc/index.rd +47 -36
- data/doc/netcdf_convention.html +39 -39
- data/doc/unumeric.html +79 -30
- data/doc/update +2 -1
- data/doc/varray.html +62 -56
- data/doc/varraycomposite.html +3 -3
- data/ext/ext_coord.c +209 -0
- data/ext/ext_init.c +7 -0
- data/ext/extconf.rb +41 -0
- data/ext/interpo.c +536 -0
- data/ext/multibitIO.c +567 -0
- data/lib/numru/dcl_mouse.rb +71 -0
- data/lib/numru/dclext.rb +2749 -0
- data/lib/numru/derivative.rb +124 -31
- data/lib/numru/ganalysis.rb +7 -0
- data/lib/numru/ganalysis/covariance.rb +154 -0
- data/lib/numru/ganalysis/eof.rb +302 -0
- data/lib/numru/ganalysis/histogram.rb +337 -0
- data/lib/numru/ganalysis/met.rb +872 -0
- data/lib/numru/ganalysis/planet.rb +392 -0
- data/lib/numru/ggraph.rb +1709 -2498
- data/lib/numru/gphys.rb +7 -1
- data/lib/numru/gphys/assoccoords.rb +384 -0
- data/lib/numru/gphys/attribute.rb +10 -11
- data/lib/numru/gphys/axis.rb +97 -25
- data/lib/numru/gphys/coordmapping.rb +2 -2
- data/lib/numru/gphys/derivative.rb +117 -46
- data/lib/numru/gphys/gphys.rb +595 -31
- data/lib/numru/gphys/gphys_fft.rb +365 -13
- data/lib/numru/gphys/gphys_grads_io.rb +6 -5
- data/lib/numru/gphys/gphys_grib_io.rb +6 -6
- data/lib/numru/gphys/gphys_gtool3_io.rb +162 -0
- data/lib/numru/gphys/gphys_hdfeos5_io.rb +672 -0
- data/lib/numru/gphys/gphys_io.rb +260 -20
- data/lib/numru/gphys/gphys_io_common.rb +1 -1
- data/lib/numru/gphys/gphys_netcdf_io.rb +111 -40
- data/lib/numru/gphys/gphys_nusdas_io.rb +64 -7
- data/lib/numru/gphys/grads_gridded.rb +158 -57
- data/lib/numru/gphys/grib.rb +205 -157
- data/lib/numru/gphys/grib_params.rb +196 -1
- data/lib/numru/gphys/grid.rb +214 -83
- data/lib/numru/gphys/gtool3.rb +771 -0
- data/lib/numru/gphys/interpolate.rb +992 -0
- data/lib/numru/gphys/mdstorage.rb +145 -0
- data/lib/numru/gphys/narray_ext.rb +34 -0
- data/lib/numru/gphys/netcdf_convention.rb +44 -2
- data/lib/numru/gphys/subsetmapping.rb +1 -1
- data/lib/numru/gphys/unumeric.rb +101 -8
- data/lib/numru/gphys/varray.rb +66 -20
- data/lib/numru/gphys/varraycomposite.rb +107 -29
- data/lib/numru/gphys/varraygrib.rb +70 -8
- data/lib/numru/gphys/varraygtool3.rb +226 -0
- data/lib/numru/gphys/varrayhdfeos5.rb +451 -0
- data/lib/numru/gphys/varraynetcdf.rb +13 -5
- data/lib/numru/gphys/version.rb +3 -0
- data/sample/druby_cli1.rb +2 -0
- data/sample/druby_cli2.rb +0 -6
- data/sample/druby_serv2.rb +0 -13
- data/sample/ncep_theta_coord.rb +79 -0
- data/test/eof_slp.rb +28 -0
- data/test/mltbit.dat +0 -0
- data/test/test_multibitIO.rb +19 -0
- data/testdata/assoc_crds.nc +0 -0
- metadata +79 -8
- data/lib/numru/dclext_datetime_ax.rb +0 -220
- data/lib/numru/vizshot.rb +0 -697
@@ -7,25 +7,29 @@
|
|
7
7
|
<title>../../lib/numru/gphys/derivative.rb</title>
|
8
8
|
</head>
|
9
9
|
<body>
|
10
|
-
<h1><a name="label
|
11
|
-
<h2><a name="label
|
10
|
+
<h1><a name="label-0" id="label-0">module NumRu::GPhys::Derivative in derivative.rb</a></h1><!-- RDLabel: "module NumRu::GPhys::Derivative in derivative.rb" -->
|
11
|
+
<h2><a name="label-1" id="label-1">Index</a></h2><!-- RDLabel: "Index" -->
|
12
12
|
<ul>
|
13
|
-
<li><a href="#label
|
13
|
+
<li><a href="#label-2">module NumRu::GPhys::Derivative</a>
|
14
14
|
<ul>
|
15
|
-
<li><a href="#label
|
15
|
+
<li><a href="#label-3">threepoint_O2nd_deriv</a>
|
16
16
|
<ul>
|
17
17
|
<li>First derivative (2nd Order difference use three point.)</li>
|
18
18
|
</ul></li>
|
19
|
-
<li><a href="#label
|
19
|
+
<li><a href="#label-4">cderiv</a>
|
20
20
|
<ul>
|
21
21
|
<li>First derivative (using center difference method)</li>
|
22
22
|
</ul></li>
|
23
|
+
<li><!-- Reference, RDLabel "deriv2d" doesn't exist --><em class="label-not-found">deriv2d</em><!-- Reference end -->
|
24
|
+
<ul>
|
25
|
+
<li>2nd derivative</li>
|
26
|
+
</ul></li>
|
23
27
|
</ul></li>
|
24
28
|
</ul>
|
25
|
-
<h1><a name="label
|
29
|
+
<h1><a name="label-2" id="label-2">module NumRu::GPhys::Derivative</a></h1><!-- RDLabel: "module NumRu::GPhys::Derivative" -->
|
26
30
|
<p>Module functions of Derivative Operater for GPhys.</p>
|
27
31
|
<dl>
|
28
|
-
<dt><a name="label
|
32
|
+
<dt><h4><a name="label-3" id="label-3"><code>threepoint_O2nd_deriv(<var>gp</var>, <var>dim_or_dimname</var>, <var>bc</var>=<var>LINEAR_EXT</var>))</code></a></h4></dt><!-- RDLabel: "threepoint_O2nd_deriv" -->
|
29
33
|
<dd>
|
30
34
|
<p>Derivate <code>z</code> respect to <code>dim</code> th dimension with 2nd Order difference.
|
31
35
|
return an NArray which result of the difference <!-- Reference, RDLabel "z" doesn't exist --><em class="label-not-found">z</em><!-- Reference end --> divided difference
|
@@ -43,15 +47,18 @@ dimension of array. ).</pre>
|
|
43
47
|
respect to. you can give number count backward (<!-- Reference, RDLabel "dim" doesn't exist --><em class="label-not-found">dim</em><!-- Reference end --><0), but
|
44
48
|
<!-- Reference, RDLabel "z.rank ��dim" doesn't exist --><em class="label-not-found">z.rank ��dim</em><!-- Reference end --> must be > 0. </li>
|
45
49
|
<li>bc (Numeric) : a Numeric which represent boundary condition.
|
46
|
-
|
47
|
-
|
50
|
+
Supported conditions are:
|
51
|
+
<ul>
|
52
|
+
<li>LINEAR_EXT(=1) : default value</li>
|
53
|
+
<li>CYCLIC_EXT(=2)</li>
|
54
|
+
</ul></li>
|
48
55
|
</ul>
|
49
56
|
<p>RETURN VALUE</p>
|
50
57
|
<ul>
|
51
58
|
<li>O2nd_deriv_data (NArray):
|
52
59
|
(s**2*z_{i+1} + (t**2 - s**2)*f_{i} - t**2*f_{i-1}) / (s*t*(s + t))</li>
|
53
60
|
</ul></dd>
|
54
|
-
<dt><a name="label
|
61
|
+
<dt><h4><a name="label-4" id="label-4"><code>cderiv(<var>gp</var>, <var>dim_or_dimname</var>, <var>bc</var>=<var>LINEAR_EXT</var>, <var>altcoord</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "cderiv" -->
|
55
62
|
<dd>
|
56
63
|
<p>Derivate <code>gp</code> respect to <code>dim</code> th or <code>dimname</code> dimension
|
57
64
|
with center difference. return a GPhys which result of the difference
|
@@ -66,14 +73,27 @@ of {i} th element in the <!-- Reference, RDLabel "dim" doesn't exist --><em clas
|
|
66
73
|
the dimension which derivate respect to. you can give number count
|
67
74
|
backward (<!-- Reference, RDLabel "dim" doesn't exist --><em class="label-not-found">dim</em><!-- Reference end --><0), but <!-- Reference, RDLabel "z.rank ��dim" doesn't exist --><em class="label-not-found">z.rank ��dim</em><!-- Reference end --> must be > 0. </li>
|
68
75
|
<li>bc (Numeric) : a Numeric which represent boundary condition.
|
69
|
-
|
70
|
-
|
71
|
-
|
76
|
+
Supported conditions are:
|
77
|
+
<ul>
|
78
|
+
<li>LINEAR_EXT(=1) : default value</li>
|
79
|
+
<li>CYCLIC_EXT(=2)</li>
|
80
|
+
</ul></li>
|
81
|
+
<li>altcoord (nil or 1D VArray): if a VArray, it is used as the
|
82
|
+
coordiante variable with which differentiation is made.
|
83
|
+
-- conveneient to make deribative in a different cooridate scaling.
|
84
|
+
(e.g., differenciate in radian, while the coordinate is in degrees)</li>
|
72
85
|
</ul>
|
73
86
|
<p>RETURN VALUE</p>
|
74
87
|
<ul>
|
75
88
|
<li>a GPhys</li>
|
76
89
|
</ul></dd>
|
90
|
+
<dt><h4><a name="label-5" id="label-5"><code>deriv2nd(<var>gp</var>, <var>dim_or_dimname</var>, <var>bc</var>=<var>LINEAR_EXT</var>, <var>altcoord</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "deriv2nd" -->
|
91
|
+
<dd>
|
92
|
+
<p>2nd Derivate <code>gp</code> respect to <code>dim</code> th or <code>dimname</code> dimension
|
93
|
+
covering non-uniform grids. Based on:</p>
|
94
|
+
<pre>( (z_{i+1}-z_{i})/(x_{i+1}-x_{i}) - (z_{i}-z_{i-1})/(x_{i}-x_{i-1}) )
|
95
|
+
/ ((x_{i+1}-x_{i-1})/2)</pre>
|
96
|
+
<p>See <a href="#label-4">cderiv</a> for usage.</p></dd>
|
77
97
|
</dl>
|
78
98
|
|
79
99
|
</body>
|
@@ -7,8 +7,8 @@
|
|
7
7
|
<title>../../lib/numru/derivative.rb</title>
|
8
8
|
</head>
|
9
9
|
<body>
|
10
|
-
<h1><a name="label
|
11
|
-
<h2><a name="label
|
10
|
+
<h1><a name="label-0" id="label-0">module NumRu::Derivative in derivative.rb</a></h1><!-- RDLabel: "module NumRu::Derivative in derivative.rb" -->
|
11
|
+
<h2><a name="label-1" id="label-1">todo</a></h2><!-- RDLabel: "todo" -->
|
12
12
|
<ul>
|
13
13
|
<li>decide argument of b_expand_linear_ext is Symbol or Numeric.
|
14
14
|
<ul>
|
@@ -17,40 +17,43 @@
|
|
17
17
|
</ul></li>
|
18
18
|
<li>support other boundary conditions.</li>
|
19
19
|
</ul>
|
20
|
-
<h2><a name="label
|
20
|
+
<h2><a name="label-2" id="label-2">Index</a></h2><!-- RDLabel: "Index" -->
|
21
21
|
<ul>
|
22
|
-
<li><a href="#label
|
22
|
+
<li><a href="#label-3">module NumRu::Derivative</a>
|
23
23
|
<ul>
|
24
|
-
<li><a href="#label
|
24
|
+
<li><a href="#label-4">threepoint_O2nd_deriv</a>
|
25
25
|
<ul>
|
26
26
|
<li>First derivative (2nd Order difference use three point.)</li>
|
27
27
|
</ul></li>
|
28
|
-
<li><a href="#label
|
28
|
+
<li><a href="#label-5">cderiv</a>
|
29
29
|
<ul>
|
30
30
|
<li>First derivative (center difference use two point.)</li>
|
31
31
|
</ul></li>
|
32
|
-
<li
|
32
|
+
<li><!-- Reference, RDLabel "deriv2d" doesn't exist --><em class="label-not-found">deriv2d</em><!-- Reference end -->
|
33
|
+
<ul>
|
34
|
+
<li>2nd derivative</li>
|
35
|
+
</ul></li>
|
36
|
+
<li><a href="#label-7">b_expand_linear_ext</a>
|
33
37
|
<ul>
|
34
38
|
<li>return array extended boundaries with linear extention.</li>
|
35
39
|
</ul></li>
|
36
|
-
<li><a href="#label
|
40
|
+
<li><a href="#label-8">cdiff</a>
|
37
41
|
<ul>
|
38
42
|
<li>return difference. (center difference)</li>
|
39
43
|
</ul></li>
|
40
44
|
</ul></li>
|
41
45
|
</ul>
|
42
|
-
<h1><a name="label
|
46
|
+
<h1><a name="label-3" id="label-3">module NumRu::Derivative</a></h1><!-- RDLabel: "module NumRu::Derivative" -->
|
43
47
|
<p>Module functions of Derivative Operater for NArray.</p>
|
44
48
|
<dl>
|
45
|
-
<dt><a name="label
|
49
|
+
<dt><h4><a name="label-4" id="label-4"><code>threepoint_O2nd_deriv(<var>z</var>, <var>x</var>, <var>dim</var>, <var>bc</var>=<var>LINEAR_EXT</var>)</code></a></h4></dt><!-- RDLabel: "threepoint_O2nd_deriv" -->
|
46
50
|
<dd>
|
47
|
-
<p>Derivate <code>z</code> respect to <code>dim</code> th
|
48
|
-
|
49
|
-
<
|
50
|
-
<
|
51
|
-
|
52
|
-
|
53
|
-
dimension of array. ).</pre>
|
51
|
+
<p>Derivate of <code>z</code> with respect to <code>dim</code> th dim using a 2nd
|
52
|
+
order 3-point differentiation valid for non-uniform grid: </p>
|
53
|
+
<pre>(s**2*z_{i+1} + (t**2 - s**2)*f_{i} - t**2*f_{i-1}) / (s*t*(s + t))</pre>
|
54
|
+
<p>Here, s represents (x_{i} - x_{i-1}) ,t represents (x_{i+1} - x_{i})
|
55
|
+
and _{i} represents the suffix of {i} th element in the <!-- Reference, RDLabel "dim" doesn't exist --><em class="label-not-found">dim</em><!-- Reference end --> th
|
56
|
+
dimension of the array. ).</p>
|
54
57
|
<p>ARGUMENTS</p>
|
55
58
|
<ul>
|
56
59
|
<li>z (NArray): a NArray which you want to derivative.</li>
|
@@ -58,21 +61,48 @@ dimension of array. ).</pre>
|
|
58
61
|
z.rank must be 1.</li>
|
59
62
|
<li>dim (Numeric): a Numeric represents the dimention which derivative respect to.
|
60
63
|
you can give number count backward (<!-- Reference, RDLabel "dim" doesn't exist --><em class="label-not-found">dim</em><!-- Reference end --><0), but <!-- Reference, RDLabel "z.rank ��dim" doesn't exist --><em class="label-not-found">z.rank ��dim</em><!-- Reference end --> must be > 0. </li>
|
61
|
-
<li>bc (Numeric) : a Numeric
|
62
|
-
|
63
|
-
|
64
|
+
<li>bc (Numeric) : a Numeric to represent boundary condition.
|
65
|
+
Supported conditions are expressed in terms of boundary extension
|
66
|
+
applied before differentiation:
|
67
|
+
<ul>
|
68
|
+
<li>LINEAR_EXT(=1): default value. linear extension using two
|
69
|
+
grid points at the boundaries.</li>
|
70
|
+
<li>CYCLIC_EXT(=2): cyclic extension as k,0,1,..,k,0 for indices 0,1,..,k</li>
|
71
|
+
<li>MIRROR_A(=3): for indices 0,1,..,k, extends as 0,0,1,..,k,k
|
72
|
+
(good for cell interior values with the Neumann condition)</li>
|
73
|
+
<li>MIRROR_B(=4): for indices 0,1,..,k, extends as 1,0,1,..,k,k-1
|
74
|
+
(good for cell boundary values with the Neumann condition)</li>
|
75
|
+
</ul></li>
|
64
76
|
</ul>
|
65
77
|
<p>RETURN VALUE</p>
|
66
78
|
<ul>
|
67
79
|
<li>O2nd_deriv_data (NArray): (s**2*z_{i+1} + (t**2 - s**2)*f_{i} - t**2*f_{i-1}) / (s*t*(s + t))</li>
|
68
80
|
</ul></dd>
|
69
|
-
<dt><a name="label
|
81
|
+
<dt><h4><a name="label-5" id="label-5"><code>cderiv(<var>z</var>, <var>x</var>, <var>dim</var>, <var>bc</var>=<var>LINEAR_EXT</var>)</code></a></h4></dt><!-- RDLabel: "cderiv" -->
|
82
|
+
<dd>
|
83
|
+
<p>Derivate of <code>z</code> with respect to <code>dim</code> th dim using centeral
|
84
|
+
differenciation: (z_{i+1} - z_{i-1}) / (x_{i+1} - x_{i-1})</p>
|
85
|
+
<p>ARGUMENTS</p>
|
86
|
+
<ul>
|
87
|
+
<li>z (NArray): a NArray which you want to derivative.</li>
|
88
|
+
<li>x (NArray): a NArray represents the dimension which derivative respect
|
89
|
+
to. z.rank must be 1.</li>
|
90
|
+
<li>dim (Numeric): a Numeric represents the dimention which derivative
|
91
|
+
respect to. you can give number count backward (<!-- Reference, RDLabel "dim" doesn't exist --><em class="label-not-found">dim</em><!-- Reference end --><0), but
|
92
|
+
<!-- Reference, RDLabel "z.rank ��dim" doesn't exist --><em class="label-not-found">z.rank ��dim</em><!-- Reference end --> must be > 0. </li>
|
93
|
+
<li>bc (Numeric) : a Numeric to represent boundary condition.
|
94
|
+
See <a href="#label-4">threepoint_O2nd_deriv</a> for supported conditions.</li>
|
95
|
+
</ul>
|
96
|
+
<p>RETURN VALUE</p>
|
97
|
+
<ul>
|
98
|
+
<li>cderiv_data (NArray): (z_{i+1} - z_{i-1}) / (x_{i+1} - x_{i-1})</li>
|
99
|
+
</ul></dd>
|
100
|
+
<dt><h4><a name="label-6" id="label-6"><code>deriv2nd(<var>z</var>, <var>x</var>, <var>dim</var>, <var>bc</var>=<var>LINEAR_EXT</var>)</code></a></h4></dt><!-- RDLabel: "deriv2nd" -->
|
70
101
|
<dd>
|
71
|
-
<p>Derivate <code>z</code> respect to <code>dim</code
|
72
|
-
|
73
|
-
<
|
74
|
-
|
75
|
-
dimension of array. ).</p>
|
102
|
+
<p>2nd Derivate of <code>z</code> with respect to <code>dim</code>-th dim
|
103
|
+
covering non-uniform grids. Based on:</p>
|
104
|
+
<pre>( (z_{i+1}-z_{i})/(x_{i+1}-x_{i}) - (z_{i}-z_{i-1})/(x_{i}-x_{i-1}) )
|
105
|
+
/ ((x_{i+1}-x_{i-1})/2)</pre>
|
76
106
|
<p>ARGUMENTS</p>
|
77
107
|
<ul>
|
78
108
|
<li>z (NArray): a NArray which you want to derivative.</li>
|
@@ -81,15 +111,14 @@ dimension of array. ).</p>
|
|
81
111
|
<li>dim (Numeric): a Numeric represents the dimention which derivative
|
82
112
|
respect to. you can give number count backward (<!-- Reference, RDLabel "dim" doesn't exist --><em class="label-not-found">dim</em><!-- Reference end --><0), but
|
83
113
|
<!-- Reference, RDLabel "z.rank ��dim" doesn't exist --><em class="label-not-found">z.rank ��dim</em><!-- Reference end --> must be > 0. </li>
|
84
|
-
<li>bc (Numeric) : a Numeric
|
85
|
-
|
86
|
-
<a href="#label:6">b_expand_linear_ext</a> which extend boundary with lenear value.</li>
|
114
|
+
<li>bc (Numeric) : a Numeric to represent boundary condition.
|
115
|
+
See <a href="#label-4">threepoint_O2nd_deriv</a> for supported conditions.</li>
|
87
116
|
</ul>
|
88
117
|
<p>RETURN VALUE</p>
|
89
118
|
<ul>
|
90
119
|
<li>cderiv_data (NArray): (z_{i+1} - z_{i-1}) / (x_{i+1} - x_{i-1})</li>
|
91
120
|
</ul></dd>
|
92
|
-
<dt><a name="label
|
121
|
+
<dt><h4><a name="label-7" id="label-7"><code>b_expand_linear_ext(<var>z</var>, <var>dim</var>)</code></a></h4></dt><!-- RDLabel: "b_expand_linear_ext" -->
|
93
122
|
<dd>
|
94
123
|
<p>expand boundary with linear value. extend array with 1 grid at each
|
95
124
|
boundary with <!-- Reference, RDLabel "dim" doesn't exist --><em class="label-not-found">dim</em><!-- Reference end --> th dimension, and assign th value which diffrential
|
@@ -107,7 +136,7 @@ value between a grid short of boundary and boundary grid in original array.
|
|
107
136
|
<ul>
|
108
137
|
<li>expand_data (NArray): </li>
|
109
138
|
</ul></dd>
|
110
|
-
<dt><a name="label
|
139
|
+
<dt><h4><a name="label-8" id="label-8"><code>cdiff(<var>x</var>, <var>dim</var>)</code></a></h4></dt><!-- RDLabel: "cdiff" -->
|
111
140
|
<dd>
|
112
141
|
<p>Diffrence operater. return an NArray which a difference <!-- Reference, RDLabel "x" doesn't exist --><em class="label-not-found">x</em><!-- Reference end -->
|
113
142
|
( in other wards, (x_{i+1} - x_{i-1}): now _{i} represents the suffix of
|
data/doc/gdir.html
CHANGED
@@ -7,28 +7,28 @@
|
|
7
7
|
<title>../lib/numru/gdir.rb</title>
|
8
8
|
</head>
|
9
9
|
<body>
|
10
|
-
<h1><a name="label
|
10
|
+
<h1><a name="label-0" id="label-0">class NumRu::GDir</a></h1><!-- RDLabel: "class NumRu::GDir" -->
|
11
11
|
<p>A class to represent diretories and data files for GPhys.</p>
|
12
|
-
<h2><a name="label
|
12
|
+
<h2><a name="label-1" id="label-1">Overview</a></h2><!-- RDLabel: "Overview" -->
|
13
13
|
<p>A GDir object represents a directory, or a file (such as a NetCDF
|
14
14
|
file or GrADS control file), for which
|
15
15
|
GPhys objects can be defined for the variables in it.
|
16
16
|
This means that a NetCDF file, for example, is treated a
|
17
17
|
directory, rather than a plain file.</p>
|
18
18
|
<p>GDir serves a directory tree under a root (top) directory, which can
|
19
|
-
be set as a class variable with <a href="#label
|
19
|
+
be set as a class variable with <a href="#label-3">GDir.top=</a>. All the absolute path
|
20
20
|
of GDir is actually relative to the root directory, and to access
|
21
21
|
outside the root directory is prohibited. Furthermore, it has a
|
22
22
|
working directory as a class variable, whose initial value is the top
|
23
|
-
directory and can be changed by <a href="#label
|
23
|
+
directory and can be changed by <a href="#label-8">GDir.cd</a>.</p>
|
24
24
|
<p>NEW(2005/06): Now GDir can accept DODS URL as a path. Also,
|
25
25
|
the top directory can be set to a DODS URL.</p>
|
26
|
-
<h2><a name="label
|
26
|
+
<h2><a name="label-2" id="label-2">Class Methods</a></h2><!-- RDLabel: "Class Methods" -->
|
27
27
|
<dl>
|
28
|
-
<dt><h4><a name="label
|
28
|
+
<dt><h4><a name="label-3" id="label-3"><code>GDir.top=(<var>top</var>)</code></a></h4></dt><!-- RDLabel: "GDir.top=" -->
|
29
29
|
<dd>
|
30
30
|
<p>Sets the root directory. This should be done before making
|
31
|
-
any GDir objects by <a href="#label
|
31
|
+
any GDir objects by <a href="#label-5">GDir.new</a>. The default root directory
|
32
32
|
is the root directory of the local file system ('/').</p>
|
33
33
|
<p>ARGUMENTS</p>
|
34
34
|
<ul>
|
@@ -38,13 +38,13 @@ is the root directory of the local file system ('/').</p>
|
|
38
38
|
<ul>
|
39
39
|
<li>absolute path of the top directory (String) (followed by a '/')</li>
|
40
40
|
</ul></dd>
|
41
|
-
<dt><h4><a name="label
|
41
|
+
<dt><h4><a name="label-4" id="label-4"><code>GDir.top</code></a></h4></dt><!-- RDLabel: "GDir.top" -->
|
42
42
|
<dd>
|
43
|
-
|
43
|
+
RETURN VALUE
|
44
44
|
<ul>
|
45
45
|
<li>absolute path of the top directory (String) (followed by a '/')</li>
|
46
46
|
</ul></dd>
|
47
|
-
<dt><h4><a name="label
|
47
|
+
<dt><h4><a name="label-5" id="label-5"><code>GDir.new(<var>path</var>)</code></a></h4></dt><!-- RDLabel: "GDir.new" -->
|
48
48
|
<dd>
|
49
49
|
<p>Constructor.</p>
|
50
50
|
<p>ARGUMENTS</p>
|
@@ -74,7 +74,7 @@ gdir = GDir.new(".")</pre>
|
|
74
74
|
<pre>gdir = GDir.new("/ho/data.nc")
|
75
75
|
gdir = GDir.new("/ho/data.ctl")</pre></li>
|
76
76
|
</ul></dd>
|
77
|
-
<dt><h4><a name="label
|
77
|
+
<dt><h4><a name="label-6" id="label-6"><code>GDir.set_text_pattern(*<var>regexps</var>)</code></a></h4></dt><!-- RDLabel: "GDir.set_text_pattern" -->
|
78
78
|
<dd>
|
79
79
|
<p>Sets regular expressions to match the file name of text files.
|
80
80
|
The default is /\.txt$/ and /^\w*$/.</p>
|
@@ -91,9 +91,9 @@ The default is /\.txt$/ and /^\w*$/.</p>
|
|
91
91
|
<ul>
|
92
92
|
<li>TypeError if any of the arguments is not a Regexp</li>
|
93
93
|
</ul></dd>
|
94
|
-
<dt><h4><a name="label
|
94
|
+
<dt><h4><a name="label-7" id="label-7"><code>GDir.add_text_pattern(<var>regexp</var> [, <var>regexp</var> [, ...]])</code></a></h4></dt><!-- RDLabel: "GDir.add_text_pattern" -->
|
95
95
|
<dd>
|
96
|
-
<p>Similar to <a href="#label
|
96
|
+
<p>Similar to <a href="#label-6">GDir.set_text_pattern</a>, but adds regular expressions
|
97
97
|
instead of replacing existing ones.</p>
|
98
98
|
<p>RETURN VALUE</p>
|
99
99
|
<ul>
|
@@ -103,17 +103,17 @@ instead of replacing existing ones.</p>
|
|
103
103
|
<ul>
|
104
104
|
<li>TypeError if any of the arguments is not a Regexp</li>
|
105
105
|
</ul></dd>
|
106
|
-
<dt><h4><a name="label
|
106
|
+
<dt><h4><a name="label-8" id="label-8"><code>GDir.cd(<var>path</var>)</code></a></h4></dt><!-- RDLabel: "GDir.cd" -->
|
107
107
|
<dd>
|
108
108
|
<p>Changes the working directory of the class.</p>
|
109
109
|
<p>RETURN VALUE</p>
|
110
110
|
<ul>
|
111
111
|
<li>a GDir</li>
|
112
112
|
</ul></dd>
|
113
|
-
<dt><h4><a name="label
|
113
|
+
<dt><h4><a name="label-9" id="label-9"><code>GDir.cwd=(<var>path</var>)</code></a></h4></dt><!-- RDLabel: "GDir.cwd=" -->
|
114
114
|
<dd>
|
115
|
-
|
116
|
-
<dt><h4><a name="label
|
115
|
+
Aliased to <a href="#label-8">GDir.cd</a>.</dd>
|
116
|
+
<dt><h4><a name="label-10" id="label-10"><code>GDir.cwd</code></a></h4></dt><!-- RDLabel: "GDir.cwd" -->
|
117
117
|
<dd>
|
118
118
|
<p>Returns the current working directory as a GDir. The initial value of
|
119
119
|
the working directory is the top directory.</p>
|
@@ -121,58 +121,58 @@ the working directory is the top directory.</p>
|
|
121
121
|
<ul>
|
122
122
|
<li>a GDir</li>
|
123
123
|
</ul></dd>
|
124
|
-
<dt><h4><a name="label
|
124
|
+
<dt><h4><a name="label-11" id="label-11"><code>GDir.cd(<var>path</var>)</code></a></h4></dt><!-- RDLabel: "GDir.cd" -->
|
125
125
|
<dd>
|
126
126
|
<p>Changes the working directory to path</p>
|
127
127
|
<p>RETURN VALUE</p>
|
128
128
|
<ul>
|
129
129
|
<li>a GDir (current working directory changed by path)</li>
|
130
130
|
</ul></dd>
|
131
|
-
<dt><h4><a name="label
|
132
|
-
<dt><h4><a name="label
|
133
|
-
<dt><h4><a name="label
|
134
|
-
<dt><h4><a name="label
|
135
|
-
<dt><h4><a name="label
|
136
|
-
<dt><h4><a name="label
|
137
|
-
<dt><h4><a name="label
|
138
|
-
<dt><h4><a name="label
|
139
|
-
<dt><h4><a name="label
|
140
|
-
<dt><h4><a name="label
|
141
|
-
<dt><h4><a name="label
|
142
|
-
<dd>
|
143
|
-
|
144
|
-
Thus, GDir.show is equivalent to GDir.cwd.show, for example.</
|
131
|
+
<dt><h4><a name="label-12" id="label-12"><code>GDir[]</code></a></h4></dt><!-- RDLabel: "GDir[]" -->
|
132
|
+
<dt><h4><a name="label-13" id="label-13"><code>GDir.data</code></a></h4></dt><!-- RDLabel: "GDir.data" -->
|
133
|
+
<dt><h4><a name="label-14" id="label-14"><code>GDir.text</code></a></h4></dt><!-- RDLabel: "GDir.text" -->
|
134
|
+
<dt><h4><a name="label-15" id="label-15"><code>GDir.list_dirs</code></a></h4></dt><!-- RDLabel: "GDir.list_dirs" -->
|
135
|
+
<dt><h4><a name="label-16" id="label-16"><code>GDir.list_dirs_v</code></a></h4></dt><!-- RDLabel: "GDir.list_dirs_v" -->
|
136
|
+
<dt><h4><a name="label-17" id="label-17"><code>GDir.list_data</code></a></h4></dt><!-- RDLabel: "GDir.list_data" -->
|
137
|
+
<dt><h4><a name="label-18" id="label-18"><code>GDir.list_data_v</code></a></h4></dt><!-- RDLabel: "GDir.list_data_v" -->
|
138
|
+
<dt><h4><a name="label-19" id="label-19"><code>GDir.list_texts</code></a></h4></dt><!-- RDLabel: "GDir.list_texts" -->
|
139
|
+
<dt><h4><a name="label-20" id="label-20"><code>GDir.list_texts_v</code></a></h4></dt><!-- RDLabel: "GDir.list_texts_v" -->
|
140
|
+
<dt><h4><a name="label-21" id="label-21"><code>GDir.ls</code></a></h4></dt><!-- RDLabel: "GDir.ls" -->
|
141
|
+
<dt><h4><a name="label-22" id="label-22"><code>GDir.ls_v</code></a></h4></dt><!-- RDLabel: "GDir.ls_v" -->
|
142
|
+
<dd>
|
143
|
+
All of these are dispatched to the current working directory.
|
144
|
+
Thus, GDir.show is equivalent to GDir.cwd.show, for example.</dd>
|
145
145
|
</dl>
|
146
|
-
<h2><a name="label
|
146
|
+
<h2><a name="label-23" id="label-23">Instance Methods</a></h2><!-- RDLabel: "Instance Methods" -->
|
147
147
|
<dl>
|
148
|
-
<dt><h4><a name="label
|
148
|
+
<dt><h4><a name="label-24" id="label-24"><code>close</code></a></h4></dt><!-- RDLabel: "close" -->
|
149
149
|
<dd>
|
150
|
-
|
151
|
-
<dt><h4><a name="label
|
150
|
+
Closes the file/directory objects in the GDir.</dd>
|
151
|
+
<dt><h4><a name="label-25" id="label-25"><code>path</code></a></h4></dt><!-- RDLabel: "path" -->
|
152
152
|
<dd>
|
153
153
|
<p>Returns the path (relative to the top directory)</p>
|
154
154
|
<p>RETURN VALUE</p>
|
155
155
|
<ul>
|
156
156
|
<li>a String</li>
|
157
157
|
</ul></dd>
|
158
|
-
<dt><h4><a name="label
|
158
|
+
<dt><h4><a name="label-26" id="label-26"><code>name</code></a></h4></dt><!-- RDLabel: "name" -->
|
159
159
|
<dd>
|
160
160
|
<p>Name of the GDir</p>
|
161
161
|
<p>RETURN VALUE</p>
|
162
162
|
<ul>
|
163
163
|
<li>a String</li>
|
164
164
|
</ul></dd>
|
165
|
-
<dt><h4><a name="label
|
165
|
+
<dt><h4><a name="label-27" id="label-27"><code>inspect</code></a></h4></dt><!-- RDLabel: "inspect" -->
|
166
166
|
<dd>
|
167
167
|
<p>Returns the path</p>
|
168
168
|
<p>RETURN VALUE</p>
|
169
169
|
<ul>
|
170
170
|
<li>a String</li>
|
171
171
|
</ul></dd>
|
172
|
-
<dt><h4><a name="label
|
172
|
+
<dt><h4><a name="label-28" id="label-28"><code>[<var>path</var>]</code></a></h4></dt><!-- RDLabel: "[]" -->
|
173
173
|
<dd>
|
174
174
|
<p>Returns a GDir, GPhys, or File (text), by calling
|
175
|
-
<a href="#label
|
175
|
+
<a href="#label-29">dir</a>, <a href="#label-30">data</a>, or <a href="#label-31">text</a> depending on path.</p>
|
176
176
|
<p>ARGUMENTS</p>
|
177
177
|
<ul>
|
178
178
|
<li><var>path</var> (String): Either relative or absolute.</li>
|
@@ -185,7 +185,7 @@ Thus, GDir.show is equivalent to GDir.cwd.show, for example.</p></dd>
|
|
185
185
|
<ul>
|
186
186
|
<li>an exception is raised if <var>path</var> is not appropriate.</li>
|
187
187
|
</ul></dd>
|
188
|
-
<dt><h4><a name="label
|
188
|
+
<dt><h4><a name="label-29" id="label-29"><code>dir(<var>path</var>)</code></a></h4></dt><!-- RDLabel: "dir" -->
|
189
189
|
<dd>
|
190
190
|
<p>Returns a GDir specified the <var>path</var>.</p>
|
191
191
|
<p>ARGUMENTS</p>
|
@@ -200,7 +200,7 @@ Thus, GDir.show is equivalent to GDir.cwd.show, for example.</p></dd>
|
|
200
200
|
<ul>
|
201
201
|
<li>an exception is raised if <var>path</var> is invalid as a GDir.</li>
|
202
202
|
</ul></dd>
|
203
|
-
<dt><h4><a name="label
|
203
|
+
<dt><h4><a name="label-30" id="label-30"><code>data(<var>path</var>)</code></a></h4></dt><!-- RDLabel: "data" -->
|
204
204
|
<dd>
|
205
205
|
<p>Returns a GPhys specified the <var>path</var>.</p>
|
206
206
|
<p>ARGUMENTS</p>
|
@@ -215,7 +215,7 @@ Thus, GDir.show is equivalent to GDir.cwd.show, for example.</p></dd>
|
|
215
215
|
<ul>
|
216
216
|
<li>an exception is raised if <var>path</var> is invalid as a GPhys.</li>
|
217
217
|
</ul></dd>
|
218
|
-
<dt><h4><a name="label
|
218
|
+
<dt><h4><a name="label-31" id="label-31"><code>text(<var>path</var>)</code></a></h4></dt><!-- RDLabel: "text" -->
|
219
219
|
<dd>
|
220
220
|
<p>Returns a text file object specified the <var>path</var>.</p>
|
221
221
|
<p>ARGUMENTS</p>
|
@@ -231,7 +231,7 @@ Thus, GDir.show is equivalent to GDir.cwd.show, for example.</p></dd>
|
|
231
231
|
<li>an exception is raised if <var>path</var> is invalid as a text file
|
232
232
|
(based on the pattern: see above).</li>
|
233
233
|
</ul></dd>
|
234
|
-
<dt><h4><a name="label
|
234
|
+
<dt><h4><a name="label-32" id="label-32"><code>find_dir( <var>filt</var> )</code></a></h4></dt><!-- RDLabel: "find_dir" -->
|
235
235
|
<dd>
|
236
236
|
<p>Recursively search a GDir whose name match <var>filt</var>..</p>
|
237
237
|
<p>ARGUMENTS</p>
|
@@ -243,7 +243,7 @@ Thus, GDir.show is equivalent to GDir.cwd.show, for example.</p></dd>
|
|
243
243
|
<ul>
|
244
244
|
<li>an Array holding pathes (String) that matched.</li>
|
245
245
|
</ul></dd>
|
246
|
-
<dt><h4><a name="label
|
246
|
+
<dt><h4><a name="label-33" id="label-33"><code>find_data( <var>name</var>=<var>nil</var>,<var>long_name</var>=<var>nil</var>,<var>units</var>=<var>nil</var> )</code></a></h4></dt><!-- RDLabel: "find_data" -->
|
247
247
|
<dd>
|
248
248
|
<p>Recursively search data variables under the directory.
|
249
249
|
Mathces are by taking "AND" for non-nil arguments.
|
@@ -262,10 +262,10 @@ Mathces are by taking "AND" for non-nil arguments.
|
|
262
262
|
<li>an Array holding the path and variable name that matched
|
263
263
|
(two-element Array of String; [path, variable_name] ).</li>
|
264
264
|
</ul></dd>
|
265
|
-
<dt><h4><a name="label
|
265
|
+
<dt><h4><a name="label-34" id="label-34"><code>list_dirs(<var>path</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "list_dirs" -->
|
266
266
|
<dd>
|
267
267
|
<p>Returns the names of the directories.</p>
|
268
|
-
<p>See also <a href="#label
|
268
|
+
<p>See also <a href="#label-40">ls</a>.</p>
|
269
269
|
<p>ARGUMENTS</p>
|
270
270
|
<ul>
|
271
271
|
<li><var>path</var> (nil or String): if nil, the method is applied to the
|
@@ -276,13 +276,13 @@ Mathces are by taking "AND" for non-nil arguments.
|
|
276
276
|
<ul>
|
277
277
|
<li>an Array of String</li>
|
278
278
|
</ul></dd>
|
279
|
-
<dt><h4><a name="label
|
279
|
+
<dt><h4><a name="label-35" id="label-35"><code>list_dirs_v(<var>path</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "list_dirs_v" -->
|
280
280
|
<dd>
|
281
|
-
<p>Verbose version of <a href="#label
|
282
|
-
<p>See also <a href="#label
|
281
|
+
<p>Verbose version of <a href="#label-34">list_dirs</a>, showing size and mtime like 'ls -l'.</p>
|
282
|
+
<p>See also <a href="#label-43">ls_l</a>.</p>
|
283
283
|
<p>ARGUMENTS</p>
|
284
284
|
<ul>
|
285
|
-
<li>See <a href="#label
|
285
|
+
<li>See <a href="#label-34">list_dirs</a>.</li>
|
286
286
|
</ul>
|
287
287
|
<p>RETURN VALUE</p>
|
288
288
|
<ul>
|
@@ -290,7 +290,7 @@ Mathces are by taking "AND" for non-nil arguments.
|
|
290
290
|
<p>Example of a string:</p>
|
291
291
|
<pre>275492 Apr 12 19:15 hogehoge_data.nc/</pre></li>
|
292
292
|
</ul></dd>
|
293
|
-
<dt><h4><a name="label
|
293
|
+
<dt><h4><a name="label-36" id="label-36"><code>list_data(<var>path</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "list_data" -->
|
294
294
|
<dd>
|
295
295
|
<p>Returns the names of the data (variables on which GPhys objects
|
296
296
|
can be defined.) Returns a non-empty array if the GDir (current
|
@@ -306,14 +306,14 @@ NetCDF or GrADS control file).</p>
|
|
306
306
|
<ul>
|
307
307
|
<li>an Array of String</li>
|
308
308
|
</ul></dd>
|
309
|
-
<dt><h4><a name="label
|
309
|
+
<dt><h4><a name="label-37" id="label-37"><code>list_data_v(<var>path</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "list_data_v" -->
|
310
310
|
<dd>
|
311
|
-
<p>Verbose version of <a href="#label
|
311
|
+
<p>Verbose version of <a href="#label-36">list_data</a>, showing shape, long_name,
|
312
312
|
and units.</p>
|
313
|
-
<p>See also <a href="#label
|
313
|
+
<p>See also <a href="#label-43">ls_l</a>.</p>
|
314
314
|
<p>ARGUMENTS</p>
|
315
315
|
<ul>
|
316
|
-
<li>See <a href="#label
|
316
|
+
<li>See <a href="#label-36">list_data</a>.</li>
|
317
317
|
</ul>
|
318
318
|
<p>RETURN VALUE</p>
|
319
319
|
<ul>
|
@@ -321,7 +321,7 @@ and units.</p>
|
|
321
321
|
<p>Example of a string:</p>
|
322
322
|
<pre>u [lon=120,lat=120,z=40,t=73] 'x components of velocity' (m/s)</pre></li>
|
323
323
|
</ul></dd>
|
324
|
-
<dt><h4><a name="label
|
324
|
+
<dt><h4><a name="label-38" id="label-38"><code>list_texts(<var>path</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "list_texts" -->
|
325
325
|
<dd>
|
326
326
|
<p>Returns the names of the text files.
|
327
327
|
Whether a file is a text file or not is judged based on the
|
@@ -340,63 +340,63 @@ can be customized by <!-- Reference, RDLabel "set_text_patterns" doesn't exist -
|
|
340
340
|
<ul>
|
341
341
|
<li>an Array of String</li>
|
342
342
|
</ul></dd>
|
343
|
-
<dt><h4><a name="label
|
343
|
+
<dt><h4><a name="label-39" id="label-39"><code>list_texts_v(<var>path</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "list_texts_v" -->
|
344
344
|
<dd>
|
345
|
-
<p>Verbose version of <a href="#label
|
346
|
-
<p>See also <a href="#label
|
345
|
+
<p>Verbose version of <a href="#label-38">list_texts</a>, showing size and mtime like 'ls -l'.</p>
|
346
|
+
<p>See also <a href="#label-43">ls_l</a>.</p>
|
347
347
|
<p>ARGUMENTS</p>
|
348
348
|
<ul>
|
349
|
-
<li>See <a href="#label
|
349
|
+
<li>See <a href="#label-38">list_texts</a>.</li>
|
350
350
|
</ul>
|
351
351
|
<p>RETURN VALUE</p>
|
352
352
|
<ul>
|
353
353
|
<li>an Array of String</li>
|
354
354
|
</ul></dd>
|
355
|
-
<dt><h4><a name="label
|
355
|
+
<dt><h4><a name="label-40" id="label-40"><code>ls(<var>path</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "ls" -->
|
356
356
|
<dd>
|
357
|
-
<p>Prints the results of <a href="#label
|
358
|
-
<a href="#label
|
357
|
+
<p>Prints the results of <a href="#label-34">list_dirs</a>, <a href="#label-36">list_data</a>, and
|
358
|
+
<a href="#label-38">list_texts</a> on the standard output.</p>
|
359
359
|
<p>RETURN VALUE</p>
|
360
360
|
<ul>
|
361
361
|
<li>nil</li>
|
362
362
|
</ul></dd>
|
363
|
-
<dt><h4><a name="label
|
363
|
+
<dt><h4><a name="label-41" id="label-41"><code>each_dir</code></a></h4></dt><!-- RDLabel: "each_dir" -->
|
364
364
|
<dd>
|
365
|
-
|
366
|
-
<dt><h4><a name="label
|
365
|
+
Iterator for each directory (GDir) under self.</dd>
|
366
|
+
<dt><h4><a name="label-42" id="label-42"><code>each_data</code></a></h4></dt><!-- RDLabel: "each_data" -->
|
367
367
|
<dd>
|
368
|
-
|
369
|
-
<dt><h4><a name="label
|
368
|
+
Iterator for each GPhys under self.</dd>
|
369
|
+
<dt><h4><a name="label-43" id="label-43"><code>ls_l(<var>path</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "ls_l" -->
|
370
370
|
<dd>
|
371
|
-
<p>Verbose version of <a href="#label
|
372
|
-
Prints the results of <a href="#label
|
373
|
-
<a href="#label
|
371
|
+
<p>Verbose version of <a href="#label-40">ls</a>.
|
372
|
+
Prints the results of <a href="#label-35">list_dirs_v</a>, <a href="#label-37">list_data_v</a>, and
|
373
|
+
<a href="#label-39">list_texts_v</a> on the standard output.</p>
|
374
374
|
<p>RETURN VALUE</p>
|
375
375
|
<ul>
|
376
376
|
<li>nil</li>
|
377
377
|
</ul></dd>
|
378
|
-
<dt><h4><a name="label
|
378
|
+
<dt><h4><a name="label-44" id="label-44"><code>mtime</code></a></h4></dt><!-- RDLabel: "mtime" -->
|
379
379
|
<dd>
|
380
380
|
<p>Returns the last modified time.</p>
|
381
381
|
<p>RETURN VALUE</p>
|
382
382
|
<ul>
|
383
383
|
<li>a Time</li>
|
384
384
|
</ul></dd>
|
385
|
-
<dt><h4><a name="label
|
385
|
+
<dt><h4><a name="label-45" id="label-45"><code>atime</code></a></h4></dt><!-- RDLabel: "atime" -->
|
386
386
|
<dd>
|
387
387
|
<p>Returns the last accessed time.</p>
|
388
388
|
<p>RETURN VALUE</p>
|
389
389
|
<ul>
|
390
390
|
<li>a Time</li>
|
391
391
|
</ul></dd>
|
392
|
-
<dt><h4><a name="label
|
392
|
+
<dt><h4><a name="label-46" id="label-46"><code>ctime</code></a></h4></dt><!-- RDLabel: "ctime" -->
|
393
393
|
<dd>
|
394
394
|
<p>Returns ctime.</p>
|
395
395
|
<p>RETURN VALUE</p>
|
396
396
|
<ul>
|
397
397
|
<li>a Time</li>
|
398
398
|
</ul></dd>
|
399
|
-
<dt><h4><a name="label
|
399
|
+
<dt><h4><a name="label-47" id="label-47"><code>mtime_like_ls_l</code></a></h4></dt><!-- RDLabel: "mtime_like_ls_l" -->
|
400
400
|
<dd>
|
401
401
|
<p>Returns the last modified time formated as in ls -l.
|
402
402
|
That is, if the time of last modification is greater than
|