6.1 次元を生成する: NF_DEF_DIM

---

関数NF_DEF_DIM 等は定義モード中であれば、新しい次元をオープンされたNetCDFファイルに加えることができます。NetCDFのID、次元名、次元長を与えると、(引数として)次元IDを返します。最大で一つの無制限次元(記録次元)がNetCDFファイルごとに定義できます。

用法

INTEGER FUNCTION NF_DEF_DIM (INTEGER NCID, CHARACTER*(*) NAME,
INTEGER LEN, INTEGER dimid)

NCID	以前のNF_OPEN or NF_CREATE呼び出しで返されたNetCDF ID
NAME	次元名。アルファベットの文字で始まり、次にアンダースコア(‘_’)を含む0個以上の英数字が続く。大文字小文字は区別されます。
LEN	次元長。この次元をインデックスとして使用する変数に対して、この次元が持ちうる値の数。正の整数(size_t型)もしくは事前に定義された定数 NF_UNLIMITED
dimid	返された次元ID

エラー

エラーが発生していなければ、NF_DEF_DIM は NF_NOERR の値を返します。それ以外の場合には返されたステータスがエラーの発生を示します。エラーの原因としては：

･ NetCDFファイルが定義モードにない。
･ 指定された次元名は別の既存の次元名である。
･ 指定された次元長が零より大きくない。
･ 指定された次元長は無制限であるが、そのNetCDFファイル内に既に無制限の次元長を持つ次元が定義されている。
･ 指定されたNetCDF IDがオープンされているNetCDFファイルを参照しない。
例

これはNF_DEF_DIM 機能を使用して次元名lat・次元長18、そして次元名 rec・次元長 無制限の二つの次元を持つ新しい foo.ncというNetCDFファイルを生成する例です：

INCLUDE 'netcdf.inc'
…
INTEGER STATUS, NCID, LATID, RECID
…
STATUS = NF_CREATE('foo.nc', NF_NOCLOBBER, NCID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
…
STATUS = NF_DEF_DIM(NCID, 'lat', 18, LATID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
STATUS = NF_DEF_DIM(NCID, 'rec', NF_UNLIMITED, RECID)
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