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("your_file.cdf");

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

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

    'NO_COMPRESSION'


params =

     []


percent =

   100
% Specify the compression used by the variable
cdflib.setVarCompression(cdfId,0,"GZIP_COMPRESSION",8)

% Check the new 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 サイトで参照できます。

参考

|

トピック