Up|<<Prev|Next>>


7.16 フィル値

開かれたNetCDFファイルに書き込まれたことのない値を読み取ろうとしたならば何が起こるでしょう?必ずエラーが発生し、エラーメッセージもしくはエラーステータスが返されると思われがちです。確かに、開かれていないNetCDFファイルからデータを読もうとした場合、指定されたNetCDFファイルにおいてその変数IDが有効でない場合、または指定されたインデックスが指定された変数の次元長で定義された領域外にある場合にはエラーが発生します。しかし、それ以外の場合には、書き込まれていない値を読もうとすると、初めにNetCDF変数が書かれたときに未定義の全ての値を埋めるための使用される特別なフィル値 fill value が返されます。

このフィル値を無視してNetCDF外部データ型の全領域を使うことも出来ますが、その場合には読む前に全てのデータ値を書き込んだことを確認しなければなりません。もし、読む前に全てのデータ値を書き込むことが確かであれば、書き込む前に nc_set_fill を呼び出すことによってフィル値を持っている変数が前もって埋められてしまわないと確信できます。 これによってNetCDFの書き込み効率が著しく向上することもあります。

変数属性 _FillValue はある変数のフィル値を指定するためにも使えます。各型ごとに デフォルトのフィル値があり、インクルードファイル netcdf.h の中で定義されています。 netcdf.h: NC_FILL_CHAR , NC_FILL_BYTE , NC_FILL_SHORT , NC_FILL_INT , NC_FILL_FLOAT , and NC_FILL_DOUBLE .

NetCDFバイトと文字型は異なるデフォルトのフィル値を持ちます。文字用のデフォルトのフィル値は 零バイトであり、可変長のC 文字列の終わりを判別するのに役立ちます。バイト変数にフィル値が必要なときには、適した _FillValue 属性を定義することをお勧めします。それは、 ncdump 等の一般的なユーティリティではバイト変数に関してはデフォルトのフィル値を仮定しないからです。

フィル値のタイプ変換は他の値のタイプ変換と全く同様です。ある値をその値を表現できない別の型に変換しようとするとレンジエラーが生じます。 そのようなエラーは、大きな型(例えばダブル型)から小さな型(例えばフロート型)へと読み書きする際に、大きい方の方のフィル値が小さい方の型では表現できない時に生じることがあります。


Up|<<Prev|Next>>