ncgen3 - クラウドでオンライン

プログラム：

NAME

ncgen3 - CDL ファイルから netCDF クラシックまたは 64 ビット クラシックファイル、C プログラム、または
Fortran プログラム

SYNOPSIS

ncgen3 [-b] [-c] [-f] [-k ファイルの種類] [-x] [-n] [-o netcdf_ファイル名] 入力ファイル

DESCRIPTION

ncgen3 netCDF ファイル、または netCDF を作成するための C または Fortran ソース コードを生成します。
ファイル。 への入力 ncgen3 として知られる小さな言語での netCDF ファイルの記述です。
CDL (ネットワーク共通データ形式言語)、以下で説明します。 オプションを指定しない場合
呼び出す ncgen3、入力 CDL ファイルの構文をチェックするだけで、エラーが発生します。
CDL 構文の違反に関するメッセージ。 他のオプションを使用して、
対応する netCDF ファイルを使用して、netCDF C インターフェイスを使用する C プログラムを生成します。
netCDF ファイルを作成するか、netCDF Fortran を使用する Fortran プログラムを生成します。
インターフェイスを使用して同じ netCDF ファイルを作成します。

ncgen3 コンパニオン プログラムと一緒に使用できます ncdump いくつかの簡単な操作を実行するには
netCDF ファイル。 たとえば、netCDF ファイル内のディメンションの名前を変更するには、次を使用します。 ncdump 取得するため
NetCDF ファイルの CDL バージョン。CDL ファイルを編集してディメンションの名前を変更します。
使用する ncgen3 編集した CDL ファイルから対応する netCDF ファイルを生成します。

OPTIONS

-b (バイナリ) netCDF ファイルを作成します。 もし -o オプションが存在しないため、デフォルトのファイル名が使用されます
netCDF 名 (後に指定される) から構築されます。 netcdf のキーワード
input) 拡張子「.nc」を追加します。 ファイルが既に存在する場合は、
指定した名前は上書きされます。

-c 生成する C netCDF に一致する netCDF ファイルを作成するソース コード
仕様。 C ソース コードは標準出力に書き込まれます。

-f 生成する Fortran netCDF に一致する netCDF ファイルを作成するソース コード
仕様。 Fortran ソース コードは標準出力に書き込まれます。

-o netcdf_file
作成されたバイナリ netCDF ファイルの名前。 このオプションが指定されている場合、それは暗黙的に
"-b" オプション。(netCDF ファイルを書き込むことができないため、このオプションは必要です)
標準出力はシークできないため、標準出力に直接出力されます。)

-k ファイルの種類
-k2 または -k "64 ビット オフセット" を使用すると、生成されるファイル (またはプログラム) が
2 ビット ファイル オフセットを使用する形式のバージョン 64 を使用します。 デフォルトでは使用します
1 ビット ファイル オフセットを持つバージョン 32 (「クラシック」) 形式ですが、これにより、
netCDF ファイル、変数、レコードのサイズを、
クラシックなフォーマット。 (NetCDF-4 は追加の種類の netCDF ファイルをサポートします。
「netCDF-4」および「netCDF-4 クラシック モデル」。) 注: -v は、
下位互換性を保つための -k と同じですが、一致させるには -k が推奨されます。
対応する ncdump オプション。

-x データを塗りつぶし値で初期化しないでください。 これにより、大規模な netCDF の作成を高速化できます。
ファイルは大きく保存されますが、後で生成されたファイルから書き込まれていないデータを読み取ろうとします
簡単には検出できなくなります。

例

CDL ファイルの構文を確認してください `foo.cdl':

ncgen3 foo.cdl

CDL ファイルから `foo.cdl'、' という名前の同等のバイナリ netCDF ファイルを生成します。x.nc':

ncgen3 -o x.nc foo.cdl

CDL ファイルから `foo.cdl'、netCDF 関数を含む C プログラムを生成します
` という名前の同等のバイナリ netCDF ファイルを作成するために必要な呼び出しx.nc':

ncgen3 -c -o x.nc foo.cdl

USAGE

CDL 構文 まとめ
以下は、いくつかの名前付きディメンションを含む netCDF ファイルを記述する CDL 構文の例です。
(緯度、経度、時間)、変数 (Z、t、p、rh、緯度、経度、時間)、変数属性 (単位、
long_name、valid_range、_FillValue)、およびいくつかのデータ。 CDL キーワードは太字で示されています。 （これ
例は構文を説明することを目的としています。 実際の CDL ファイルには、より完全なファイルが含まれます。
データがより完全に自己記述的になるように一連の属性を使用します。)

netcdf foo { // CDL での netCDF 仕様の例

大きさ:
緯度 = 10、経度 = 5、時間 = 無限の ;

variables:
長い lat(緯度)、lon(経度)、time(時間);
フロート Z(時間、緯度、経度)、t(時間、緯度、経度);
p(時間、緯度、経度);
長い rh(時間、緯度、経度);

// 変数の属性
lat:long_name = "緯度";
緯度:単位 = "北の度";
lon:long_name = "経度";
lon:units = "度_東";
time:units = "1992-1-1 00:00:00 からの秒数";
Z:units = "地電位メートル";
Z:valid_range = 0.、5000.;
p:_FillValue = -9999.;
rh:_FillValue = -1;

データ:
緯度 = 0、10、20、30、40、50、60、70、80、90;
lon = -140、-118、-96、-84、-52;
}

すべての CDL ステートメントはセミコロンで終了します。 スペース、タブ、改行が使用可能
読みやすさのために自由に。 どの行でも文字 `//' の後にコメントを続けることができます。

CDL 記述は、次の XNUMX つのオプションの部分で構成されます。 大きさ, variables, データ,
キーワードから始まる 寸法：, 変数：, データ、 それぞれ。 変数
部分に含まれる可能性があります 変数 宣言 と 属性を使用する。 割り当て.

netCDF 寸法 XNUMX つ以上の多次元の形状を定義するために使用されます。
netCDF ファイルに含まれる変数。 netCDF ディメンションには名前とサイズがあります。 で
netCDF ファイル内のほとんどの XNUMX つのディメンションには、 無限の サイズ、つまり変数
このディメンションを使用すると、任意の長さに拡張できます (ファイル内のレコード番号など)。

A 変数 同じ型の値の多次元配列を表します。 変数には、
名前、データ型、および次元のリストによって記述される形状。 各変数は、
も関連付けています 属性 (以下を参照) およびデータ値も含まれます。 名前、データ型、
変数の形状と形状は、 変数 CDL のセクション
説明。 変数はディメンションと同じ名前を持つことができます。 慣例によりそのような
変数は XNUMX 次元であり、変数が指定する次元の座標が含まれます。
ディメンションには対応する変数がある必要はありません。

netCDF 属性を使用する。 netCDF 変数または netCDF 全体に関する情報が含まれています
データセット。 属性は、単位、特別な値、最大値などのプロパティを指定するために使用されます。
有効な最小値、スケーリング係数、オフセット、パラメータ。 属性情報
単一の値または値の配列で表されます。 たとえば、「単位」は属性です。
「celsius」などの文字配列で表されます。 属性には関連付けられています
変数、名前、データ型、長さ、および値。 変数とは対照的に、
属性はデータを目的としており、属性はメタデータ (データに関するデータ) を目的としています。

CDL では、属性は変数と属性名を `:' で区切って指定します。 それ
割り当てることが可能です 全体的な netCDF のどの変数にも関連付けられていない属性は、
属性名の前に「:」を使用して全体を指定します。 CDL の属性のデータ型は次のとおりです。
割り当てられた値の型から派生します。 属性の長さは
割り当てられているデータ値の数、または文字列内の文字数
それに割り当てられています。 文字以外の属性には複数の値を区切って割り当てます。
カンマ付きの値。 属性に割り当てられるすべての値は同じタイプである必要があります。

CDL ディメンション、変数、属性の名前はアルファベットで始まる必要があります
文字または「_」、その後の文字は英数字、「_」、または「-」です。

オプション データ CDL 仕様のセクションには、netCDF 変数が存在する可能性があります。
初期化された。 初期化の構文は単純です: 変数名、等号、
およびカンマで区切られた定数のリスト (スペース、タブ、改行で区切られる場合もあります)
セミコロンで終了します。 多次元配列の場合、最後の次元は異なります
最速。 したがって、行列には​​列の順序ではなく行の順序が使用されます。 値が少ない場合
変数を埋めるために必要な以上のものが指定された場合、型に依存する拡張子で拡張されます。
「fill value」。識別された変数の値を指定することでオーバーライドできます。
`_FillValue' という名前の属性。 定数の型は、宣言された型と一致する必要はありません。
変数; 強制は、たとえば、整数を浮動小数点に変換するために行われます。 の
定数 `_' を使用して、変数の埋め込み値を指定できます。

プリミティブ Rescale データ 種類
チャリオット 文字
バイト 8ビットデータ
短い 16 ビットの符号付き整数
長い 32 ビットの符号付き整数
int型 (と同義 長い)
フロート IEEE 単精度浮動小数点 (32 ビット)
リアル (と同義 フロート)
IEEE 倍精度浮動小数点 (64 ビット)

追加されたデータ型を除く バイト そして欠如 署名されていない、CDL も同様にサポートしています
C のプリミティブ データ型。プリミティブ データ型の名前は、
CDL なので、変数、ディメンション、属性の名前は型名であってはなりません。 の
宣言では、型名は大文字でも小文字でも指定できます。

バイトは、完全な XNUMX ビットのデータを保持することを目的としているという点で文字とは異なります。
ゼロバイトには、文字データの場合と同様に特別な意味はありません。 ncgen3
変換する バイト への宣言 チャリオット 出力 C コード内の宣言と
非標準 BYTE 出力 Fortran コード内の宣言。

Short は -32768 ～ 32767 の値を保持できます。 ncgen3 変換する 短い への宣言
短い 出力 C コード内および非標準への宣言 整数*2 の宣言
Fortran コードを出力します。

Long 型は、-2147483648 から 2147483647 までの値を保持できます。 ncgen3 変換する 長い
への宣言 長い 出力 C コード内の宣言と 整数 での宣言
Fortran コードを出力します。 int型 と 整数 の同義語として受け入れられます 長い CDLで
宣言。 C の Long の 64 ビット表現を備えたプラットフォームが存在するようになりました。
を使用した方が良いかもしれません int型 混乱を避けるための同義語。

Float は、約 -3.4+38 から 3.4+38 までの値を保持できます。 それらの外部表現は、
32 ビット IEEE 正規化単精度浮動小数点数として。 ncgen3 変換する フロート
への宣言 フロート 出力 C コード内の宣言と リアル 出力内の宣言
フォートランコード。 リアル ～の同義語として受け入れられています フロート CDL 宣言で。

Double は、約 -1.7+308 から 1.7+308 までの値を保持できます。 彼らの外部表現
64 ビット IEEE 標準の正規化倍精度浮動小数点数です。 ncgen3
変換する への宣言 出力 C コード内の宣言と ダブル
精度 出力 Fortran コード内の宣言。

CDL 定数
属性または変数に割り当てられる定数は、基本的な netCDF タイプのいずれかになります。
定数の構文は C の構文と似ていますが、型の接尾辞が
ロングやダブルと区別するために、ショートやフロートに追加されます。

A バイト 定数は単一文字または複数文字のエスケープ シーケンスで表されます。
一重引用符で囲みます。 例えば、
'a' // ASCII 'a'
'\0' // ゼロバイト
'\n' // ASCII 改行文字
'\33' // ASCII エスケープ文字 (33 進数の XNUMX)
'\x2b' // ASCII プラス (2b hex)
'\377' // 377 進数の 255 = XNUMX 進数の XNUMX、非 ASCII

文字定数は二重引用符で囲みます。 文字配列を表現できる
二重引用符で囲まれた文字列として。 通常の C 文字列エスケープ規則が尊重されます。
例えば、
"a" // ASCII `a'
"Two\nlines\n" // 10 つの改行が埋め込まれた XNUMX 文字の文字列
"a bell:\007" // ASCII ベルを含む文字列
netCDF 文字配列「a」は XNUMX 要素変数に収まることに注意してください。
終端は NULL 文字とみなされます。 ただし、文字配列内のゼロバイトは
によって重要な文字の終わりとして解釈されます。 ncdump プログラムに従って、
C 規約。 したがって、次の場合を除き、文字列に NULL バイトを埋め込まないでください。
最後に: を使用します バイト ゼロバイトを含むバイト配列の代わりにデータ型を使用します。
NetCDF と CDL には文字列型はなく、固定長の文字配列のみがあります。
多次元。

短い 整数定数は、16 ビットの符号付き量を表すことを目的としています。 フォーム
の 短い constant は、`s' または `S' が追加された整数定数です。 もし 短い
定数が `0' で始まる場合、それが `0x' で始まる場合を除き、XNUMX 進数として解釈されます。
XNUMX 進定数として解釈されます。 例えば：
-2s // 短い -2
0123s // XNUMX進数
0x7ffs //XNUMX進数

長い 整数定数は、32 ビットの符号付き量を表すことを目的としています。 フォーム
の 長い constant は通常の整定数ですが、
オプションの `l' または `L'。 もし 長い 定数は「0」で始まり、XNUMX 進数として解釈されます。
ただし、「0x」で始まる場合は XNUMX 進定数として解釈されます。 例
有効な 長い 定数には次のものが含まれます。
-2
1234567890L
0123 // XNUMX進数
0x7ff // XNUMX進数

次の型の浮動小数点定数 フロート 浮動小数点を表すのに適しています
有効数字約 XNUMX 桁の精度を持つデータ。 の形 フロート 定数は
C の浮動小数点定数に「f」または「F」を付加したものと同じです。 たとえば、
以下はすべて許容されます フロート 定数:
-2.0f
3.14159265358979f // 精度が低くなるように切り捨てられます
1.F

次の型の浮動小数点定数 浮動小数点を表すのに適しています
有効数字約 XNUMX 桁の精度を持つデータ。 の形 定数は
C の浮動小数点定数と同じです。 オプションの「d」または「D」を追加できます。 ために
例: 以下はすべて許容されます 定数:
-2.0
3.141592653589793
1.0e-20
1D

onworks.net サービスを使用してオンラインで ncgen3 を使用する