Main Content

cdflib.setVarCompression

変数で使用する圧縮設定の指定

構文

cdflib.setVarCompression(cdfId,varNum,ctype,cparams)

説明

cdflib.setVarCompression(cdfId,varNum,ctype,cparams) は、CDF (Common Data Format) ファイル内の変数の圧縮設定を設定します。

入力引数

cdfId

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

varNum

ファイルでの変数を識別する数値。変数識別子 (変数番号) は 0 ベースです。

ctype

圧縮タイプを指定する次の文字ベクトルまたは string スカラーのいずれか、あるいはその等価な数値。

圧縮タイプ
'NO_COMPRESSION'圧縮なし
'RLE_COMPRESSION'連長圧縮
'HUFF_COMPRESSION'ハフマン圧縮
'AHUFF_COMPRESSION'適応ハフマン圧縮
'GZIP_COMPRESSION'GNU の zip 圧縮

これらの圧縮タイプ値に等価な数値を取得するには、cdflib.getConstantValue を使用します。

cparams

圧縮タイプで必要となる追加のパラメーターを指定するオプションのパラメーター。現在、このパラメーターを使用する圧縮タイプは、'GZIP_COMPRESSION' のみです。この圧縮タイプの場合は、cparms を使用して、圧縮のレベルを 1 ~ 9 の数値で指定します。

CDF を作成し、変数を作成したら、変数で使用される圧縮を設定します。この例を実行するためには、実行権限をもつフォルダーに移動します。

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

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

% Specify the compression used by the variable.
cdflib.setVarCompression(cdfid,0,'GZIP_COMPRESSION',8)

% Check the compression setting of the variable
[ctype params percent] = cdflib.getVarCompression(cdfid,0)

ctype =

GZIP_COMPRESSION

params =

     8

percent =

     0

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

参照

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

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