5.4 NetCDFファイルの生成: NF_CREATE

---

この関数によって新規のNetCDFファイルが生成されます。これによって返されたNetCDF IDは他のNetCDF関数呼び出しにおいてこのファイルを参照するために使用できます。書き込みアクセス用にオープンされ、定義モードになっているNetCDFファイルに、新しい次元・変数・属性などを加えることができます。

生成モードのフラグによって、既存の同一名のファイルを上書きするか、あるいはファイルへのアクセスが共有されるかなどを指定できます。

用法
INTEGER FUNCTION NF_CREATE (CHARACTER*(*) PATH, INTEGER CMODE,
INTEGER ncid)

PATH	新しいNetCDFファイルの名前
CMODE	生成モード。零値(またはNF_CLOBBER)はデフォルトステータス(既存の同一名のファイルは上書きし、また、効率のためにアクセスをバッファリングおよびキャッシュを行う)を指定します。 それ以外の場合は、生成モードはNF_NOCLOBBER, NF_SHARE、またはIOR(NF_NOCLOBBER, NF_SHARE)です。NF_NOCLOBBERフラグを立てることによって既存のファイルを上書きしないことを宣言できます。既に指定されたファイルが存在する場合には、エラー(NF_EEXIST)が返されます。NF_SHAREフラグはファイルに書き込む処理とファイルを読み取る処理が一つもしくは複数行なわれている場合に適当です。これによって、ファイルへのアクセスはバッファーされず、キャッシュも制限されます。バッファー機構は連続アクセスに対して最適化されているので、データを連続的にアクセスしないプログラムにおいてはNF_SHAREフラグを設定することによりパフォーマンスの向上が望めます。
ncid	出力されたNetCDF ID

エラー

エラーが発生していない場合には、NF_CREATEはNF_NOERRの値を返します。エラーの原因として下記が挙げられます。

･ 存在しないディレクトリを含むファイルを渡している。
･ 既存のファイル名もしくはファイルを指定しながら、NF_NOCLOBBERも同時に指定している。
･ 生成モードにとって無意味な値を与えている。
･ ファイルの作成が許可されていないディレクトリに新しいNetCDFファイルを生成しようとしている。
例

この例では、foo.ncと言う名前のNetCDFファイルを生成します。現行のディレクトリに同一名のファイルが存在しない場合に限り、新しいファイルを生成します。

INCLUDE 'netcdf.inc'
…
INTEGER NCID, STATUS
…
STATUS = NF_CREATE('foo.nc', NF_NOCLOBBER, NCID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)

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