Main Content

cdflib.hyperGetVarData

変数からのデータのハイパースラブの読み取り

構文

data = cdflib.hyperGetVarData(cdfId,varNum,recSpec,dimSpec)
data = cdflib.hyperGetVarData(cdfId,varNum,recSpec)

説明

data = cdflib.hyperGetVarData(cdfId,varNum,recSpec,dimSpec) は、CDF (Common Data Format) ファイル内の変数からデータのハイパースラブを読み取ります。ハイパー アクセスを使用すると、CDF ライブラリを 1 回呼び出すことで、変数に対して複数の値を読み書きできます。

data = cdflib.hyperGetVarData(cdfId,varNum,recSpec) は、CDF (Common Data Format) ファイル内の 0 次元変数のデータのハイパースラブを読み取ります。

入力引数

cdfId

関数 cdflib.create または関数 cdflib.open の呼び出しによって返される、CDF ファイル識別子。

varNum

データを含む変数を識別する数値。

recSpec

3 要素配列 [RSTART RCOUNT RSTRIDE] です。ここで、RSTARTRCOUNT、および RSTRIDE は、それぞれ開始レコード、読み取るレコード数、およびサンプリング間隔またはレコード間の幅を指定するスカラー値です。レコード番号は 0 ベースです。

dimSpec

3 要素 cell 配列 {DSTART DCOUNT DSTRIDE} です。ここで、DSTARTDCOUNT、および DSTRIDE は、それぞれ開始、各次元に沿った値の数、および各次元に沿ったサンプリング間隔を表す n 要素のベクトルです。ハイパースラブにゼロ次元がある場合は、このパラメーターを省略できます。次元のインデックス値は 0 ベースです。

例の CDF ファイルを開き、変数に関連付けられているすべてのデータを取得します。

cdfId = cdflib.open("example.cdf");

% Determine number of records allocated for first variable in the file
maxRecNum = cdflib.getVarMaxWrittenRecNum(cdfId,0);

% Retrieve all data in records for variable
data = cdflib.hyperGetVarData(cdfId,0,[0 maxRecNum 1])
data =

   1.0e+13 *

    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
    6.3146
% Clean up
cdflib.close(cdfId)
clear cdfId

参照

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

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

バージョン履歴

すべて展開する