Main Content

cdflib.setVarCompression

指定用于变量的压缩设置

语法

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

说明

cdflib.setVarCompression(cdfId,varNum,ctype,cparams) 配置常用数据格式 (CDF) 文件中的变量的压缩设置。

输入参数

cdfId

CDF 文件的标识符,通过调用 cdflib.createcdflib.open 返回。

varNum

标识文件中的变量的数值。变量标识符(变量编号)从 0 开始。

ctype

以下用于指定压缩类型的字符向量或字符串标量之一或其等效数值。

压缩类型
'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 文档。