Up|<<Prev|Next>>


4.2 既知の名前の NetCDF ファイルを読む

ここでは NetCDFファイルの名前ばかりでなく、それに含まれている次元・変数・属性の名前も既知である場合を取り上げます。(そうでない場合には "inquire" コールをする必要があります。NetCDFファイルの中の変数のデータを読むためのごく一般的なCでのコールの順序は:

    NF_OPEN               ! 既知のNetCDFファイルを開く
         ... 
       NF_INQ_DIMID       ! 次元IDを取得する
         ... 
       NF_INQ_VARID       ! 変数IDを取得する
         ... 
       NF_GET_ATT     
    ! 属性値を取得
         ... 
       NF_GET_VAR         ! 変数の値を取得
         ... 
    NF_CLOSE              ! NetCDFファイルを閉じる

まず、ファイルの名前を与えることにより、 最初のコールがNetCDFファイルを開きます。そして、その後、開かれたファイルを参照するために必要なNetCDF IDを返します。

次に、 NF_INQ_DIMID へのコールでアクセスする次元ごとに 次元名に由来した次元IDが割り振られます。同様にして、必要な変数IDも変数名に由来する名前が NF_INQ_VARID へのコールで決定されます。 一旦、変数IDを手に入れれば、 NetCDF ID、変数ID、そして必要な属性名を使うことで、 NF_GET_ATT ファミリーのメンバーとして入力として、変数の属性値も読み取れます(通常、各々の属性に対して NF_GET_ATT_TEXT もしくは、 NF_GET_ATT_DOUBLE )。変数データの値はNetCDFファイルから、直接アクセスすることが出来ます。単一の値の場合には、 NF_GET_VAR1 ファミリーのメンバーへのコールのよって、 そして変数全体の場合には NF_GET_VAR ファミリーへ、又は配列・部分サンプル・マップされたアクセスの場合には NF_GET_VARA , NF_GET_VARS , もしくは NF_GET_VARM ファミリーへのコールを使います。

最後に、 NetCDF ファイルは NF_CLOSE によって閉じられます。読み取るだけのためにファイルを開いた場合には閉じる必要はありません。


Up|<<Prev|Next>>