cdflib.getVarData
変数のレコードの単一値
構文
datum = cdflib.getVarData(cdfId,varNum,recNum,indices)
datum = cdflib.getVarData(cdfId,varNum,recNum)
説明
datum = cdflib.getVarData(cdfId,varNum,recNum,indices)
は、CDF (Common Data Format) ファイル内の変数から単一の値を返します。
datum = cdflib.getVarData(cdfId,varNum,recNum)
は、CDF (Common Data Format) ファイル内の次元のない変数から単一の値を返します。
入力引数
|
関数 |
|
データを含む変数を識別する数値。変数番号は 0 ベースです。 |
|
変数内のデータの場所を識別する数値。CDF 用語では、これは "レコード番号" と呼ばれます。レコード番号は 0 ベースです。 |
|
レコード内の次元インデックスの配列。次元のインデックス値は 0 ベースです。変数に次元がない場合は、このパラメーターを省略できます。 |
出力引数
|
指定されたレコードの値。 |
例
例の CDF ファイルを開き、変数に関連付けられているデータを取得します。
cdfId = cdflib.open("example.cdf"); % Determine how many variables are in the file info = cdflib.inquire(cdfId); numVars = info.numVars
numVars = 6
% Determine if the first variable has dimensions
varnum = 0;
varinfo = cdflib.inquireVar(cdfId,varnum);
vardims = varinfo.dims
vardims = []
% Get first data record from variable, without specifying dimensions
recnum = 0;
datum = cdflib.getVarData(cdfId,varnum,recnum)
datum = 6.3146e+13
% Get dimensions of another variable in file
varnum = 3;
varinfo = cdflib.inquireVar(cdfId,varnum);
vardims = varinfo.dims
vardims = 4 2 2
% Retrieve the first datum in the record (indices are zero-based)
datum = cdflib.getVarData(cdfId,varnum,recnum,[0 0 0])
datum = 30
% Clean up cdflib.close(cdfId) clear cdfId
参照
この関数は、CDF ライブラリ C API のルーチン CDFgetzVarData
に相当します。
この関数を使用するには、CDF C インターフェイスに関する知識を必要とします。CDF のドキュメンテーションは CDF の Web サイトで参照できます。