=begin
=RubyNetCDF ե󥹥ޥ˥奢

* ((<᥽åɥǥå>))

---------------------------------------------

==

RubyNetCDF  NetCDF 饤֥꡼ Ruby 󥿡եǤ롣Ruby 
ϥե꡼ʥ֥ȻظץȸǤꡢ
((<|URL:http://www.ruby-lang.org/>))
Ǥ롣RubyNetCDF ϿȤơ
Ruby ǰŪ˻ȤƤ¿饤֥꡼ 
((<NArray|URL:http://www.ruby-lang.org/en/raa-list.rhtml?name=NArray>)) 
ѤΤǡ餫ᥤ󥹥ȡ뤷Ƥɬפ롣
NArray ϥǡC Υݥ󥿡ؤϢ³꡼ΰ
ݻ׻񸻤Ψ褯Ѥ롣NArray  Python ˤ 
NumPy Ȼ뤬ĤΥƥȤ NArray Τۤ NumPy Ψɤ
Ȥ򼨺Ƥ롣
ץȤơRubyNetCDF ϥǡ»μưŪʼ갷᥽åɤ
󶡤롣Ȥˤϡ
((<NArrayMiss|URL:http://ruby.gfd-dennou.org/products/narray_miss/>)) 
ɬפǤ롣ܤ((<ˡ>))򸫤衣

===

RubyNetCDF ϰʲΣĤΥ饹鹽롣

* ((<饹 NetCDF>)) -- եΥ饹

  ĤNetCDF饹Υ֥ȤϰĤ NetCDF եб

* ((<饹 NetCDFDim>)) -- Υ饹

  C  NetCDF ǤϡϡեIDȼIDȤѿȤɽ뤬
  Ruby ǤǤϰĤ NetCDFDim ֥Ȥɽ

* ((<饹 NetCDFVar>)) -- ѿΥ饹

  C  NetCDF ǤϡѿϡեIDѿIDȤѿȤɽ뤬
  Ruby ǤǤϰĤ NetCDFVar ֥Ȥɽ

* ((<饹 NetCDFAtt>)) -- °Υ饹

  C  NetCDF Ǥϡ°ϡեIDѿID°̾Ȥɽ뤬
  Ruby ǤǤϰĤ NetCDFAtt ֥Ȥɽ

===ǡ

ܥ饤֥꡼ǤƤ NetCDF ѿη char, byte, short, int,
float, double ݡȤƤ롣 Ruby Ρʤ
˸ NArray Ρ˴˽äơ줾 "char", "byte", "sint",
"int", "sfloat", "float" ȸƤФ롣äơNetCDFVar 饹 vartype
(=ntype) ϤʸΰĤ֤ޤNetCDF饹 def_var 
åɤϡѿݡդ롣äդɬפ
Τϡܥ饤֥꡼Ǥ "float"  C ǸȤ double ̣
ȤȤǤ롣 Ruby δΤǤ -- Ȥ߹ߤ Float 
饹ϡC  float Ǥʤ double бΤǤ롣

NetCDFVar 饹 get ᥽åɤϥեƱ NArray ѿ
ɤ߹ब"char" ѿˤĤƤ "byte"  NArray ɤ߹ޤ롣
 NArray  "char" ʤǤ롣⤽ NArray 
 byte ʸñ˰ΤǡäԹϤʤȹͤ롣

===顼

顼ϴŪˤ㳰ȯ뤳Ȥˤн褹롣â֤ͤ᥽
ɤǤϷʥ顼 nil ֤Ȥн褹°ͤ뤿˻
줿̾°¸ߤʤȤʤɡˡ㳰Ūʾ nil ȯ
᥽åɤˤĤƤϥޥ˥奢Ƥ롣

===ƥ

Ȥ߹ߤ File 饹Ʊƥб򤷤ƤƤ롣

===ˡ

RubyNetCDF饤֥꡼Ѥ뤿ˤϡޤιԤ Ruby ץ˽
ƥ饤֥꡼ɤɬפ롣

   require 'numru/netcdf'

⤷ (NetCDFVar饹) ưŪʥǡ»᥽åɤȤ
ϡʲ¹Ԥɬפ롣

   require 'numru/netcdf_miss'

ǰֺǽ (({require 'numru/netcdf'})) ¹ԤΤǡ
Ƥ٤ɤǡ»ΰ
((<NArrayMiss|URL:http://ruby.gfd-dennou.org/products/narray_miss/>))
ˤΤǡ򥤥󥹥ȡ뤷ƤͤФʤʤ
⤷ (({require 'numru/netcdf'})) Ƥ֤Τʤ顢NArrayMiss
פǤ롣

ǡ'numru' ("Numerical Ruby"줿) ϥ桼Υ饤֥꡼
ɥѥΥ֥ǥ쥯ȥ꡼ǡRubyNetCDF 饤֥꡼֤롣
ȡʲΤ褦ѤǤ褦ˤʤ롣

   file = NumRu::NetCDF.create('tmp.nc')
   x = file.def_dim('x',10)
   y = file.def_dim('y',10)
   v = file.def_var('v','float',[x,y])
   file.close

ǡNumRu ϤΥ饤֥꡼ޤ⥸塼Ǥ롣Τ褦ʥ⥸塼
ˤǤΤϡ֤̾Ǥξͤ򤱤뤿Ǥ롣Τ褦ʰ
򤷤ʤ硢⤷桼ܥ饤֥꡼Υ饹̾
륯饹⥸塼ޤ饤֥꡼ȤȤȡ꤬롣

Τ褦꤬ʤǤϡ"NumRu::" ȤϡNumRu
⥸塼֥󥯥롼ɡפ뤳ȤdzʸߤΥפˤƤ
ǤˡäƼΤ褦˽񤱤롣

   include NumRu
   file = NetCDF.create('tmp.nc')
   ...

ʤȤƤϥѥѥå˴ޤޤ demo  test 
ץ򻲾Ȥ衣


---------------------------------------------

==ޥ˥奢θ

--- ᥽å̾(1, 2, ...)  -- άǽʰ ̾=ǥե ηǼ

     ǽβ

     
     * 1̾ (Υ饹ޤϼ): 
     * 2̾ (Υ饹ޤϼ): 
     * ...

     
     * ͤ

     б(Ѥ) C  NetCDF δؿ
     * NetCDF ver 3 δؿ̤̾ʤ硢δؿƱεǽͭ
       뤳Ȥ򼨤ľŪбʤ硢˰¸ؿ󤲤롣

---------------------------------------------

==᥽åɥǥå
* ((<饹 NetCDF>))

  饹᥽å
    * ((<NetCDF.open>))     ե륪ץʥ饹᥽åɡmode="w" ǥե뤬¸ߤʤп
    * ((<NetCDF.new>))     NetCDF.open᥽åɤΥꥢǤ
    * ((<NetCDF.create>))     NetCDFեʥ饹᥽å)
    * ((<NetCDF.create_tmp>))     ƥݥ꡼NetCDFեʥ饹᥽å)

  󥹥󥹥᥽å
    * ((<close>))     ե륯
    * ((<ndims>))     եμο֤
    * ((<nvars>))     եѿο֤
    * ((<natts>))     եΥХ°ο֤
    * ((<unlimited>))     եunlimited dimension֤
    * ((<path>))     եΥѥ. open/createfilenameȤ֤.
    * ((<redef>))     define modeˤ롣ˤʤ鲿⤻nil֤
    * ((<enddef>))     data mode 롣ˤʤ鲿⤻nil֤
    * ((<define_mode?>))     ⡼ɤɤ碌.
    * ((<sync>))     ꡼ΥХåեǥȿǤƥեƱ
    * ((<def_dim>))     dimension
    * ((<put_att>))     Х°
    * ((<def_var>))     ѿ
    * ((<def_var_with_dim>))     def_varƱɬפʤޤ롣
    * ((<var>))     ե˴¸ѿ򥪡ץ
    * ((<vars>))    ե˴¸ѿޤȤƥץ
    * ((<dim>))     ¸μ򥪡ץ
    * ((<dims>))    ¸μޤȤƥץ
    * ((<att>))     ¸ΥХ°򥪡ץ
    * ((<fill=>))     fillmodeѹ(NetCDF ΥǥեȤ FILL Ǥ롣)
    * ((<each_dim>))     ˴ؤ륤ƥ졼. 
    * ((<each_var>))     ѿ˴ؤ륤ƥ졼. 
    * ((<each_att>))     Х°˴ؤ륤ƥ졼. 
    * ((<dim_names>))     ե֤̾
    * ((<var_names>))     եѿ֤̾
    * ((<att_names>))     եХ°֤̾

* ((<饹 NetCDFDim>))

  饹᥽å

  󥹥󥹥᥽å
    * ((<length>))     Ĺ֤
    * ((<length_ul0>))     length Ʊ̵¼˴ؤ֤
    * ((<name=>))     ̾Ĥ
    * ((<name>))     ֤̾
    * ((<unlimited?>))     ̵¼ɤ

* ((<饹 NetCDFVar>))

  饹᥽å
    * ((<NetCDFVar.new>))     NetCDF.open  NetCDF#Var Ȥ߹碌ưԤǺѤޤ(Ȥʤɤ).
    * ((<NetCDFVar.unpack_type=>))    ((<unpack>))ǻȤNArrayηꤹ
    * ((<NetCDFVar.unpack_type>))    ((<NetCDFVar.unpack_type=>))ꤷNArrayη֤


  󥹥󥹥᥽å
    * ((<dim>))     ѿˤ dim_num (0)μ碌롣
    * ((<dims>))     ѿˤ֤
    * ((<shape_ul0>))     ѿη֤. â̵¼Ĺϥ.
    * ((<shape_current>))     ѿθߤη֤.
    * ((<each_att>))     ѿ°(NetCDFAtt)˴ؤ륤ƥ졼
    * ((<dim_names>))     ѿ֤̾
    * ((<att_names>))     ѿ°֤̾
    * ((<name>))     ѿ֤̾
    * ((<name=>))     ̾դؤ
    * ((<ndims>))     ο䤦
    * ((<rank>))     ndimsΥꥢ
    * ((<ntype>))     vartype ̾
    * ((<vartype>))     ѿͤη䤦
    * ((<typecode>))     ѿͤη䤦(NArraytypecode֤)
    * ((<natts>))     °ο䤦
    * ((<file>))     ѿ°ե碌
    * ((<att>))     ̾ꤷ°֤
    * ((<put_att>))     °
    * ((<put>))     ((<simple_put>))̾(alias)
    * ((<simple_put>))     ͤ
    * ((<pack>)) self° scale_factor and/or add_offset Ѥ NArray  "pack" .
    * ((<scaled_put>))     ((<simple_put>)) Ʊͤ((<pack>))ˤ° scale_factor  add_offset ᤹
    * ((<get>))     ((<simple_get>))̾(alias)
    * ((<simple_get>))     ͤФ
    * ((<unpack>)) self° scale_factor and/or add_offset Ѥ NArray  "unpack" .
    * ((<scaled_get>))     ((<simple_get>)) Ʊͤ((<unpack>))ˤ° scale_factor  add_offset ᤹
    * ((<[]>))     NetCDFVar#get Ʊ֥ͤåȤ NArray#[] Ʊͤ˻ꤹ. 
    * ((<[]=>))     NetCDFVar#put Ʊ֥ͤåȤ NArray#[]= Ʊͤ˻ꤹ.


  "numru/netcdf_miss"  require 뤳Ȥɲä륤󥹥󥹥᥽å

    * ((<get_with_miss>))     ((<get>))Ʊͤǡ»

    * ((<get_with_miss_and_scaling>))     ((<get_with_miss>))Ʊͤ((<unpack>))ˤꥹ󥰤Ԥ.
    * ((<put_with_miss>))     ((<put>))Ʊͤǡ»
    * ((<put_with_miss_and_scaling>))     ((<put_with_miss>))Ʊͤ((<pack>))ˤꥹ󥰤Ԥ.

* ((<饹 NetCDFAtt>))

  饹᥽å

  󥹥󥹥᥽å
    * ((<name>))     °֤̾
    * ((<name=>))     °̾ѹ
    * ((<copy>))     °̤ѿޤϥե˥ԡեξϥХ°ˤʤ
    * ((<delete>))     °
    * ((<put>))     °ͤ
    * ((<get>))     °ȤФ
    * ((<atttype>))     °ͤη䤦
    * ((<typecode>))     °ͤη䤦(NArraytypecode֤)

---------------------------------------------

=饹 NetCDF
===饹᥽å
---NetCDF.open(filename, mode="r", share=false)
     ե륪ץʥ饹᥽åɡmode="w" ǥե뤬¸ߤʤп

     
     * filename (String): ե̾
     * mode (String) : ϥ⡼: "r"(ɤ߼Τ); "w","w+" (
        -- ߤȤϾ(ä!)); "r+","a","a+" (ɲ --
       ߤƤϤΤޤޤˡ񤭹߲) Ȥ߹ߤ File 饹
       㤤ɤΥ⡼ɤǤɤ߹ߤϲǽաˤʤ NetCDF饤
       ֥꡼¤ˤꡢɲáפˤ;ʬʻ֤ȥǥڡ
       롣
     * share (true or false) : shared⡼ɤˤ뤫 (񤭹Υե
       ¾Υץɤ߹ߤ true Ȥ롣Cǥ桼
       5Ϥ nc_open ι򻲾ȤΤ)

     
     * NetCDF饹Υ֥

     б(Ѥ) C  NetCDF δؿ
     * nc_open, nc_create

---NetCDF.new
     NetCDF.open᥽åɤΥꥢǤ

---NetCDF.create(filename, noclobber=false, share=false)
     NetCDFեʥ饹᥽å)
     
     
     * filename (String) : ե̾
     * noclobber (true or false) : 񤭤뤫ʤ
     * share (true or false) : shared mode Ȥ (񤭹Υե
       ¾Υץɤ߹ߤ true Ȥ롣Cǥ桼
       5Ϥ nc_open ι򻲾ȤΤ)

     
     *  NetCDF饹Υ֥

     б(Ѥ) C  NetCDF δؿ
     *  nc_create

---NetCDF.create_tmp(tmpdir=ENV['TMPDIR']||ENV['TMP']||ENV['TEMP']||'.', share=false)
     ƥݥ꡼NetCDFեʥ饹᥽å)
     ̾ϼưǷޤ롣Ⱦä롣

     
     * tmpdir (String) : ƥݥ꡼ե֤ǥ쥯ȥ꡼̾
       ǥեȤϴĶѿǻꤵ줿ǥ쥯ȥ꡼TMPDIR,TMP,or
       TEMPˤޤ '.'奢⡼ɤǤ '.' ΤߤǥեȤȤ
       롣
     * share (true or false) : shared mode Ȥ


     
     *  NetCDF饹Υ֥

     б(Ѥ) C  NetCDF δؿ
     *  nc_create

===󥹥󥹥᥽å
---close
     ե륯

     
     *  ʤ

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     *  nc_close

---ndims
     եμο֤

     
     *  ʤ

     
     *  Integer

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_ndims

---nvars
     եѿο֤
   
     
     *  ʤ

     
     *  Integer
     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_nvars

---natts
     եΥХ°ο֤

     
     *  ʤ

     
     *  Integer

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_natts

---unlimited
     եunlimited dimension֤

     
     *  ʤ

     
     *  ¸ߤȤNetCDFDim饹Υ֥ȡʤȤnil

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_unlimdim

---path
     եΥѥ. open/createfilenameȤ֤.

     
     *  ʤ

     
     *  String

     б(Ѥ) C  NetCDF δؿ
     *  ʤ

---redef
     define modeˤ롣ˤʤ鲿⤻nil֤

     
     *  ʤ

     
     *  true (⡼ɤؤѹ);
	nil (⡼).
	¾ͳѹǤʤ㳰ȯ.
     
     б(Ѥ) C  NetCDF δؿ
     *  nc_redef

---enddef
     data mode 롣ˤʤ鲿⤻nil֤

     
     *  ʤ

     
     *  true (ǡ⡼ɤؤѹ);
	nil (˥ǡ⡼).
	¾ͳѹǤʤ㳰ȯ.

     б(Ѥ) C  NetCDF δؿ
     *  nc_endef

---define_mode?
     ⡼ɤɤ碌.

     
     *  ʤ

     
     *  true (⡼);
	false (ǡ⡼);
	nil (¾ -- ɤ߽ФѤʤ).

     б(Ѥ) C  NetCDF δؿ
     *  nc_redef  nc_enddef Ȥ߹碌

---sync
     ꡼ΥХåեǥȿǤƥեƱ

     
     *  ʤ

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     *  nc_sync

---def_dim(dimension_name, length)
     dimension

     
     * dimension_name (String) : dimension̾
     * length (Integer) : dimensionĹ̵¼ 0

     
     *  줿 (NetCDFDim֥)

     б(Ѥ) C  NetCDF δؿ
     *  nc_def_dim

---put_att(attribute_name, value, atttype=nil)
     Х°

     
     * attribute_name (String) : Х°̾
     * value (Numeric, String, Array of Numeric, or NArray) : ꤹ
     * atttype (nil or String) : °η.
       "char"(="string"),"byte", "sint","int","sfloat", "float" (
       ,1,1,2,4,4,8 Х)) ޤ nil (ĤޤꤪǤ)

     
     *  ꤵ줿° (NetCDFAtt֥)

     б(Ѥ) C  NetCDF δؿ
     *  nc_put_att_<type>

---def_var(variable_name, vartype, dimensions)
     ѿ

     
     * variable_name (String) : variable̾
     * vartype (String or Fixnum) : ѿΥ ("char", "byte", "sint", "sint", "int",
       "sfloat", "float" Τ줫ޤNArraytypecode(Fixnum))
     * dimensions (Array) : variableμNetCDFDim  ArrayǤ
       ®׼٤׼νˡĹѿ
       rank Ȥʤ롣

     
     *  ѿ(NetCDFVar֥)

     б(Ѥ) C  NetCDF δؿ
     *  nc_def_var

---def_var_with_dim(variable_name, vartype, shape_ul0, dimnames)
     def_varƱɬפʤޤ롣
     ¸Ĺȹʤ㳰

     
     * variable_name (String) : variable̾
     * vartype (String) : ѿΥ ("char", "byte", "sint", "sint", "int",
       "sfloat", "float" Τ줫)
     * shape_ul0 (Array of Integer) : ѿη¨ƼĹ̵
       ¼ϥɽĹѿ rank Ȥʤ롣
     * dimnames (Array of String) : Ƽ̾. Ĺ(=>rank) 
       shape_ul0 ʤФʤʤ

     
     *  ѿ(NetCDFVar֥)

     б(Ѥ) C  NetCDF δؿ
     *  (nc_def_var)

---var(var_name)
     ե˴¸ѿ򥪡ץ

     
     * var_name (String) : ץ󤹤ѿ̾

     
     * NetCDFVar 饹Υ֥ȡ¸ߤʤ nil

     б(Ѥ) C  NetCDF δؿ
     * nc_inq_varid

---vars(names = nil)
     եѿޤȤƥץ

     
     * names (nil or Array of String) : ץ󤹤ѿ̾. nilʤʥǥեȡ

     
     * NetCDFVar֥ȤArraynames¸ߤʤѿ̾ޤޤ㳰ȯ

     б(Ѥ) C  NetCDF δؿ
     * nc_inq_varid

---dim(dimension_name)
     ¸μ򥪡ץ

     
     * dimension_name (String) : ץ󤹤뼡̾

     
     * NetCDFDim饹Υ֥ȡ¸ߤʤ nil

     б(Ѥ) C  NetCDF δؿ
     * nc_inq_dimid

---dims(names = nil)
     եμޤȤƥץ

     
     * names (nil or Array of String) : ץ󤹤뼡̾. nilʤʥǥեȡ

     
     * NetCDFDim֥ȤArraynames¸ߤʤ̾ޤޤ㳰ȯ

     б(Ѥ) C  NetCDF δؿ
     * nc_inq_dimid

---att(attribute_name)
     ¸ΥХ°򥪡ץ

     
     * attribute_name (String) : ץ󤹤륰Х°̾

     
     *  ¸ߤ NetCDFAtt饹Υ֥ȡ¸ߤʤnil

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_attid򸡺)

---fill=(filemode)
     fillmodeѹ(NetCDF ΥǥեȤ FILL Ǥ롣)

     
     * fillmode (true for FILL or false for NOFILL)

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     *  nc_set_fill

---each_dim{ ... }
     ˴ؤ륤ƥ졼. 
     : {|i| print i.name,"\n"} ̾ɽ.

     
     * { ... } : ƥ졼ѥ֥ådo end֥åǤ褤

     
     *  self

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_ndims)

---each_var{ ... }
     ѿ˴ؤ륤ƥ졼. 
     : {|i| print i.name,"\n"} ѿ̾ɽ.

     
     * { ... } : ƥ졼ѥ֥ådo end֥åǤ褤

     
     *  self

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_nvars)

---each_att{ ... }
     Х°˴ؤ륤ƥ졼. 
     : {|i| print i.name,"\n"} °̾ɽ.

     
     * { ... } : ƥ졼ѥ֥ådo end֥åǤ褤

     
     *  self

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_natts, nc_inq_attname)

---dim_names
     ե֤̾

     
     *  ʤ

     
     *  String  Array

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_ndims, nc_inq_dimname)

---var_names
     եѿ֤̾

     
     *  ʤ

     
     *  String  Array

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_nvars, nc_inq_varname)

---att_names
     եХ°֤̾
     
     *  ʤ

     
     *  String  Array

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_natts, nc_inq_attname)

---------------------------------------------

=饹 NetCDFDim
===饹᥽å

===󥹥󥹥᥽å
---length
     Ĺ֤

     
     *  ʤ

     
     *  Integer

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_dimlen

---length_ul0
     length Ʊ̵¼˴ؤ֤

     
     *  ʤ

     
     *  Integer

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_dimlen

---name=(dimension_newname)
     ̾Ĥ

     
     * dimension_newname (String) : ̾

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     *  nc_rename_dim

---name
     ֤̾

     
     *  ʤ

     
     *  String

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_dimname

---unlimited?
     ̵¼ɤ

     
     *  ʤ

     
     *  true or false

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_unlimdim )

---------------------------------------------

=饹 NetCDFVar
===饹᥽å
---NetCDFVar.new(file,varname,mode="r",share=false)
     NetCDFѿ򥪡ץ󤹤롣ϡNetCDF#var (NetCDF饹Υ
     󥹥᥽åvar) ȤäƤ뤷Τۤ侩롣

     
     * file (NetCDF or String) : NetCDF֥(NetCDF)
       ޤ NetCDF եΥѥ(String)
     * varname (String) : fileѿ̾
     * mode (String) : ϥ⡼ɡfile String λ˻Ȥ롣
       NetCDF.openι򸫤
     * share (true or false) : shared⡼ɤˤ뤫
       file String λ˻Ȥ롣NetCDF.openι򸫤

     
     * NetCDFVar饹Υ֥

     б(Ѥ) C  NetCDF δؿ
     * (nc_open, nc_create, nc_inq_varid Ѥ)

---NetCDFVar.unpack_type=(na_type)
     ((<scaled_get>))ǻȤNArrayηꤹ.

     
     * na_type (Integer) : NArray::BYTE, NArray::SINT, NArray::INT, 
       NArray::SFLOAT, or NArray::FLOAT

     
     * na_type ()

---NetCDFVar.unpack_type
     ((<NetCDFVar.unpack_type=>))ꤷNArrayη֤.

     
     * nil, NArray::BYTE, NArray::SINT, NArray::INT, 
       NArray::SFLOAT, or NArray::FLOAT

===󥹥󥹥᥽å
---dim(dim_num)
     ѿˤ dim_num (0)μ碌롣

     
     * dim_num (Fixnum) : 0,1,2,...Ǥ®뼡0

     
     *  NetCDFDim֥

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_vardimid)

---dims
     ѿˤ֤

     
     *  ʤ

     
     *  NetCDFDim֥ȤArray

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_vardimid

---shape_ul0
     ѿη֤. â̵¼Ĺϥ.
     ¾ѿ.

     
     *  ʤ

     
     *  Array. [0ܤĹ, 1ܤĹ,.. ]

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_vardimid, nc_inq_unlimdim )

---shape_current
     ѿθߤη֤.

     
     *  ʤ

     
     *  Array. [0ܤĹ, 1ܤĹ,.. ]

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_vardimid )

---each_att{ ... }
     ѿ°(NetCDFAtt)˴ؤ륤ƥ졼

     
     * { ... }  : ֤֥å

     
     *  self

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_natts, nc_inq_attname)

---dim_names
     ѿ֤̾

     
     *  ʤ

     
     *  String  Array

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_varndims, nc_inq_vardimid, nc_inq_dimname )

---att_names
     ѿ°֤̾

     
     *  ʤ

     
     *  String  Array

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_natts, nc_inq_attname)

---name
     ѿ֤̾
 
     
     *  ʤ

     
     *  String

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_varname

---name=(variable_newname)
     ̾դؤ

     
      * variable_newname (String) : ̾

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     *  nc_rename_var

---ndims
     ο䤦

     
     *  ʤ

     
     *  Integer

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_varndims

---rank
     ndimsΥꥢ

---ntype
     vartype̾

---vartype
     ѿͤη䤦

     
     *  ʤ

     
     *  String ("char","byte","sint","int","sfloat", or "float")

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_vartype

---typecode
     ѿͤη䤦(NArraytypecode֤)

     
     *  ʤ

     
     *  Fixnum֥ (NArray:BYTE, NArray:SINT, NArray:LINT, NArray:SFLOAT, NArray:SFLOAT, NArray:DFLOAT)

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_vartype

---natts
     °ο䤦

     
     *  ʤ

     
     *  Integer

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_varnatts

---file
     ѿ°ե碌

     
     *  ʤ

     
     *  NetCDF饹Υ֥

     б(Ѥ) C  NetCDF δؿ
     *  ʤ

---att(attribute_name)
     ̾ꤷ°֤

     
     * attribute_name (String) : Ф°̾

     
     *  NetCDFAtt֥. ¸ߤʤnil

     б(Ѥ) C  NetCDF δؿ
     *  (nc_inq_attid򸡺)

---put_att(attribute_name, value, atttype=nil)
     °

     
     * attribute_name (String) : attribute̾
     * value (Numeric, String, Array of Numeric, or NArray) : ꤹ
     * atttype (nil or String) : °η.
       "char"(="string"),"byte", "sint","int","sfloat", "float" (
       ,1,1,2,4,4,8 Х)) ޤ nil (ĤޤꤪǤ)

     
     *  NetCDFAttΥ֥

     б(Ѥ) C  NetCDF δؿ
     *  nc_put_att_<type>

---put(value, option=nil)
     ((<simple_put>))̾(alias)

---simple_put(value, option=nil)
     ͤ

     
     * value :  (Numeric,Array(Numeric1)NArray)
       顼(Numeric)ޤĹξϡͤͤꤹ롣
     * option (Hash) : ѿΰʬꤹ뤿Υץ
       άСѿΤоݤȤʤ롣ϥåΥȤƤϡ
       "start","end","stride"ȡޤ"index"ѤǤ롣"index"
       1ǡʥ顼ˤؤ"end","stride"Ͼάġάˤ
       ʤˤ񤭤٤Ǥο valueΤȰפ褦ˤ
       ʤФʤʤstart,end,indexǤArrayξƱͤ͡Ǹ
       ΰ֤Ǥ롣"stride"ͤΤ߼դΤǡ
       ä֤и夫Ӥ뤳Ȥˤʤ롣

       㡧 ѿ2ξ:

       {"start"=>[2,5],"end"=>[6,-1],"stride"=>[2,4]} -- 1ܤϡ
        2  6 ޤ 1 Ĥ (0Τ 2  3 ܤǤ
       뤳Ȥ)2ܤϡ 6  Ǹ(=-1)ޤ 3 Ĥ
       ˤȤä֥åȡ

       {"index"=>[0,0]}: ǽǤˤ
       륹顼

       {"index"=>[0,-2]}: 1ܤϺǽ, 2ܤϺǸ夫2ܤˤ
       륹顼

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     *  nc_put_var_<type>, nc_put_vars_<type>, nc_put_var1_<type>

---pack(na)
     self° scale_factor and/or add_offset Ѥ NArray  "pack" .

     ⤷ scale_factor and/or add_offset ꤵƤ
     (na-add_offset)/scale_factor ֤Ǥʤ na ֤

     
     * na : pack  (NArray, NArrayMiss, Array)

     
     *  a NArray or NArrayMiss

---scaled_put(value, option=nil)
     ((<simple_put>)) Ʊͤ((<pack>))ˤ° scale_factor  add_offset ᤹

     ˤĤƤ put β򻲾ȤΤ

---get(option=nil)
     ((<simple_get>))̾(alias)

---simple_get(option=nil)
     ͤФ

     
     * option (Hash) : ѿΰʬꤹ뤿Υץ
       ͤ put Ʊ

     
     *  NArray饹Υ֥

     б(Ѥ) C  NetCDF δؿ
     *  nc_get_var_<type>, nc_get_vars_<type>, nc_get_var1_<type>

---unpack(na)
     self° scale_factor and/or add_offset Ѥ NArray  "unpack" .

     ⤷ scale_factor and/or add_offset ꤵƤ
     na * scale_factor + add_offset ֤Ǥʤ na ֤
     coerce ˤäƷѲ -- 㤨С⤷ na  sint 
     scale_factor  add_offset  sfloat ǤС֤ͤ sfloat
     ˤʤ롣֤ͤη ((<NetCDFVar.unpack_type=>)) Ȥä
     ۤ˻ꤹ뤳ȤǤ롣

     
     * na : unpack  (NArray, or NArrayMiss)

     
     *  a NArray or NArrayMiss


---scaled_get(option=nil)
     ((<simple_get>)) Ʊͤ((<unpack>))ˤ° scale_factor  add_offset ᤹

     ˤĤƤ put β򻲾ȤΤ

---[]
     NetCDFVar#get Ʊ֥ͤåȤ NArray#[] Ʊͤ˻ꤹ. 

     NArrayǥݡȤƤ륵֥åȻˡ˲äơƥå
     ϰϤǤ롣 {0..-1,2} ʤɤȤ롣Ĥޤꡢ
     ΥϥåΥϰ(Range)ͤ˥ƥå(Integer)
     롣NArrayȰ㤤ʾѿ򣱼Υǥå
     ꤹ뤳ȤϽʤ

---[]=
     NetCDFVar#put Ʊ֥ͤåȤ NArray#[]= Ʊͤ˻ꤹ. 

     NArrayǥݡȤƤ륵֥åȻˡ˲äơƥå
     ϰϤǤ롣 {0..-1,2} ʤɤȤ롣Ĥޤꡢ
     ΥϥåΥϰ(Range)ͤ˥ƥå(Integer)
     롣NArrayȰ㤤ʾѿ򣱼Υǥå
     ꤹ뤳ȤϽʤ

==="numru/netcdf_miss"  require 뤳Ȥɲä륤󥹥󥹥᥽å

---get_with_miss(option=nil)
     ((<get>))Ʊͤǡ»

     ǡ»ɸ° valid_range, (valid_min and/or valid_max), 
     ޤ missing_value ˤꤵ롣̤ͥϤν֤
     롣֥桼ɡפο侩Ȱ㤤Ǥ missin_value 
     ᤵ롣⤷ missing_value  valid_* Ʊ¸ߤ硢
     missng_value ͭǡϰϳˤäƤϤʤʤξ硢㳰
     ȯ롣

     嵭Τ褦ˤ⤷ǡ»ʤλˤꤵƤСΥ᥽
     ɤ NArrayMiss ֥Ȥ֤Ǥʤ NArray ֤

     
     * ((<get>))򸫤.

     
     * NArrayMiss֥ (ǡ»ꤵƤ) ޤ NArray
       ֥ (ǡ»ꤵƤʤ)

     NetcdfError ʳ㳰ȯ
     * missing_value ǡͭϰϤˤʤ (嵭ȤΤ).

     б(Ѥ) C  NetCDF δؿ
     * ((<get>)) 򸫤. Υ᥽åɤ Ruby Τߤǽ񤫤Ƥ. 

     
     * Ǥ ((<get>))  ((<get_with_miss>)) ֤Ƥ.
        ((<[]>)) ǡ»᤹褦ˤʤ ( 
       (({get})) ƤǤΤ).

         file = NetCDF.open('hogehoge.nc')
         var = file.var('var')
         def var.get(*args); get_with_miss(*args); end
         p var.get       # --> inteprets data missing if defined
         p var[0..-1,0]  # --> inteprets data missing if defined (assumed 2D)


---get_with_miss_and_scaling(option=nil)
     ((<get_with_miss>))Ʊͤ((<unpack>))ˤꥹ󥰤Ԥ.

     »ͽϴŪˤ pack ǡоݤ˹Ԥ(¿
     ٥󥷥ѤƤ)valid_* / missing_value
     η pack ǡηȰۤʤꡢ unpackǡη
     פȤʤ˸¤ unpack ǡоݤȤ롣
     ǴŪƤΥ٥󥷥бǤ롣

     
     * 嵭ȡƱȤǤ롣

---put_with_miss(value, option=nil)
     ((<put>))Ʊͤǡ»

     ⤷ (({value}))  NArray ʤ顢Υ᥽åɤ ((<put>)) Ʊ
     . ⤷(({value}))  NArrayMiss Ǥ self °ˤǡ»
     Ƥ (((<get_with_miss>))򻲾ȤΤ)(({value})) 
     Υǡ»ᤵ롣¨(({value}))η»ǡϡ
     » (missing_value ޤ _FillValue ޤϥǡͭϰ
     Ŭ) ֤줿ǥե˽񤭹ޤ롣
     (({value})) »ǡ (({self})) ˤͭϰϤä
     뤫ɤϥåʤ

     
     * value : NArrayMiss ޤ ((<put>)) ǵƤ륯饹Υ֥.
     * option (Hash) : ((<put>)) 򸫤.

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     * ((<put>)) 򸫤. Υ᥽åɤ Ruby Τߤǽ񤫤Ƥ. 

     
     * Ǥ ((<put>))  ((<put_with_miss>)) ֤Ƥ.
        ((<[]=>)) ǡ»᤹褦ˤʤ ( 
       (({put})) ƤǤΤ).

         file = NetCDF.open('hogehoge.nc')
         var = file.var('var')
         def var.put(*args); put_with_miss(*args); end
         var.put = narray_miss      # --> inteprets data missing if defined
         var[0..-1,0] = narray_miss # --> inteprets data missing if defined (assumed 2D)

---put_with_miss_and_scaling(value, option=nil)
     ((<put_with_miss>))Ʊͤ((<pack>))ˤꥹ󥰤Ԥ.

     »ͽϴŪˤ pack ǡоݤ˹Ԥ(¿
     ٥󥷥ѤƤ)valid_* / missing_value
     η pack ǡηȰۤʤꡢ unpackǡη
     פȤʤ˸¤ unpack ǡоݤȤ롣
     ǴŪƤΥ٥󥷥бǤ롣

     
     * 嵭ȡƱȤǤ롣

---------------------------------------------

=饹 NetCDFAtt
===饹᥽å

===󥹥󥹥᥽å
---name
     °֤̾

     
     *  ʤ

     
     *  String

     б(Ѥ) C  NetCDF δؿ
     *  ʤ

---name=(attribute_newname)
     °̾ѹ

     
     * attribute_newname (String) : ̾

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     *  nc_rename_att

---copy(var_or_file)
     °̤ѿޤϥե˥ԡեξϥХ°ˤʤ

     
     * var_or_file (NetCDFVar or NetCDF)

     
     *  ԡƺ줿° (NetCDFAtt)

     б(Ѥ) C  NetCDF δؿ
     *  nc_copy_att

---delete
     °

     
     *  ʤ

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     *  nc_del_att

---put(value, atttype=nil)
     °ͤ

     
     * value (Numeric, String, Array of Numeric, or NArray) : 
     * atttype (nil or String) : °η.
       "char"(="string"),"byte", "sint","int","sfloat", "float" (
       ,1,1,2,4,4,8 Х)) ޤ nil (ĤޤꤪǤ)

     
     *  nil

     б(Ѥ) C  NetCDF δؿ
     *  nc_put_att_<type>

---get
     °ȤФ

     
     *  ʤ

     
     *  ʸޤNArray֥ (: 顼ξĹ1
	NArrayˤʤ)
     
     б(Ѥ) C  NetCDF δؿ
     *  nc_get_att_<type>

---atttype
     °ͤη䤦

     
     *  ʤ

     
     *  "char","byte","sint","int","sfloat","float"

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_atttype

---typecode
     °ͤη䤦(NArraytypecode֤)

     
     *  ʤ

     
     *  Fixnum֥ (NArray:BYTE, NArray:SINT, NArray:LINT, NArray:SFLOAT, NArray:SFLOAT, NArray:DFLOAT)

     б(Ѥ) C  NetCDF δؿ
     *  nc_inq_atttype

=end