Main Content

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_BYTE1 バイト符号付き整数
'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 = 

  struct with fields:

     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 = 

  struct with fields:

     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 サイトで参照できます。