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

プログラム：

NAME

mincgen - CDL ファイルから MINC ファイルを生成します.

SYNOPSIS

mincgen [-b] [-n] [-o minc_ファイル名] 入力ファイル

DESCRIPTION

ミンゲン MINC ファイルを生成します。 への入力 ミンゲン は、MINC ファイルの記述です。
以下で説明するCDL（ネットワーク共通データフォーム言語）として知られる小さな言語。 いいえ
オプションは呼び出し時に指定されます ミンゲン、入力CDLの構文をチェックするだけです
ファイルで、CDL 構文の違反に対してエラー メッセージが生成されます。 他のオプションは
対応する MINC ファイルの作成に使用されます。

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

OPTIONS

-b (バイナリ) MINC ファイルを作成します。 もし -o オプションがない場合、デフォルトのファイル名が使用されます
MINC 名から構築されます ( netcdf or HDF5 のキーワード
入力) に `.mnc' 拡張子を追加します。 でファイルがすでに存在する場合
指定した名前は上書きされます。

-o minc_ファイル名
作成されたバイナリ MINC ファイルの名前。 このオプションを指定すると、
"-b" オプション (MINC ファイルは書き込めないため、このオプションは必須です。
標準出力はシークできないため、標準出力に直接出力されます。)

例

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

mincgen foo.cdl

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

mincgen -o x.mnc foo.cdl

USAGE

CDL 構文 まとめ
以下は、複数の名前付き次元を持つ MINC ファイルを記述する CDL 構文の例です。
(xspace、yspace、および zspace)、変数 (zspace、image)、変数属性 (valid_range、
signtype)、およびいくつかのデータ。 CDL キーワードは太字で示しています。 (この例は、
構文を示します。 実際の CDL ファイルには、より完全な属性セットがあるため、
データがより完全に自己記述的であること。)

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

大きさ:
xspace = 8;
yspace = 8;
zspace = 5;

variables:
フロート xスペース;
フロート yスペース;
フロート zspace(zspace);
短い 画像 (zspace,yspace,xspace);
画像分(zspace)
画像最大(zspace)

// 変数の属性
画像: 有効な範囲 = 0,5;
データ:
image-min = -1,-1,-1,-1,-1;
画像最大 = 1,1,1,1,1;
画像 =
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0、
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0、
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1、
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1、
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2、
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2、
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3、
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3、
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5、
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5。
zspace = 0,2,3.5,7,10;
}

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

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

Aミンク 寸法 XNUMX つ以上の多次元の形状を定義するために使用されます。
MINC ファイルに含まれる変数。 MINC 次元には、名前、サイズ、場合によっては
他のいくつかの属性。

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

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

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

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

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

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

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

バイトは、完全な XNUMX ビットのデータを保持することを目的としているという点で文字とは異なります。
ゼロバイトには、文字データの場合と同様に特別な意味はありません。

Short は -32768 ～ 32767 の値を保持できます。

Long 型は、-2147483648 から 2147483647 までの値を保持できます。 int型 & 整数 として受け入れられます
の同義語 長い CDL宣言で。 64ビットのプラットフォームがある今
C long の表現では、 int型 混乱を避けるための同義語。

Float は、約 -3.4+38 から 3.4+38 までの値を保持できます。 それらの外部表現は、
32 ビット IEEE 正規化単精度浮動小数点数として。 リアル として受け入れられます
の同義語 フロート CDL 宣言で。

Double は、約 -1.7+308 から 1.7+308 までの値を保持できます。 彼らの外部表現
64 ビット IEEE 標準の正規化倍精度浮動小数点数です。

CDL 定数
属性または変数に割り当てられる定数は、基本的な MINC 型のいずれかです。 の
定数の構文は、型サフィックスを追加する必要があることを除いて、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 ベルを含む文字列
文字配列 "a" は XNUMX 要素の変数に収まることに注意してください。
終端は NULL 文字とみなされます。 ただし、文字配列内のゼロバイトは
によって重要な文字の終わりとして解釈されます。 ミンクダンプ プログラム、以下
C 規約。 したがって、文字列中にNULLバイトを埋め込まないでください。
最後以外の場合: を使用します。 バイト ゼロを含むバイト配列の代わりのデータ型
バイト。 MINC と 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 サービスを使用してオンラインで mincgen を使用する