FortranのためのNetCDFユーザーのガイド
無制限の
長さ ( この次元を使う方法変数がこの次元に沿って強め得る ) を持っていることができる。
そこで1つのnetCDF
datasetにおいて定義され得る次元の数に達するまでの提案された限界 ( 100 ) である。限界は、前‐定義されたマクロの値であるNF_MAX_DIMS
。限界の目的は、記述の一般的アプリケーションを更に簡単にすることである。それらは、アレイをただ供給する必要がある、の、あらゆるnetCDF
datasetを扱うためのNF_MAX_DIMS
次元。netCDFライブラリのインプリメントは、この勧告的最大を実施しない。従って、更に多くの次元を使うことは、可能である、必要なら、しかし、netCDFユーティリティ、それ、勧告的最大がハンドルにできないかもしれない、と推測する、その結果生じるnetCDF
datasets。
通常、その次元が最初に定義されるとき、次元の名前、及び、長さは、決定される。後でその名前は、変えられるかもしれない。しかし、次元 ( 無制限の次元以外に ) の長さは、データ全てを再定義された次元長さを持つ新しいnetCDF datasetにコピーせずに変えられることができない。
オープンnetCDF datasetにおけるnetCDF次元は、次元IDと呼ばれる小さい整数によって参照される。で、FORTRANインタフェース、次元ID、である、1 ,2 ,3、それらの次元が定義されたオーダにおける...。
次元でサポートされたオペレーションは、以下である。
NF_DEF_DIM
NF_DEF_DIM
は、オープンnetCDF
datasetへの新しい次元を加える、モードを定義する。それは、次元IDを返す ( 引数として ) ( netCDF ID、次元名前、及び、次元長さを与えられて
) 。せいぜい、レコード次元と呼ばれる1つの無制限の長さ次元は、各netCDF datasetのために定義されるかもしれない。
NF_DEF_DIM
値を返すNF_NOERR
、エラーが発生しなかったならば。他の場合は、返された状態は、エラーを示す。エラーの可能な原因は、以下を含む。
NF_DEF_DIM
長さ18、及び、無制限の次元のlat
と指定された次元を作成することは、foo.nc
と指定されたdatasetと新しいnetCDFにおけるレクリエーション
を命名した:
'netcdf.inc'を含む
...
.
整数状態、NCID、LATID、RECID
... .
状態= NF_CREATE (
'foo.nc'、NF_NOCLOBBER、NCID ) 、かどうか ( STATUS .NE. NF_NOERR ) 、HANDLE_ERR ( STATUS
) を呼ぶ、
... .
状態= NF_DEF_DIM ( NCID、` lat '、18、LATID ) 、かどうか ( 状態.NE.
NF_NOERR ) HANDLE_ERR ( STATUS ) 状態= NF_DEF_DIM (
NCID、NF_UNLIMITEDされる`レクリエーション'をRECID ) と呼ぶ、かどうか ( 状態.NE. NF_NOERR ) HANDLE_ERR (
STATUS ) を呼ぶ、
NF_INQ_DIMID
NF_INQ_DIMID
は、netCDF次元のIDを返す ( 引数として ) (
次元の名前を与えられて ) 。ndims
がnetCDF
datasetのために定義された次元の数であるならば、各次元は、間にIDを持っている1、そして、ndims
.
NCID
| 前のコールからNF_OPEN 、または、NF_CREATE までのNetCDF ID。
|
名前
| 次元名、レターで始まるキャラクタストリング、そして、レター、数字のあらゆるシーケンスを従えている、〜もしくは、キャラクタに下線を引く (
_ ) 。ケースは、次元名において有意である。
|
2‐中央の 、
| 返された次元ID。 |
NF_INQ_DIMID
値を返すNF_NOERR
、エラーが発生しなかったならば。他の場合は、返された状態は、エラーを示す。エラーの可能な原因は、以下を含む。
NF_INQ_DIMID
次元の次元IDを決定することは、lat
を指定した
( foo.nc
と指定された現存するnetCDF datasetにおいて以前に定義されたために、推測されて ) :
'netcdf.inc'を含む
...
.
整数状態、NCID、LATID
... .
状態= NF_OPEN ( 'foo.nc'、NF_NOWRITE、NCID ) 、かどうか
( STATUS .NE. NF_NOERR ) 、HANDLE_ERR ( STATUS ) を呼ぶ、
... .
状態=
NF_INQ_DIMID ( NCID、` lat '、LATID ) 、かどうか ( STATUS .NE. NF_NOERR ) 、HANDLE_ERR (
STATUS ) を呼ぶ、
NF_INQ_DIM
ファミリーこのファミリーにおけるファンクション、含む、NF_INQ_DIM
NF_INQ_DIMNAME
そして、NF_INQ_DIMLENする
。ファンクションNF_INQ_DIM
次元に関する情報全てを返す;それぞれ他のファンクションは、ほんの1つの情報のアイテムを返す。
これらのファンクションは、値を返すNF_NOERR
、エラーが発生しなかったならば。他の場合は、返された状態は、エラーを示す。エラーの可能な原因は、以下を含む。
NF_INQ_DIM
lat
と指定された次元の長さ、及び、現存するnetCDF
datasetのための無制限の次元の名前、及び、現在の最大の長さを決定することは、foo.nc
を指定した:
'netcdf.inc'を含む
...
.
整数状態、NCID、LATID、LATLEN、RECID、NRECS CHARACTER* ( NF_MAX_NAME )
LATNAM、RECNAM
... .
状態= NF_OPEN ( 'foo.nc'、NF_NOWRITE、NCID ) 、かどうか (
状態.NE. NF_NOERR ) HANDLE_ERR ( STATUS ) を呼ぶ、無制限の次元状態= NF_INQ_UNLIMDIM (
NCIDのIDを得る、RECID ) 、かどうか ( 状態.NE. NF_NOERR ) HANDLE_ERR ( STATUS ) を呼ぶ、
...
.
状態= NF_INQ_DIMID ( NCID、` lat '、LATID ) 、かどうか ( STATUS .NE. NF_NOERR )
、コールHANDLE_ERR ( STATUS ) 、lat長さ状態= NF_INQ_DIMLEN ( NCIDを得る、LATID、 )
をLATLENする、かどうか ( STATUS .NE. NF_NOERR ) 、コールHANDLE_ERR ( STATUS )
、無制限の次元名前、及び、現在の長さ状態= NF_INQ_DIM ( NCIDを得る、RECID、RECNAME、NRECS ) 、かどうか ( STATUS
.NE. NF_NOERR ) 、コールHANDLE_ERR ( STATUS ) 、
NF_RENAME_DIM
NF_RENAME_DIM
は、netCDFにおける現存する次元を記述のために開いたdatasetと改名する。新しい名前が古い名前より長いならば、netCDF
datasetは、中になければならない、モードを定義する。あなたは、他の次元と同じ名前を持つために、次元を改名し得ない。
NCID | 前のコールからNF_OPEN 、または、NF_CREATE までのNetCDF ID。
|
2‐中央の、 | 前のコールからNF_INQ_DIMID 、または、NF_DEF_DIM までの次元ID。
|
名前 | 次元のための新しい名前。 |
NF_RENAME_DIM
値を返すNF_NOERR
、エラーが発生しなかったならば。他の場合は、返された状態は、エラーを示す。エラーの可能な原因は、以下を含む。
NF_RENAME_DIM
現存するnetCDFにおける緯度
に、datasetは、次元lat
を改名するために、foo.nc
を指定した:
'netcdf.inc'を含む
...
.
整数状態、NCID、LATID
... .
状態= NF_OPEN ( 'foo.nc'、NF_WRITE、NCID ) 、かどうか (
STATUS .NE. NF_NOERR ) 、HANDLE_ERR ( STATUS ) を呼ぶ、
... .
!入れられて、次元STATUS =
NF_REDEF ( NCID ) IFを ( STATUS .NEと改名するために、モードを定義しなさい。NF_NOERR ) コールHANDLE_ERR (
STATUS ) 状態= NF_INQ_DIMID ( NCID、` lat '、LATID ) 、かどうか ( STATUS .NE. NF_NOERR )
、コールHANDLE_ERR ( STATUS ) 状態= NF_RENAME_DIM ( NCID、LATID、`緯度' ) 、かどうか ( STATUS
.NE. NF_NOERR ) 、コールHANDLE_ERR ( STATUS ) 、離れる、モード状態= NF_ENDDEF ( NCID )
を定義する、かどうか ( STATUS .NE. NF_NOERR ) 、コールHANDLE_ERR ( STATUS ) 、