Main Content

cdflib.hyperPutVarData

データのハイパースラブの変数への書き込み

構文

cdflib.hyperPutVarData(cdfId,varNum,recSpec,dimSpec,data)

説明

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

入力引数

cdfId

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

varNum

データを含む変数を指定します。

recSpec

[RSTART RCOUNT RSTRIDE] によって記述される 3 要素配列です。ここで、RSTARTRCOUNT、および RSTRIDE は、それぞれ開始、レコード数、およびレコード間のサンプリング間隔 (または幅) を指定するスカラー値です。レコードのインデックス値は 0 ベースです。

dimSpec

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

data

変数に書き込むデータ。

CDF を作成し、変数を作成したら、データのスラブを変数に書き込みます。この例を実行するためには、書き込み可能なフォルダーに移動します。

cdfid = cdflib.create('your_file.cdf');

% Create a variable in the file.
varNum = cdflib.createVar(cdfid,'Grades','cdf_int1',1,[],true,[]);

% Write data to the variable
cdflib.hyperPutVarData(cdfid,varNum,0,[],int8(98))


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

参照

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

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