cdflib.createVar

新しい変数の作成

構文

varnum = cdflib.createVar(cdfId, varname, datatype, numElements, dims, recVariance, dimVariance)


説明

varnum = cdflib.createVar(cdfId, varname, datatype, numElements, dims, recVariance, dimVariance) は、新しい変数を指定された特性で CDF (Common Data Format) ファイルに作成します。

入力引数

cdfId	関数 cdflib.create または関数 cdflib.open の呼び出しによって返される、CDF ファイル識別子。
varname	変数に割り当てる名前を指定する文字ベクトルまたは string スカラー。
datatype	変数のデータ型。次の有効な CDF データ型を含む文字ベクトルまたは string スカラーのいずれか、あるいはその等価な数値として指定します。 CDF データ型 説明 'CDF_BYTE 1 バイト符号付き整数 'CDF_CHAR' MATLAB® の char または string クラスにマッピングされる、1 バイト符号付き文字データ型 'CDF_INT1' 1 バイト符号付き整数 'CDF_UCHAR' MATLAB の uint8 クラスに割り当てられる、1 バイト符号なし整数データ型 'CDF_UINT1' 1 バイト符号なし整数 'CDF_INT2' 2 バイト符号付き整数 'CDF_UINT2' 2 バイト符号なし整数 'CDF_INT4' 4 バイト符号付き整数 'CDF_UINT4' 4 バイト符号なし整数 'CDF_FLOAT' 4 バイト浮動小数点数 'CDF_REAL4' 4 バイト浮動小数点数 'CDF_REAL8' 8 バイト浮動小数点数。 'CDF_DOUBLE' 8 バイト浮動小数点数 'CDF_EPOCH' 8 バイト浮動小数点数 'CDF_EPOCH16' 2 つの 8 バイト浮動小数点数
numElements	データあたりの要素数。'CDF_CHAR' および 'CDF_UCHAR' を除くすべてデータ型について、値は 1 でなければなりません。
dims	次元の範囲のベクトル。次元の範囲がない場合は空になります。
recVariance	レコード変動を指定します。true または false という 2 つの文字のいずれかで表します。
dimVariance	論理のベクトル値。次元がない場合は空です。

出力引数

varNum

変数の数値識別子。変数番号は 0 ベースです。

例

CDF ファイルを作成し、'Time' という名前の変数を CDF に作成します。変数には次元がなく、レコードとともに変わります。この例を実行するためには、書き込み可能なフォルダーに移動します。

cdfid = cdflib.create('your_file.cdf');

% Initially the file contains no variables.
info = cdflib.inquire(cdfid)

info = 

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 0
    numvAttrs: 0
    numgAttrs: 0

% Create a variable in the file.
varNum = cdflib.createVar(cdfid,'Time','cdf_int1',1,[],true,[]);

% Retrieve info about the file again to verify variable was created. 
% Note value of numVars field is now 1.
info = cdflib.inquire(cdfid)

info = 

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 1
    numvAttrs: 0
    numgAttrs: 0

% Clean up
cdflib.delete(cdfid);

clear cdfid

参照

この関数は、CDF ライブラリ C API のルーチン CDFcreatezVar に相当します。

この関数を使用するには、CDF C インターフェイスに関する知識を必要とします。CDF のドキュメンテーションは CDF の Web サイトで参照できます。

参考

cdflib.deleteVar | cdflib.closeVar

トピック

• 低水準関数による CDF ファイルのインポート
• CDF ファイルへのエクスポート