ruby-netcdf 0.6.5

Sign up to get free protection for your applications and to get access to all the features.
data/doc/Ref_man_jp.rd ADDED
@@ -0,0 +1,1276 @@
1
+ =begin
2
+ =RubyNetCDF ��ե���󥹥ޥ˥奢��
3
+
4
+ * ((<�᥽�åɥ���ǥå���>))
5
+
6
+ ---------------------------------------------
7
+
8
+ ==����
9
+
10
+ RubyNetCDF �� NetCDF �饤�֥�꡼�� Ruby ���󥿡��ե������Ǥ��롣Ruby
11
+ �ϥե꡼�ʥ��֥������Ȼظ�������ץȸ���Ǥ��ꡢ
12
+ ((<����|URL:http://www.ruby-lang.org/>))
13
+ ��������Ǥ��롣RubyNetCDF �Ͽ�������Ȥ��ơ�
14
+ Ruby �ǰ���Ū�˻Ȥ��Ƥ���¿������������饤�֥�꡼
15
+ ((<NArray|URL:http://www.ruby-lang.org/en/raa-list.rhtml?name=NArray>))
16
+ ���Ѥ�Τǡ����餫���ᥤ�󥹥ȡ��뤷�Ƥ���ɬ�פ����롣
17
+ NArray �ϥǡ�����C �Υݥ��󥿡����ؤ�Ϣ³�������꡼�ΰ�
18
+ ���ݻ������׻����񸻤��Ψ�褯���Ѥ��롣NArray �� Python �ˤ�����
19
+ NumPy �Ȼ��뤬�����Ĥ��Υƥ��Ȥ� NArray �Τۤ��� NumPy ����Ψ���ɤ�
20
+ ���Ȥ򼨺����Ƥ��롣
21
+ ���ץ����Ȥ��ơ�RubyNetCDF �ϥǡ�����»�μ�ưŪ�ʼ�갷���᥽�åɤ�
22
+ �󶡤��롣�����Ȥ��ˤϡ�
23
+ ((<NArrayMiss|URL:http://ruby.gfd-dennou.org/products/narray_miss/>))
24
+ ��ɬ�פǤ��롣�ܤ�����((<����ˡ>))�򸫤衣
25
+
26
+ ===����
27
+
28
+ RubyNetCDF �ϰʲ��Σ��ĤΥ��饹���鹽������롣
29
+
30
+ * ((<���饹 NetCDF>)) -- �ե�����Υ��饹
31
+
32
+ ��Ĥ�NetCDF���饹�Υ��֥������Ȥϰ�Ĥ� NetCDF �ե�������б�����
33
+
34
+ * ((<���饹 NetCDFDim>)) -- �����Υ��饹
35
+
36
+ C �� NetCDF �Ǥϡ������ϡ��ե������ID�ȼ���ID�Ȥ������ѿ����Ȥ�ɽ����뤬��
37
+ Ruby �ǤǤϰ�Ĥ� NetCDFDim ���֥������Ȥ���ɽ�����
38
+
39
+ * ((<���饹 NetCDFVar>)) -- �ѿ��Υ��饹
40
+
41
+ C �� NetCDF �Ǥϡ��ѿ��ϡ��ե������ID���ѿ�ID�Ȥ������ѿ����Ȥ�ɽ����뤬��
42
+ Ruby �ǤǤϰ�Ĥ� NetCDFVar ���֥������Ȥ���ɽ�����
43
+
44
+ * ((<���饹 NetCDFAtt>)) -- °���Υ��饹
45
+
46
+ C �� NetCDF �Ǥϡ�°���ϡ��ե������ID���ѿ�ID��°��̾���Ȥ�ɽ����뤬��
47
+ Ruby �ǤǤϰ�Ĥ� NetCDFAtt ���֥������Ȥ���ɽ�����
48
+
49
+ ===�ǡ�����
50
+
51
+ �ܥ饤�֥�꡼�Ǥ����Ƥ� NetCDF �ѿ��η� char, byte, short, int,
52
+ float, double �����ݡ��Ȥ���Ƥ��롣�������������� Ruby �Ρʤ������
53
+ �˸����� NArray �Ρ˴���˽��äơ����줾�� "char", "byte", "sint",
54
+ "int", "sfloat", "float" �ȸƤФ�롣���äơ�NetCDFVar ���饹�� vartype
55
+ (=ntype) �Ϥ�����ʸ����ΰ�Ĥ��֤����ޤ���NetCDF���饹�� def_var ��
56
+ ���åɤϡ��ѿ����������ݡ�����������դ��롣�ä����դ���ɬ�פ�����
57
+ �Τϡ��ܥ饤�֥�꡼�Ǥ� "float" �� C �Ǹ����Ȥ����� double ���̣����
58
+ �Ȥ������ȤǤ��롣����� Ruby �δ���Τ����Ǥ��� -- �Ȥ߹��ߤ� Float
59
+ ���饹�ϡ�C �� float �Ǥʤ� double ���б�����ΤǤ��롣
60
+
61
+ NetCDFVar ���饹�� get �᥽�åɤϥե��������Ʊ������ NArray �ѿ�����
62
+ ���ɤ߹��ब��"char" ���ѿ��ˤĤ��Ƥ� "byte" �� NArray ���ɤ߹��ޤ�롣
63
+ ����� NArray �� "char" ��������ʤ�����Ǥ��롣���������⤽�� NArray
64
+ �� byte ����ʸ������ñ�˰�����Τǡ��ä����Թ�Ϥʤ��ȹͤ����롣
65
+
66
+ ===���顼����
67
+
68
+ ���顼�ϴ���Ū�ˤ��㳰��ȯ�����뤳�Ȥˤ���н褹�롣â�����ͤ��֤��᥽��
69
+ �ɤǤϷ����ʥ��顼�� nil ���֤����Ȥ��н褹���°���ͤ����뤿��˻���
70
+ ���줿̾����°����¸�ߤ��ʤ��Ȥ��ʤɡˡ��㳰Ū�ʾ����� nil ��ȯ������
71
+ �᥽�åɤˤĤ��Ƥϥޥ˥奢����������Ƥ��롣
72
+
73
+ ===�������ƥ�
74
+
75
+ �Ȥ߹��ߤ� File ���饹��Ʊ���������ƥ����б��򤷤Ƥ��Ƥ롣
76
+
77
+ ===����ˡ
78
+
79
+ RubyNetCDF�饤�֥�꡼�����Ѥ��뤿��ˤϡ��ޤ����ιԤ� Ruby �ץ������˽�
80
+ �ƥ饤�֥�꡼������ɤ���ɬ�פ����롣
81
+
82
+ require 'numru/netcdf'
83
+
84
+ �⤷�� (NetCDFVar���饹��) ��ưŪ�ʥǡ�����»�����᥽�åɤ�Ȥ�������
85
+ ��ϡ��ʲ���¹Ԥ���ɬ�פ����롣
86
+
87
+ require 'numru/netcdf_miss'
88
+
89
+ ����������ǰ��ֺǽ�� (({require 'numru/netcdf'})) ��¹Ԥ���Τǡ�
90
+ ��������Ƥ٤��ɤ����ǡ�����»�ΰ�����
91
+ ((<NArrayMiss|URL:http://ruby.gfd-dennou.org/products/narray_miss/>))
92
+ �ˤ��Τǡ�����򥤥󥹥ȡ��뤷�Ƥ����ͤФʤ�ʤ���
93
+ �⤷�� (({require 'numru/netcdf'})) ������Ƥ֤Τʤ顢NArrayMiss
94
+ �����פǤ��롣
95
+
96
+ �����ǡ�'numru' ("Numerical Ruby"������줿) �ϥ桼�����Υ饤�֥�꡼
97
+ �����ɥѥ���Υ��֥ǥ��쥯�ȥ꡼�ǡ�RubyNetCDF �饤�֥�꡼���֤���롣
98
+ ����ȡ��ʲ��Τ褦�����ѤǤ���褦�ˤʤ롣
99
+
100
+ file = NumRu::NetCDF.create('tmp.nc')
101
+ x = file.def_dim('x',10)
102
+ y = file.def_dim('y',10)
103
+ v = file.def_var('v','float',[x,y])
104
+ file.close
105
+
106
+ �����ǡ�NumRu �Ϥ��Υ饤�֥�꡼��ޤ�⥸�塼��Ǥ��롣���Τ褦�ʥ⥸�塼
107
+ ��ˤ����Ǥ���Τϡ�̾�����֤Ǥξ��ͤ��򤱤뤿��Ǥ��롣���Τ褦�ʰ�
108
+ ���򤷤ʤ���硢�⤷��桼���������ܥ饤�֥�꡼��Υ��饹��̾��������
109
+ ���륯�饹��⥸�塼���ޤ�饤�֥�꡼��Ȥ����Ȥ���ȡ����꤬���롣
110
+
111
+ ���Τ褦�����꤬������ʤ��Ǥ��������ϡ�"NumRu::" �Ȥ������ϡ�NumRu
112
+ �⥸�塼���֥��󥯥롼�ɡפ��뤳�Ȥdz�����ʸ��ߤΥ������פˤ����Ƥ�
113
+ �������Ǥ���ˡ����äƼ��Τ褦�˽񤱤롣
114
+
115
+ include NumRu
116
+ file = NetCDF.create('tmp.nc')
117
+ ...
118
+
119
+ ����ʤ������Ȥ��Ƥϥ�����������ѥѥå������˴ޤޤ�� demo �� test
120
+ �ץ������򻲾Ȥ��衣
121
+
122
+
123
+ ---------------------------------------------
124
+
125
+ ==�ޥ˥奢��θ���
126
+
127
+ --- �᥽�å�̾(����1, ����2, ...) -- ��ά��ǽ�ʰ����� ����̾=�ǥե������ �η��Ǽ���
128
+
129
+ ��ǽ�β���
130
+
131
+ ����
132
+ * ����1��̾ (���Υ��饹�ޤ��ϼ��������): ����
133
+ * ����2��̾ (���Υ��饹�ޤ��ϼ��������): ����
134
+ * ...
135
+
136
+ �����
137
+ * ����ͤ�����
138
+
139
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
140
+ * NetCDF ver 3 �δؿ�̾����̤��ʤ���硢���δؿ���Ʊ���ε�ǽ��ͭ
141
+ ���뤳�Ȥ򼨤���ľ��Ū���б����ʤ���硢�����˰�¸����ؿ���󤲤롣
142
+
143
+ ---------------------------------------------
144
+
145
+ ==�᥽�åɥ���ǥå���
146
+ * ((<���饹 NetCDF>))
147
+
148
+ ���饹�᥽�å�
149
+ * ((<NetCDF.open>)) �ե����륪���ץ�ʥ��饹�᥽�åɡ�mode="w" �ǥե����뤬¸�ߤ��ʤ���п�������
150
+ * ((<NetCDF.new>)) NetCDF.open�᥽�åɤΥ����ꥢ���Ǥ���
151
+ * ((<NetCDF.create>)) NetCDF�ե��������ʥ��饹�᥽�å�)
152
+ * ((<NetCDF.create_tmp>)) �ƥ�ݥ�꡼NetCDF�ե��������ʥ��饹�᥽�å�)
153
+
154
+ ���󥹥��󥹥᥽�å�
155
+ * ((<close>)) �ե����륯������
156
+ * ((<ndims>)) �ե�������μ����ο����֤�
157
+ * ((<nvars>)) �ե���������ѿ��ο����֤�
158
+ * ((<natts>)) �ե�������Υ������Х�°���ο����֤�
159
+ * ((<unlimited>)) �ե��������unlimited dimension���֤�
160
+ * ((<path>)) �ե�����Υѥ�. open/create����filename��������Ȥ��֤�.
161
+ * ((<redef>)) define mode�ˤ��롣���ˤ����ʤ鲿�⤻��nil���֤���
162
+ * ((<enddef>)) data mode �����롣���ˤ����ʤ鲿�⤻��nil���֤���
163
+ * ((<define_mode?>)) ������⡼�ɤ��ɤ������碌��.
164
+ * ((<sync>)) ���꡼��ΥХåե�����ǥ��������ȿ�Ǥ��ƥե������Ʊ��������
165
+ * ((<def_dim>)) dimension�����
166
+ * ((<put_att>)) �������Х�°��������
167
+ * ((<def_var>)) �ѿ������
168
+ * ((<def_var_with_dim>)) def_var��Ʊ������ɬ�פʤ�ޤ�������������롣
169
+ * ((<var>)) �ե�����˴�¸���ѿ��򥪡��ץ�
170
+ * ((<vars>)) �ե�����˴�¸���ѿ���ޤȤ�ƥ����ץ�
171
+ * ((<dim>)) ��¸�μ����򥪡��ץ�
172
+ * ((<dims>)) ��¸�μ�����ޤȤ�ƥ����ץ�
173
+ * ((<att>)) ��¸�Υ������Х�°���򥪡��ץ�
174
+ * ((<fill=>)) fillmode���ѹ���(NetCDF �Υǥե���Ȥ� FILL �Ǥ��롣)
175
+ * ((<each_dim>)) �����˴ؤ��륤�ƥ졼��.
176
+ * ((<each_var>)) �ѿ��˴ؤ��륤�ƥ졼��.
177
+ * ((<each_att>)) �������Х�°���˴ؤ��륤�ƥ졼��.
178
+ * ((<dim_names>)) �ե����������������̾���������������֤���
179
+ * ((<var_names>)) �ե�����������ѿ���̾���������������֤���
180
+ * ((<att_names>)) �ե�����������������Х�°����̾���������������֤���
181
+
182
+ * ((<���饹 NetCDFDim>))
183
+
184
+ ���饹�᥽�å�
185
+
186
+ ���󥹥��󥹥᥽�å�
187
+ * ((<length>)) ������Ĺ�����֤�
188
+ * ((<length_ul0>)) length ��Ʊ��������̵���¼����˴ؤ��������֤�
189
+ * ((<name=>)) ̾����Ĥ�������
190
+ * ((<name>)) ̾�����֤�
191
+ * ((<unlimited?>)) ̵���¼������ɤ�����
192
+
193
+ * ((<���饹 NetCDFVar>))
194
+
195
+ ���饹�᥽�å�
196
+ * ((<NetCDFVar.new>)) NetCDF.open �� NetCDF#Var ���Ȥ߹�碌�ư�ԤǺѤޤ�(�Ȥ�ʤ����ɤ�).
197
+ * ((<NetCDFVar.unpack_type=>)) ((<unpack>))�ǻȤ�NArray�η�����ꤹ��
198
+ * ((<NetCDFVar.unpack_type>)) ((<NetCDFVar.unpack_type=>))�����ꤷ��NArray�η����֤�
199
+
200
+
201
+ ���󥹥��󥹥᥽�å�
202
+ * ((<dim>)) �����ѿ��ˤ����� dim_num ����(0���������)�μ��������碌�롣
203
+ * ((<dims>)) �����ѿ���������������ˤ�����֤�
204
+ * ((<shape_ul0>)) �ѿ��η����֤�. â��̵���¼�����Ĺ���ϥ���.
205
+ * ((<shape_current>)) �ѿ��θ��ߤη����֤�.
206
+ * ((<each_att>)) �ѿ������°��(NetCDFAtt)�˴ؤ��륤�ƥ졼��
207
+ * ((<dim_names>)) �ѿ������������̾���������������֤���
208
+ * ((<att_names>)) �ѿ������°����̾���������������֤���
209
+ * ((<name>)) �ѿ���̾�����֤�
210
+ * ((<name=>)) ̾�����դ��ؤ���
211
+ * ((<ndims>)) �����ο����䤦
212
+ * ((<rank>)) ndims�Υ��ꥢ��
213
+ * ((<ntype>)) vartype ����̾
214
+ * ((<vartype>)) �ѿ��ͤη����䤦
215
+ * ((<typecode>)) �ѿ��ͤη����䤦(NArray��typecode���֤�)
216
+ * ((<natts>)) °���ο����䤦
217
+ * ((<file>)) �����ѿ���°����ե���������碌��
218
+ * ((<att>)) ̾������ꤷ��°�����֤�
219
+ * ((<put_att>)) °��������
220
+ * ((<put>)) ��((<simple_put>))����̾(alias)
221
+ * ((<simple_put>)) �ͤ������
222
+ * ((<pack>)) self��°�� scale_factor and/or add_offset ���Ѥ��� NArray ���� "pack" ����.
223
+ * ((<scaled_put>)) ((<simple_put>)) ��Ʊ�ͤ�����((<pack>))�ˤ��°�� scale_factor �� add_offset ���᤹��
224
+ * ((<get>)) ��((<simple_get>))����̾(alias)
225
+ * ((<simple_get>)) �ͤ���Ф�
226
+ * ((<unpack>)) self��°�� scale_factor and/or add_offset ���Ѥ��� NArray ���� "unpack" ����.
227
+ * ((<scaled_get>)) ((<simple_get>)) ��Ʊ�ͤ�����((<unpack>))�ˤ��°�� scale_factor �� add_offset ���᤹��
228
+ * ((<[]>)) NetCDFVar#get ��Ʊ�ͤ��������֥��åȤ� NArray#[] ��Ʊ�ͤ˻��ꤹ��.
229
+ * ((<[]=>)) NetCDFVar#put ��Ʊ�ͤ��������֥��åȤ� NArray#[]= ��Ʊ�ͤ˻��ꤹ��.
230
+
231
+
232
+ "numru/netcdf_miss" �� require ���뤳�Ȥ��ɲä���륤�󥹥��󥹥᥽�å�
233
+
234
+ * ((<get_with_miss>)) ��((<get>))��Ʊ�ͤ������ǡ�����»���������
235
+
236
+ * ((<get_with_miss_and_scaling>)) ��((<get_with_miss>))��Ʊ�ͤ�����((<unpack>))�ˤ�ꥹ������󥰤�Ԥ�.
237
+ * ((<put_with_miss>)) ��((<put>))��Ʊ�ͤ������ǡ�����»���������
238
+ * ((<put_with_miss_and_scaling>)) ��((<put_with_miss>))��Ʊ�ͤ�����((<pack>))�ˤ�ꥹ������󥰤�Ԥ�.
239
+
240
+ * ((<���饹 NetCDFAtt>))
241
+
242
+ ���饹�᥽�å�
243
+
244
+ ���󥹥��󥹥᥽�å�
245
+ * ((<name>)) °����̾�����֤�
246
+ * ((<name=>)) °����̾�����ѹ�
247
+ * ((<copy>)) °�����̤��ѿ��ޤ��ϥե�����˥��ԡ����ե�����ξ��ϥ������Х�°���ˤʤ�
248
+ * ((<delete>)) °������
249
+ * ((<put>)) °�����ͤ�����
250
+ * ((<get>)) °������Ȥ���Ф�
251
+ * ((<atttype>)) °���ͤη����䤦
252
+ * ((<typecode>)) °���ͤη����䤦(NArray��typecode���֤�)
253
+
254
+ ---------------------------------------------
255
+
256
+ =���饹 NetCDF
257
+ ===���饹�᥽�å�
258
+ ---NetCDF.open(filename, mode="r", share=false)
259
+ �ե����륪���ץ�ʥ��饹�᥽�åɡ�mode="w" �ǥե����뤬¸�ߤ��ʤ���п�������
260
+
261
+ ����
262
+ * filename (String): �ե�����̾
263
+ * mode (String) : �����ϥ⡼��: "r"(�ɤ߼��Τ�); "w","w+" (��
264
+ ���� -- ���ߤ���ȤϾ��(�ä���!)); "r+","a","a+" (�ɲ� --
265
+ ���ߤ����ƤϤ��Τޤޤˡ��񤭹��߲�)�� �Ȥ߹��ߤ� File ���饹��
266
+ �㤤���ɤΥ⡼�ɤǤ��ɤ߹��ߤϲ�ǽ�����ա����ˤʤ� NetCDF�饤
267
+ �֥�꡼�����¤ˤ�ꡢ���ɲáפˤ�;ʬ�ʻ��֤ȥǥ��������ڡ���
268
+ �������롣
269
+ * share (true or false) : shared�⡼�ɤˤ��뤫 (�񤭹�����Υե�
270
+ �����¾�Υץ�����������ɤ߹��ߤ������������ true �Ȥ��롣C�ǥ桼
271
+ ��������������5�Ϥ� nc_open �ι�򻲾ȤΤ���)
272
+
273
+ �����
274
+ * NetCDF���饹�Υ��֥�������
275
+
276
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
277
+ * nc_open, nc_create
278
+
279
+ ---NetCDF.new
280
+ NetCDF.open�᥽�åɤΥ����ꥢ���Ǥ���
281
+
282
+ ---NetCDF.create(filename, noclobber=false, share=false)
283
+ NetCDF�ե��������ʥ��饹�᥽�å�)
284
+
285
+ ����
286
+ * filename (String) : �ե�����̾
287
+ * noclobber (true or false) : ��񤭤��뤫���ʤ���
288
+ * share (true or false) : shared mode ��Ȥ��� (�񤭹�����Υե�
289
+ �����¾�Υץ�����������ɤ߹��ߤ������������ true �Ȥ��롣C�ǥ桼
290
+ ��������������5�Ϥ� nc_open �ι�򻲾ȤΤ���)
291
+
292
+ �����
293
+ * NetCDF���饹�Υ��֥�������
294
+
295
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
296
+ * nc_create
297
+
298
+ ---NetCDF.create_tmp(tmpdir=ENV['TMPDIR']||ENV['TMP']||ENV['TEMP']||'.', share=false)
299
+ �ƥ�ݥ�꡼NetCDF�ե��������ʥ��饹�᥽�å�)
300
+ ̾���ϼ�ư�Ƿ�ޤ롣�������������Ⱦä���롣
301
+
302
+ ����
303
+ * tmpdir (String) : �ƥ�ݥ�꡼�ե�������֤��ǥ��쥯�ȥ꡼̾��
304
+ �ǥե���ȤϴĶ��ѿ��ǻ��ꤵ�줿�ǥ��쥯�ȥ꡼��TMPDIR,TMP,or
305
+ TEMP�ˤޤ��� '.'�������奢���⡼�ɤǤ� '.' �Τߤ��ǥե���ȤȤ�
306
+ �롣
307
+ * share (true or false) : shared mode ��Ȥ���
308
+
309
+
310
+ �����
311
+ * NetCDF���饹�Υ��֥�������
312
+
313
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
314
+ * nc_create
315
+
316
+ ===���󥹥��󥹥᥽�å�
317
+ ---close
318
+ �ե����륯������
319
+
320
+ ����
321
+ * �ʤ�
322
+
323
+ �����
324
+ * nil
325
+
326
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
327
+ * nc_close
328
+
329
+ ---ndims
330
+ �ե�������μ����ο����֤�
331
+
332
+ ����
333
+ * �ʤ�
334
+
335
+ �����
336
+ * Integer
337
+
338
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
339
+ * nc_inq_ndims
340
+
341
+ ---nvars
342
+ �ե���������ѿ��ο����֤�
343
+
344
+ ����
345
+ * �ʤ�
346
+
347
+ �����
348
+ * Integer
349
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
350
+ * nc_inq_nvars
351
+
352
+ ---natts
353
+ �ե�������Υ������Х�°���ο����֤�
354
+
355
+ ����
356
+ * �ʤ�
357
+
358
+ �����
359
+ * Integer
360
+
361
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
362
+ * nc_inq_natts
363
+
364
+ ---unlimited
365
+ �ե��������unlimited dimension���֤�
366
+
367
+ ����
368
+ * �ʤ�
369
+
370
+ �����
371
+ * ¸�ߤ���Ȥ�NetCDFDim���饹�Υ��֥������ȡ��ʤ��Ȥ���nil
372
+
373
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
374
+ * nc_inq_unlimdim
375
+
376
+ ---path
377
+ �ե�����Υѥ�. open/create����filename��������Ȥ��֤�.
378
+
379
+ ����
380
+ * �ʤ�
381
+
382
+ �����
383
+ * String
384
+
385
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
386
+ * �ʤ�
387
+
388
+ ---redef
389
+ define mode�ˤ��롣���ˤ����ʤ鲿�⤻��nil���֤���
390
+
391
+ ����
392
+ * �ʤ�
393
+
394
+ �����
395
+ * true (����⡼�ɤؤ��ѹ�������);
396
+ nil (��������⡼����).
397
+ ����¾����ͳ���ѹ��Ǥ��ʤ������㳰ȯ��.
398
+
399
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
400
+ * nc_redef
401
+
402
+ ---enddef
403
+ data mode �����롣���ˤ����ʤ鲿�⤻��nil���֤���
404
+
405
+ ����
406
+ * �ʤ�
407
+
408
+ �����
409
+ * true (�ǡ����⡼�ɤؤ��ѹ�������);
410
+ nil (���˥ǡ����⡼����).
411
+ ����¾����ͳ���ѹ��Ǥ��ʤ������㳰ȯ��.
412
+
413
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
414
+ * nc_endef
415
+
416
+ ---define_mode?
417
+ ������⡼�ɤ��ɤ������碌��.
418
+
419
+ ����
420
+ * �ʤ�
421
+
422
+ �����
423
+ * true (������⡼��);
424
+ false (���ǡ����⡼��);
425
+ nil (����¾ -- �ɤ߽Ф����Ѥʤ�).
426
+
427
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
428
+ * nc_redef �� nc_enddef ���Ȥ߹�碌
429
+
430
+ ---sync
431
+ ���꡼��ΥХåե�����ǥ��������ȿ�Ǥ��ƥե������Ʊ��������
432
+
433
+ ����
434
+ * �ʤ�
435
+
436
+ �����
437
+ * nil
438
+
439
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
440
+ * nc_sync
441
+
442
+ ---def_dim(dimension_name, length)
443
+ dimension�����
444
+
445
+ ����
446
+ * dimension_name (String) : �������dimension��̾��
447
+ * length (Integer) : dimension��Ĺ����̵���¼����� 0��
448
+
449
+ �����
450
+ * ������줿���� (NetCDFDim���֥�������)
451
+
452
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
453
+ * nc_def_dim
454
+
455
+ ---put_att(attribute_name, value, atttype=nil)
456
+ �������Х�°��������
457
+
458
+ ����
459
+ * attribute_name (String) : �������Х�°����̾��
460
+ * value (Numeric, String, Array of Numeric, or NArray) : ���ꤹ����
461
+ * atttype (nil or String) : °���η�.
462
+ "char"(="string"),"byte", "sint","int","sfloat", "float" (����
463
+ ����,1,1,2,4,4,8 �Х���)) �ޤ��� nil (�ĤޤꤪǤ��)
464
+
465
+ �����
466
+ * ���ꤵ�줿°�� (NetCDFAtt���֥�������)
467
+
468
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
469
+ * nc_put_att_<type>
470
+
471
+ ---def_var(variable_name, vartype, dimensions)
472
+ �ѿ������
473
+
474
+ ����
475
+ * variable_name (String) : �������variable��̾��
476
+ * vartype (String or Fixnum) : �ѿ��Υ����� ("char", "byte", "sint", "sint", "int",
477
+ "sfloat", "float" �Τ����줫���ޤ���NArray��typecode(Fixnum))
478
+ * dimensions (Array) : variable�μ�����NetCDFDim �� Array���Ǥ�
479
+ ��®�����׼���������٤����׼����ν�ˡ�����Ĺ�����ѿ���
480
+ rank �Ȥʤ롣
481
+
482
+ �����
483
+ * ��������ѿ�(NetCDFVar���֥�������)
484
+
485
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
486
+ * nc_def_var
487
+
488
+ ---def_var_with_dim(variable_name, vartype, shape_ul0, dimnames)
489
+ def_var��Ʊ������ɬ�פʤ�ޤ�������������롣
490
+ ��¸������Ĺ���ȹ��ʤ�����㳰��
491
+
492
+ ����
493
+ * variable_name (String) : �������variable��̾��
494
+ * vartype (String) : �ѿ��Υ����� ("char", "byte", "sint", "sint", "int",
495
+ "sfloat", "float" �Τ����줫)
496
+ * shape_ul0 (Array of Integer) : �ѿ��η���¨�����Ƽ�����Ĺ����̵
497
+ ���¼����ϥ�����ɽ����Ĺ�����ѿ��� rank �Ȥʤ롣
498
+ * dimnames (Array of String) : �Ƽ�����̾��. Ĺ��(=>rank) ��
499
+ shape_ul0 ���������ʤ���Фʤ�ʤ���
500
+
501
+ �����
502
+ * ��������ѿ�(NetCDFVar���֥�������)
503
+
504
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
505
+ * (nc_def_var)
506
+
507
+ ---var(var_name)
508
+ �ե�����˴�¸���ѿ��򥪡��ץ�
509
+
510
+ ����
511
+ * var_name (String) : �����ץ󤹤��ѿ�̾
512
+
513
+ �����
514
+ * NetCDFVar ���饹�Υ��֥������ȡ�¸�ߤ��ʤ���� nil��
515
+
516
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
517
+ * nc_inq_varid
518
+
519
+ ---vars(names = nil)
520
+ �ե���������ѿ���ޤȤ�ƥ����ץ�
521
+
522
+ ����
523
+ * names (nil or Array of String) : �����ץ󤹤��ѿ�̾. nil�ʤ������ʥǥե���ȡ�
524
+
525
+ �����
526
+ * NetCDFVar���֥������Ȥ�Array��names��¸�ߤ��ʤ��ѿ�̾���ޤޤ����㳰ȯ����
527
+
528
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
529
+ * nc_inq_varid
530
+
531
+ ---dim(dimension_name)
532
+ ��¸�μ����򥪡��ץ�
533
+
534
+ ����
535
+ * dimension_name (String) : �����ץ󤹤뼡��̾
536
+
537
+ �����
538
+ * NetCDFDim���饹�Υ��֥������ȡ�¸�ߤ��ʤ���� nil��
539
+
540
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
541
+ * nc_inq_dimid
542
+
543
+ ---dims(names = nil)
544
+ �ե�������μ�����ޤȤ�ƥ����ץ�
545
+
546
+ ����
547
+ * names (nil or Array of String) : �����ץ󤹤뼡��̾. nil�ʤ������ʥǥե���ȡ�
548
+
549
+ �����
550
+ * NetCDFDim���֥������Ȥ�Array��names��¸�ߤ��ʤ�����̾���ޤޤ����㳰ȯ����
551
+
552
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
553
+ * nc_inq_dimid
554
+
555
+ ---att(attribute_name)
556
+ ��¸�Υ������Х�°���򥪡��ץ�
557
+
558
+ ����
559
+ * attribute_name (String) : �����ץ󤹤륰�����Х�°��̾
560
+
561
+ �����
562
+ * ¸�ߤ���� NetCDFAtt���饹�Υ��֥������ȡ�¸�ߤ��ʤ����nil
563
+
564
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
565
+ * (nc_inq_attid�򸡺�������)
566
+
567
+ ---fill=(filemode)
568
+ fillmode���ѹ���(NetCDF �Υǥե���Ȥ� FILL �Ǥ��롣)
569
+
570
+ ����
571
+ * fillmode (true for FILL or false for NOFILL)
572
+
573
+ �����
574
+ * nil
575
+
576
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
577
+ * nc_set_fill
578
+
579
+ ---each_dim{ ... }
580
+ �����˴ؤ��륤�ƥ졼��.
581
+ ��: {|i| print i.name,"\n"} ����������̾����ɽ��.
582
+
583
+ ����
584
+ * { ... } : ���ƥ졼�����ѥ֥��å���do end�֥��å��Ǥ�褤��
585
+
586
+ �����
587
+ * self
588
+
589
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
590
+ * (nc_inq_ndims������)
591
+
592
+ ---each_var{ ... }
593
+ �ѿ��˴ؤ��륤�ƥ졼��.
594
+ ��: {|i| print i.name,"\n"} �����ѿ���̾����ɽ��.
595
+
596
+ ����
597
+ * { ... } : ���ƥ졼�����ѥ֥��å���do end�֥��å��Ǥ�褤��
598
+
599
+ �����
600
+ * self
601
+
602
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
603
+ * (nc_inq_nvars������)
604
+
605
+ ---each_att{ ... }
606
+ �������Х�°���˴ؤ��륤�ƥ졼��.
607
+ ��: {|i| print i.name,"\n"} ����°����̾����ɽ��.
608
+
609
+ ����
610
+ * { ... } : ���ƥ졼�����ѥ֥��å���do end�֥��å��Ǥ�褤��
611
+
612
+ �����
613
+ * self
614
+
615
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
616
+ * (nc_inq_natts, nc_inq_attname������)
617
+
618
+ ---dim_names
619
+ �ե����������������̾���������������֤���
620
+
621
+ ����
622
+ * �ʤ�
623
+
624
+ �����
625
+ * String �� Array
626
+
627
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
628
+ * (nc_inq_ndims, nc_inq_dimname������)
629
+
630
+ ---var_names
631
+ �ե�����������ѿ���̾���������������֤���
632
+
633
+ ����
634
+ * �ʤ�
635
+
636
+ �����
637
+ * String �� Array
638
+
639
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
640
+ * (nc_inq_nvars, nc_inq_varname������)
641
+
642
+ ---att_names
643
+ �ե�����������������Х�°����̾���������������֤���
644
+ ����
645
+ * �ʤ�
646
+
647
+ �����
648
+ * String �� Array
649
+
650
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
651
+ * (nc_inq_natts, nc_inq_attname������)
652
+
653
+ ---------------------------------------------
654
+
655
+ =���饹 NetCDFDim
656
+ ===���饹�᥽�å�
657
+
658
+ ===���󥹥��󥹥᥽�å�
659
+ ---length
660
+ ������Ĺ�����֤�
661
+
662
+ ����
663
+ * �ʤ�
664
+
665
+ �����
666
+ * Integer
667
+
668
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
669
+ * nc_inq_dimlen
670
+
671
+ ---length_ul0
672
+ length ��Ʊ��������̵���¼����˴ؤ��������֤�
673
+
674
+ ����
675
+ * �ʤ�
676
+
677
+ �����
678
+ * Integer
679
+
680
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
681
+ * nc_inq_dimlen
682
+
683
+ ---name=(dimension_newname)
684
+ ̾����Ĥ�������
685
+
686
+ ����
687
+ * dimension_newname (String) : ������̾��
688
+
689
+ �����
690
+ * nil
691
+
692
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
693
+ * nc_rename_dim
694
+
695
+ ---name
696
+ ̾�����֤�
697
+
698
+ ����
699
+ * �ʤ�
700
+
701
+ �����
702
+ * String
703
+
704
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
705
+ * nc_inq_dimname
706
+
707
+ ---unlimited?
708
+ ̵���¼������ɤ�����
709
+
710
+ ����
711
+ * �ʤ�
712
+
713
+ �����
714
+ * true or false
715
+
716
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
717
+ * (nc_inq_unlimdim ������)
718
+
719
+ ---------------------------------------------
720
+
721
+ =���饹 NetCDFVar
722
+ ===���饹�᥽�å�
723
+ ---NetCDFVar.new(file,varname,mode="r",share=false)
724
+ NetCDF�ѿ��򥪡��ץ󤹤롣����ϡ�NetCDF#var (NetCDF���饹�Υ���
725
+ �����󥹥᥽�å�var) ��ȤäƤ����뤷��������Τۤ���侩���롣
726
+
727
+ ����
728
+ * file (NetCDF or String) : NetCDF���֥�������(NetCDF)
729
+ �ޤ��� NetCDF �ե�����Υѥ�(String)
730
+ * varname (String) : file����ѿ�̾
731
+ * mode (String) : �����ϥ⡼�ɡ�file�� String �λ��˻Ȥ��롣
732
+ ��NetCDF.open�ι�򸫤��
733
+ * share (true or false) : shared�⡼�ɤˤ��뤫��
734
+ file�� String �λ��˻Ȥ��롣��NetCDF.open�ι�򸫤��
735
+
736
+ �����
737
+ * NetCDFVar���饹�Υ��֥�������
738
+
739
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
740
+ * (nc_open, nc_create, nc_inq_varid �������Ѥ���)
741
+
742
+ ---NetCDFVar.unpack_type=(na_type)
743
+ ((<scaled_get>))�ǻȤ�NArray�η�����ꤹ��.
744
+
745
+ ����
746
+ * na_type (Integer) : NArray::BYTE, NArray::SINT, NArray::INT,
747
+ NArray::SFLOAT, or NArray::FLOAT
748
+
749
+ �����
750
+ * na_type (����)
751
+
752
+ ---NetCDFVar.unpack_type
753
+ ((<NetCDFVar.unpack_type=>))�����ꤷ��NArray�η����֤�.
754
+
755
+ �����
756
+ * nil, NArray::BYTE, NArray::SINT, NArray::INT,
757
+ NArray::SFLOAT, or NArray::FLOAT
758
+
759
+ ===���󥹥��󥹥᥽�å�
760
+ ---dim(dim_num)
761
+ �����ѿ��ˤ����� dim_num ����(0���������)�μ��������碌�롣
762
+
763
+ ����
764
+ * dim_num (Fixnum) : 0,1,2,...���Ǥ�®����뼡����0��
765
+
766
+ �����
767
+ * NetCDFDim���֥�������
768
+
769
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
770
+ * (nc_inq_vardimid����)
771
+
772
+ ---dims
773
+ �����ѿ���������������ˤ�����֤�
774
+
775
+ ����
776
+ * �ʤ�
777
+
778
+ �����
779
+ * NetCDFDim���֥������Ȥ�Array
780
+
781
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
782
+ * nc_inq_vardimid
783
+
784
+ ---shape_ul0
785
+ �ѿ��η����֤�. â��̵���¼�����Ĺ���ϥ���.
786
+ ¾���ѿ������������.
787
+
788
+ ����
789
+ * �ʤ�
790
+
791
+ �����
792
+ * Array. [0�����ܤ�Ĺ��, 1�����ܤ�Ĺ��,.. ]
793
+
794
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
795
+ * (nc_inq_vardimid, nc_inq_unlimdim ��������)
796
+
797
+ ---shape_current
798
+ �ѿ��θ��ߤη����֤�.
799
+
800
+ ����
801
+ * �ʤ�
802
+
803
+ �����
804
+ * Array. [0�����ܤ�Ĺ��, 1�����ܤ�Ĺ��,.. ]
805
+
806
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
807
+ * (nc_inq_vardimid ��������)
808
+
809
+ ---each_att{ ... }
810
+ �ѿ������°��(NetCDFAtt)�˴ؤ��륤�ƥ졼��
811
+
812
+ ����
813
+ * { ... } : �����֤��֥��å�
814
+
815
+ �����
816
+ * self
817
+
818
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
819
+ * (nc_inq_natts, nc_inq_attname������)
820
+
821
+ ---dim_names
822
+ �ѿ������������̾���������������֤���
823
+
824
+ ����
825
+ * �ʤ�
826
+
827
+ �����
828
+ * String �� Array
829
+
830
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
831
+ * (nc_inq_varndims, nc_inq_vardimid, nc_inq_dimname ������)
832
+
833
+ ---att_names
834
+ �ѿ������°����̾���������������֤���
835
+
836
+ ����
837
+ * �ʤ�
838
+
839
+ �����
840
+ * String �� Array
841
+
842
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
843
+ * (nc_inq_natts, nc_inq_attname������)
844
+
845
+ ---name
846
+ �ѿ���̾�����֤�
847
+
848
+ ����
849
+ * �ʤ�
850
+
851
+ �����
852
+ * String
853
+
854
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
855
+ * nc_inq_varname
856
+
857
+ ---name=(variable_newname)
858
+ ̾�����դ��ؤ���
859
+
860
+ ����
861
+ * variable_newname (String) : ������̾��
862
+
863
+ �����
864
+ * nil
865
+
866
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
867
+ * nc_rename_var
868
+
869
+ ---ndims
870
+ �����ο����䤦
871
+
872
+ ����
873
+ * �ʤ�
874
+
875
+ �����
876
+ * Integer
877
+
878
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
879
+ * nc_inq_varndims
880
+
881
+ ---rank
882
+ ndims�Υ��ꥢ��
883
+
884
+ ---ntype
885
+ vartype����̾
886
+
887
+ ---vartype
888
+ �ѿ��ͤη����䤦
889
+
890
+ ����
891
+ * �ʤ�
892
+
893
+ �����
894
+ * String ("char","byte","sint","int","sfloat", or "float")
895
+
896
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
897
+ * nc_inq_vartype
898
+
899
+ ---typecode
900
+ �ѿ��ͤη����䤦(NArray��typecode���֤�)
901
+
902
+ ����
903
+ * �ʤ�
904
+
905
+ �����
906
+ * Fixnum���֥������� (NArray:BYTE, NArray:SINT, NArray:LINT, NArray:SFLOAT, NArray:SFLOAT, NArray:DFLOAT)
907
+
908
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
909
+ * nc_inq_vartype
910
+
911
+ ---natts
912
+ °���ο����䤦
913
+
914
+ ����
915
+ * �ʤ�
916
+
917
+ �����
918
+ * Integer
919
+
920
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
921
+ * nc_inq_varnatts
922
+
923
+ ---file
924
+ �����ѿ���°����ե���������碌��
925
+
926
+ ����
927
+ * �ʤ�
928
+
929
+ �����
930
+ * NetCDF���饹�Υ��֥�������
931
+
932
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
933
+ * �ʤ�
934
+
935
+ ---att(attribute_name)
936
+ ̾������ꤷ��°�����֤�
937
+
938
+ ����
939
+ * attribute_name (String) : ���Ф�°��̾
940
+
941
+ �����
942
+ * NetCDFAtt���֥�������. ¸�ߤ��ʤ����nil
943
+
944
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
945
+ * (nc_inq_attid�򸡺�������)
946
+
947
+ ---put_att(attribute_name, value, atttype=nil)
948
+ °��������
949
+
950
+ ����
951
+ * attribute_name (String) : attribute̾
952
+ * value (Numeric, String, Array of Numeric, or NArray) : ���ꤹ����
953
+ * atttype (nil or String) : °���η�.
954
+ "char"(="string"),"byte", "sint","int","sfloat", "float" (����
955
+ ����,1,1,2,4,4,8 �Х���)) �ޤ��� nil (�ĤޤꤪǤ��)
956
+
957
+ �����
958
+ * NetCDFAtt�Υ��֥�������
959
+
960
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
961
+ * nc_put_att_<type>
962
+
963
+ ---put(value, option=nil)
964
+ ((<simple_put>))����̾(alias)
965
+
966
+ ---simple_put(value, option=nil)
967
+ �ͤ������
968
+
969
+ ����
970
+ * value : ������� (Numeric,Array(Numeric��1��������)��NArray)
971
+ �����顼(Numeric)�ޤ���Ĺ�����ξ��ϡ������ͤ���ͤ����ꤹ�롣
972
+ * option (Hash) : �ѿ��ΰ���ʬ����ꤹ�뤿��Υ��ץ�����������
973
+ ά����С��ѿ����Τ��оݤȤʤ롣�ϥå���Υ����Ȥ��Ƥϡ�
974
+ "start","end","stride"���ȡ��ޤ���"index"�����ѤǤ��롣"index"
975
+ ��1���ǡʥ����顼�ˤ�ؤ���"end","stride"�Ͼ�ά�ġ���ά����ˤ�
976
+ �����ʤ��ˤ������񤭤���٤����Ǥο��� value�Τ���Ȱ��פ���褦�ˤ�
977
+ �ʤ���Фʤ�ʤ���start,end,index�Ǥ�Array�ξ���Ʊ�͡�����ͤǸ��
978
+ ����ΰ��֤����Ǥ��롣"stride"�������ͤΤ߼����դ���Τǡ���
979
+ �����ä����֤�������и夫�����Ӥ�뤳�Ȥˤʤ롣
980
+
981
+ �㡧 �ѿ���2�����ξ��:
982
+
983
+ {"start"=>[2,5],"end"=>[6,-1],"stride"=>[2,4]} -- ��1�����ܤϡ�
984
+ ���� 2 ���� 6 �ޤ� 1 �Ĥ��� (0���������Τ����� 2 �� 3 ���ܤǤ�
985
+ �뤳�Ȥ�����)����2�����ܤϡ����� 6 ���� �Ǹ�(=-1)�ޤ� 3 �Ĥ���
986
+ �ˤȤä����֥��åȡ�
987
+
988
+ {"index"=>[0,0]}: �ǽ�����Ǥˤ���
989
+ �륹���顼��
990
+
991
+ {"index"=>[0,-2]}: 1�����ܤϺǽ�, 2�����ܤϺǸ夫��2���ܤˤ���
992
+ �륹���顼��
993
+
994
+ �����
995
+ * nil
996
+
997
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
998
+ * nc_put_var_<type>, nc_put_vars_<type>, nc_put_var1_<type>
999
+
1000
+ ---pack(na)
1001
+ self��°�� scale_factor and/or add_offset ���Ѥ��� NArray ���� "pack" ����.
1002
+
1003
+ �⤷�� scale_factor and/or add_offset �����ꤵ��Ƥ����
1004
+ (na-add_offset)/scale_factor ���֤��������Ǥʤ���� na ���֤���
1005
+
1006
+ ����
1007
+ * na : pack ����������� (NArray, NArrayMiss, Array)
1008
+
1009
+ �����
1010
+ * a NArray or NArrayMiss
1011
+
1012
+ ---scaled_put(value, option=nil)
1013
+ ((<simple_put>)) ��Ʊ�ͤ�����((<pack>))�ˤ��°�� scale_factor �� add_offset ���᤹��
1014
+
1015
+ �������ˤĤ��Ƥ� put �β���򻲾ȤΤ���
1016
+
1017
+ ---get(option=nil)
1018
+ ((<simple_get>))����̾(alias)
1019
+
1020
+ ---simple_get(option=nil)
1021
+ �ͤ���Ф�
1022
+
1023
+ ����
1024
+ * option (Hash) : �ѿ��ΰ���ʬ����ꤹ�뤿��Υ��ץ�����������
1025
+ �ͤ� put ��Ʊ����
1026
+
1027
+ �����
1028
+ * NArray���饹�Υ��֥�������
1029
+
1030
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1031
+ * nc_get_var_<type>, nc_get_vars_<type>, nc_get_var1_<type>
1032
+
1033
+ ---unpack(na)
1034
+ self��°�� scale_factor and/or add_offset ���Ѥ��� NArray ���� "unpack" ����.
1035
+
1036
+ �⤷�� scale_factor and/or add_offset �����ꤵ��Ƥ����
1037
+ na * scale_factor + add_offset ���֤��������Ǥʤ���� na ���֤���
1038
+ coerce �ˤ�äƷ����Ѳ����� -- �㤨�С��⤷ na �� sint ��
1039
+ scale_factor �� add_offset �� sfloat �Ǥ���С��֤��ͤ� sfloat
1040
+ �ˤʤ롣�֤��ͤη��� ((<NetCDFVar.unpack_type=>)) ��Ȥä�
1041
+ �ۤ˻��ꤹ�뤳�Ȥ�Ǥ��롣
1042
+
1043
+ ����
1044
+ * na : unpack ����������� (NArray, or NArrayMiss)
1045
+
1046
+ �����
1047
+ * a NArray or NArrayMiss
1048
+
1049
+
1050
+ ---scaled_get(option=nil)
1051
+ ((<simple_get>)) ��Ʊ�ͤ�����((<unpack>))�ˤ��°�� scale_factor �� add_offset ���᤹��
1052
+
1053
+ �������ˤĤ��Ƥ� put �β���򻲾ȤΤ���
1054
+
1055
+ ---[]
1056
+ NetCDFVar#get ��Ʊ�ͤ��������֥��åȤ� NArray#[] ��Ʊ�ͤ˻��ꤹ��.
1057
+
1058
+ NArray�ǥ��ݡ��Ȥ���Ƥ��륵�֥��åȻ�����ˡ�˲ä��ơ����ƥå���
1059
+ �����ϰϤ����Ǥ��롣����� {0..-1,2} �ʤɤȤ��롣�Ĥޤꡢ����
1060
+ �������Υϥå���Υ������ϰ�(Range)���ͤ˥��ƥå�(Integer)�����
1061
+ ���롣NArray�Ȱ㤤���������ʾ���ѿ��򣱼����Υ���ǥå�����
1062
+ ���ꤹ�뤳�ȤϽ���ʤ���
1063
+
1064
+ ---[]=
1065
+ NetCDFVar#put ��Ʊ�ͤ��������֥��åȤ� NArray#[]= ��Ʊ�ͤ˻��ꤹ��.
1066
+
1067
+ NArray�ǥ��ݡ��Ȥ���Ƥ��륵�֥��åȻ�����ˡ�˲ä��ơ����ƥå���
1068
+ �����ϰϤ����Ǥ��롣����� {0..-1,2} �ʤɤȤ��롣�Ĥޤꡢ����
1069
+ �������Υϥå���Υ������ϰ�(Range)���ͤ˥��ƥå�(Integer)�����
1070
+ ���롣NArray�Ȱ㤤���������ʾ���ѿ��򣱼����Υ���ǥå�����
1071
+ ���ꤹ�뤳�ȤϽ���ʤ���
1072
+
1073
+ ==="numru/netcdf_miss" �� require ���뤳�Ȥ��ɲä���륤�󥹥��󥹥᥽�å�
1074
+
1075
+ ---get_with_miss(option=nil)
1076
+ ((<get>))��Ʊ�ͤ������ǡ�����»���������
1077
+
1078
+ �ǡ�����»��ɸ��°�� valid_range, (valid_min and/or valid_max),
1079
+ �ޤ��� missing_value �ˤ����ꤵ��롣����ͥ���̤Ϥ��ν��֤�
1080
+ ���롣�֥桼�����������ɡפο侩�Ȱ㤤�������Ǥ� missin_value ��
1081
+ ��ᤵ��롣�⤷ missing_value �� valid_* ��Ʊ����¸�ߤ����硢
1082
+ missng_value ��ͭ���ǡ����ϰϳ��ˤ��äƤϤʤ�ʤ������ξ�硢�㳰
1083
+ ��ȯ�����롣
1084
+
1085
+ �嵭�Τ褦�ˤ⤷�ǡ�����»�ʤλ����ˤ����ꤵ��Ƥ���С����Υ᥽��
1086
+ �ɤ� NArrayMiss ���֥������Ȥ��֤��������Ǥʤ���� NArray ���֤���
1087
+
1088
+ ����
1089
+ * ((<get>))�򸫤�.
1090
+
1091
+ �����
1092
+ * NArrayMiss���֥������� (�ǡ�����»�����ꤵ�Ƥ�����) �ޤ��� NArray
1093
+ ���֥������� (�ǡ�����»�����ꤵ�Ƥʤ����)
1094
+
1095
+ NetcdfError �ʳ����㳰ȯ��
1096
+ * missing_value ���ǡ���ͭ���ϰϤˤʤ� (�嵭���ȤΤ���).
1097
+
1098
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1099
+ * ((<get>)) �򸫤�. ���Υ᥽�åɤ� Ruby �Τߤǽ񤫤�Ƥ���.
1100
+
1101
+ ��
1102
+ * ������Ǥ� ((<get>)) �� ((<get_with_miss>)) ���֤������Ƥ���.
1103
+ ��������� ((<[]>)) ��ǡ�����»���᤹��褦�ˤʤ� (������
1104
+ (({get})) ��Ƥ�Ǥ�Τ�).
1105
+
1106
+ file = NetCDF.open('hogehoge.nc')
1107
+ var = file.var('var')
1108
+ def var.get(*args); get_with_miss(*args); end
1109
+ p var.get # --> inteprets data missing if defined
1110
+ p var[0..-1,0] # --> inteprets data missing if defined (assumed 2D)
1111
+
1112
+
1113
+ ---get_with_miss_and_scaling(option=nil)
1114
+ ((<get_with_miss>))��Ʊ�ͤ�����((<unpack>))�ˤ�ꥹ������󥰤�Ԥ�.
1115
+
1116
+ ��»�ͽ����ϴ���Ū�ˤ� pack �����ǡ������оݤ˹Ԥ�(�����¿����
1117
+ ����٥󥷥����Ѥ���Ƥ���)����������valid_* / missing_value
1118
+ �η��� pack �����ǡ����η��Ȱۤʤꡢ���� unpack�����ǡ����η���
1119
+ ���פ���Ȥ��ʤ˸¤�� unpack �����ǡ������оݤȤ��롣
1120
+ ����Ǵ���Ū�����ƤΥ���٥󥷥����б��Ǥ��롣
1121
+
1122
+ ��
1123
+ * �嵭���ȡ�Ʊ�����Ȥ��Ǥ��롣
1124
+
1125
+ ---put_with_miss(value, option=nil)
1126
+ ((<put>))��Ʊ�ͤ������ǡ�����»���������
1127
+
1128
+ �⤷�� (({value})) �� NArray �ʤ顢���Υ᥽�åɤ� ((<put>)) ��Ʊ
1129
+ ��. �⤷(({value})) �� NArrayMiss �Ǥ��� self ��°���ˤ��ǡ�����»��
1130
+ �������Ƥ���� (((<get_with_miss>))�򻲾ȤΤ���)��(({value}))
1131
+ ��Υǡ�����»����ᤵ��롣¨����(({value}))��η�»�ǡ����ϡ�
1132
+ �����»�� (missing_value �ޤ��� _FillValue �ޤ��ϥǡ���ͭ���ϰ�
1133
+ ����Ŭ������) ���֤�������줿��ǥե�����˽񤭹��ޤ�롣
1134
+ (({value})) ������»�ǡ����� (({self})) �ˤ�����ͭ���ϰϤ����ä�
1135
+ ���뤫�ɤ����ϥ����å�����ʤ���
1136
+
1137
+ ����
1138
+ * value : NArrayMiss �ޤ��� ((<put>)) �ǵ�����Ƥ��륯�饹�Υ��֥�������.
1139
+ * option (Hash) : ((<put>)) �򸫤�.
1140
+
1141
+ �����
1142
+ * nil
1143
+
1144
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1145
+ * ((<put>)) �򸫤�. ���Υ᥽�åɤ� Ruby �Τߤǽ񤫤�Ƥ���.
1146
+
1147
+ ��
1148
+ * ������Ǥ� ((<put>)) �� ((<put_with_miss>)) ���֤������Ƥ���.
1149
+ ��������� ((<[]=>)) ��ǡ�����»���᤹��褦�ˤʤ� (������
1150
+ (({put})) ��Ƥ�Ǥ�Τ�).
1151
+
1152
+ file = NetCDF.open('hogehoge.nc')
1153
+ var = file.var('var')
1154
+ def var.put(*args); put_with_miss(*args); end
1155
+ var.put = narray_miss # --> inteprets data missing if defined
1156
+ var[0..-1,0] = narray_miss # --> inteprets data missing if defined (assumed 2D)
1157
+
1158
+ ---put_with_miss_and_scaling(value, option=nil)
1159
+ ((<put_with_miss>))��Ʊ�ͤ�����((<pack>))�ˤ�ꥹ������󥰤�Ԥ�.
1160
+
1161
+ ��»�ͽ����ϴ���Ū�ˤ� pack �����ǡ������оݤ˹Ԥ�(�����¿����
1162
+ ����٥󥷥����Ѥ���Ƥ���)����������valid_* / missing_value
1163
+ �η��� pack �����ǡ����η��Ȱۤʤꡢ���� unpack�����ǡ����η���
1164
+ ���פ���Ȥ��ʤ˸¤�� unpack �����ǡ������оݤȤ��롣
1165
+ ����Ǵ���Ū�����ƤΥ���٥󥷥����б��Ǥ��롣
1166
+
1167
+ ��
1168
+ * �嵭���ȡ�Ʊ�����Ȥ��Ǥ��롣
1169
+
1170
+ ---------------------------------------------
1171
+
1172
+ =���饹 NetCDFAtt
1173
+ ===���饹�᥽�å�
1174
+
1175
+ ===���󥹥��󥹥᥽�å�
1176
+ ---name
1177
+ °����̾�����֤�
1178
+
1179
+ ����
1180
+ * �ʤ�
1181
+
1182
+ �����
1183
+ * String
1184
+
1185
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1186
+ * �ʤ�
1187
+
1188
+ ---name=(attribute_newname)
1189
+ °����̾�����ѹ�
1190
+
1191
+ ����
1192
+ * attribute_newname (String) : ������̾��
1193
+
1194
+ �����
1195
+ * nil
1196
+
1197
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1198
+ * nc_rename_att
1199
+
1200
+ ---copy(var_or_file)
1201
+ °�����̤��ѿ��ޤ��ϥե�����˥��ԡ����ե�����ξ��ϥ������Х�°���ˤʤ�
1202
+
1203
+ ����
1204
+ * var_or_file (NetCDFVar or NetCDF)
1205
+
1206
+ �����
1207
+ * ���ԡ����ƺ��줿°�� (NetCDFAtt)
1208
+
1209
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1210
+ * nc_copy_att
1211
+
1212
+ ---delete
1213
+ °������
1214
+
1215
+ ����
1216
+ * �ʤ�
1217
+
1218
+ �����
1219
+ * nil
1220
+
1221
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1222
+ * nc_del_att
1223
+
1224
+ ---put(value, atttype=nil)
1225
+ °�����ͤ�����
1226
+
1227
+ ����
1228
+ * value (Numeric, String, Array of Numeric, or NArray) : �������
1229
+ * atttype (nil or String) : °���η�.
1230
+ "char"(="string"),"byte", "sint","int","sfloat", "float" (����
1231
+ ����,1,1,2,4,4,8 �Х���)) �ޤ��� nil (�ĤޤꤪǤ��)
1232
+
1233
+ �����
1234
+ * nil
1235
+
1236
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1237
+ * nc_put_att_<type>
1238
+
1239
+ ---get
1240
+ °������Ȥ���Ф�
1241
+
1242
+ ����
1243
+ * �ʤ�
1244
+
1245
+ �����
1246
+ * ʸ����ޤ���NArray���֥������� (����: �����顼�ξ���Ĺ��1��
1247
+ NArray�ˤʤ�)
1248
+
1249
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1250
+ * nc_get_att_<type>
1251
+
1252
+ ---atttype
1253
+ °���ͤη����䤦
1254
+
1255
+ ����
1256
+ * �ʤ�
1257
+
1258
+ �����
1259
+ * "char","byte","sint","int","sfloat","float"
1260
+
1261
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1262
+ * nc_inq_atttype
1263
+
1264
+ ---typecode
1265
+ °���ͤη����䤦(NArray��typecode���֤�)
1266
+
1267
+ ����
1268
+ * �ʤ�
1269
+
1270
+ �����
1271
+ * Fixnum���֥������� (NArray:BYTE, NArray:SINT, NArray:LINT, NArray:SFLOAT, NArray:SFLOAT, NArray:DFLOAT)
1272
+
1273
+ �б�����(���Ѥ���) C �� NetCDF �δؿ�
1274
+ * nc_inq_atttype
1275
+
1276
+ =end