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) ファイル内の次元のない変数から単一の値を返します。

`cdfId`	関数 `cdflib.create` または関数 `cdflib.open` の呼び出しによって返される、CDF ファイル識別子。
`varNum`	データを含む変数を識別する数値。変数番号は 0 ベースです。
`recNum`	変数内のデータの場所を識別する数値。CDF 用語では、これは "レコード番号" と呼ばれます。レコード番号は 0 ベースです。
`indices`	レコード内の次元インデックスの配列。次元のインデックス値は 0 ベースです。変数に次元がない場合は、このパラメーターを省略できます。

datum

指定されたレコードの値。

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

変数 CDF_INT8 および CDF_TIME_TT2000 の読み取りができます。