4.4 新たに次元・変数・属性を加える

---

既存のNetCDFファイルには変更を加えることができます。すでに存在している次元・変数・属性などを新たに加えたり、名前を変更することも可能ですし、既存の属性は抹消することができます。次のコードのテンプレートは既存のファイルに新しい要素を加えるためのごく一般的な例です。

NF_OPEN ! 既存のNetCDFファイルをオープンする。
…
NF_REDEF ! 定義モードに入る。
…
NF_DEF_DIM ! (あれば)新しい次元を定義し、加える。
…
NF_DEF_VAR ! (あれば)新しい変数を定義し、加える。
…
NF_PUT_ATT ! (あれば)新しい属性を定義し、加える。
…
NF_ENDDEF ! 定義をチェックし、定義モードから出る。
…
NF_PUT_VAR ! 新しい変数に値を与える。
…
NF_CLOSE ! NetCDFファイルをクローズする。

NetCDFファイルは、まず、NF_OPENを呼び出すことによってオープンします。この呼び出しによって、オープンされたファイルはデータモード(data mode)に入ります。このモードでは既存のデータ値にアクセスしたり変更を加えたりすることができます。また、属性値も(大きくならない限りにおいては)変更できます。ただし、このモードでは何もたすことはできません。新しいNetCDF次元・変数・属性を加えるにはNF_REDEFを呼び出して定義モード(define mode)に入らなければなりません。定義モードでは、新しい次元を定義するためにはNF_DEF_DIMを、新しい変数を加えるにはNF_DEF_VARを、そして古い変数や増大してしまった古い属性に新しい属性を与えるにはNF_PUT_ATTファミリーを呼び出します。

定義モードから出て、再びデータモードに入ることもできます。そこで、新しい定義に矛盾が無いか等をチェックし、ディスクに保存するにはNF_ENDDEFを呼び出してください。データモードに戻りたくなければ、単にNF_CLOSEを呼び出してください。これは、最初にNF_ENDDEFを呼び出したことと同義になります。

NF_ENDDEFが呼び出される前であれば、NF_ABORTを呼び出すことによって、定義モードで行なったすべての再定義を無効にしてNetCDFライブラリを元のステータスに戻せます。また、このNF_ABORTを呼び出すことによって、NF_ENDDEFの呼び出しが失敗した場合にNetCDFファイルを矛盾の無いステータスまで復帰させることができます。定義モードからNF_CLOSEを呼び出したら自動的に追従するNF_ENDDEFへの呼び出しが失敗した際には、NF_ABORTが自動的に呼び出され、NetCDFライブラリはクローズされ、元の矛盾の無い状態(定義モードに入る前の状態)に戻ります。

一つのプロセスは書き込み用に一時に最大一個のNetCDFファイルを開いていなければなりません。ライブラリは、統制の取れたNF_SYNC関数の利用とNF_SHAREフラグを立てることによって、同時に単一の書き込みと複数の読み込み用に扱われることに対して限定されたサポートをしています。もし、書き込み側が定義モードに変更を加えれば(例：新しい変数、次元、属性)、そのライブラリに対して読み込み側に対し同時にアクセスすることを防ぐ制約を外部から加える必要があり、また、読み込み側に対して次回のアクセスの前にNF_SYNCを呼び出すように注意を促す必要が出てきます。

Quadralay Corporation http://www.webworks.com Voice: (512) 719-3399 Fax: (512) 719-3606 sales@webworks.com