Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

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);

info.numVars

ans =

  5

% Determine if the first variable has dimensions.
varinfo = cdflib.inquireVar(cdfid,0);
vardims = varinfo.dims
vardims =

  []

% Get data from variable, without specifying dimensions.
datum = cdflib.getVarData(cdfid, varnum, recnum) 

datum =

  6.3146e+013

% Get dimensions of another variable in file.
varinfo = cdflib.inquireVar(cdfid,3);
vardims = varinfo.dims
vardims =

  [4 2 2]

% Retrieve the first datum in the record. Indices are zero-based.
datum = cdflib.getVarData(cdfId,3,0,[0 0 0])

info =

    30

% Clean up.
cdflib.close(cdfid);
clear cdfid

参照

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

この関数を使用するには、CDF C インターフェイスに関する知識を必要とします。CDF website にある CDF のドキュメンテーションを参照してください。

著作権に関する情報は、cdfcopyright.txt ファイルを参照してください。