本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

cdflib

与 CDF 库直接交互

说明

MATLAB® 提供对 CDF 库中数十种函数的直接访问。使用这些函数时,您可以读取和写入数据,创建变量、属性和项,以及利用 CDF 库的其他功能。要使用这些函数,必须熟悉 CDF C 接口。可以在 CDF 网站找到有关 CDF 的文档。

MATLAB 函数对应于 CDF 库的新标准接口中的函数。在大多数情况下,MATLAB 函数的语法类似于对应的 CDF 库函数的语法。要使用这些函数,必须使用包名称 cdflib 作为函数名称的前缀。例如,要使用 CDF 库函数打开现有的 CDF 文件,可以使用以下语法:

cdfid = cdflib.open('example.cdf');

MATLAB 支持 CDF 版本 3.6.1。有关版权信息,请参阅 cdfcopyright.txt 文件。

下表列出了 MATLAB CDF 库程序包中的所有函数,并按类别分组。

库信息

cdflib.getConstantNames常用数据格式 (CDF) 库常量的名称
cdflib.getConstantValue与常用数据格式 (CDF) 库常量对应的数值
cdflib.getFileBackward返回当前的向后兼容模式设置
cdflib.getLibraryCopyright常用数据格式 (CDF) 库的版权声明
cdflib.getLibraryVersion库版本和发行信息
cdflib.getValidate库验证模式
cdflib.setFileBackward设置向后兼容模式
cdflib.setValidate指定库验证模式

文件操作

cdflib.close关闭常用数据格式 (CDF) 文件
cdflib.create创建常用数据格式 (CDF) 文件
cdflib.delete删除现有的常用数据格式 (CDF) 文件
cdflib.getCacheSize已使用的高速缓存缓冲区的数目
cdflib.getChecksum校验和模式
cdflib.getCompression压缩设置
cdflib.getCompressionCacheSize压缩高速缓存缓冲区的数目
cdflib.getCopyright常用数据格式 (CDF) 文件中的版权声明
cdflib.getFormat常用数据格式 (CDF) 文件的格式
cdflib.getMajority大多数变量
cdflib.getName常用数据格式 (CDF) 文件的名称
cdflib.getReadOnlyMode只读模式
cdflib.getStageCacheSize用于暂存的高速缓存缓冲区的数目
cdflib.getVersion常用数据格式 (CDF) 库版本和发行信息
cdflib.inquire常用数据格式 (CDF) 文件的基本特征
cdflib.open打开现有的常用数据格式 (CDF) 文件
cdflib.setCacheSize指定 dotCDF 高速缓存缓冲区的数目
cdflib.setChecksum指定校验和模式
cdflib.setCompression指定压缩设置
cdflib.setCompressionCacheSize指定压缩高速缓存缓冲区的数目
cdflib.setFormat指定常用数据格式 (CDF) 文件的格式
cdflib.setMajority指定大多数变量
cdflib.setReadOnlyMode指定只读模式
cdflib.setStageCacheSize为常用数据格式 (CDF) 文件指定暂存高速缓存缓冲区的数目

变量

cdflib.SetVarReservePercent指定变量的保留百分比
cdflib.closeVar关闭多文件格式的常用数据格式 (CDF) 文件中的指定变量
cdflib.createVar创建新变量
cdflib.deleteVar删除变量
cdflib.deleteVarRecords删除变量中的各种记录
cdflib.getVarAllocRecords为变量分配的记录数
cdflib.getVarBlockingFactor变量的分块因子
cdflib.getVarCacheSize多文件高速缓存缓冲区的数目
cdflib.getVarCompression有关变量使用的压缩的信息
cdflib.getVarData来自变量中的记录的单个值
cdflib.getVarMaxAllocRecNum为变量分配的最大记录数
cdflib.getVarMaxWrittenRecNum为变量写入的最大记录数
cdflib.getVarName变量名称,给定了变量编号
cdflib.getVarNum变量编号,给定了变量名称
cdflib.getVarNumRecsWritten写入变量的记录数
cdflib.getVarPadValue变量的填充值
cdflib.getVarRecordData变量的整个记录
cdflib.getVarReservePercent变量的压缩保留百分比
cdflib.getVarSparseRecords有关变量处理稀疏记录的方式的信息
cdflib.getVarsMaxWrittenRecNum为 CDF 文件写入的最大记录数
cdflib.hyperGetVarData读取变量中的数据超切片
cdflib.hyperPutVarData将数据超切片写入到变量
cdflib.inquireVar有关变量的信息
cdflib.putVarData将单个值写入变量
cdflib.putVarRecordData将整个记录写入到变量
cdflib.renameVar重命名现有变量
cdflib.setVarAllocBlockRecords指定要为变量分配的记录范围
cdflib.setVarBlockingFactor指定变量的分块因子
cdflib.setVarCacheSize为变量指定多文件高速缓存缓冲区的数目
cdflib.setVarCompression指定用于变量的压缩设置
cdflib.setVarInitialRecs指定要写入变量的初始记录数
cdflib.setVarPadValue指定用于变量的填充值
cdflib.setVarSparseRecords指定变量处理稀疏记录的方式
cdflib.setVarsCacheSize指定用于所有变量的高速缓存缓冲区的数目

属性

cdflib.createAttr创建属性
cdflib.deleteAttr删除属性
cdflib.deleteAttrEntry删除属性条目
cdflib.deleteAttrgEntry删除全局属性中的条目
cdflib.getAttrEntry具有可变范围的属性中条目的值
cdflib.getAttrMaxEntry可变属性的最后一个条目的编号
cdflib.getAttrMaxgEntry全局属性的最后一个条目的编号
cdflib.getAttrName属性的名称,给定了属性编号
cdflib.getAttrNum属性编号,给定了属性名称
cdflib.getAttrScope属性的范围
cdflib.getAttrgEntry全局属性中条目的值
cdflib.getNumAttrEntries具有可变范围的属性的条目数
cdflib.getNumAttrgEntries具有全局范围的属性的条目数
cdflib.getNumAttributes具有可变范围的属性的数目
cdflib.getNumgAttributes具有全局范围的属性的数目
cdflib.inquireAttr有关属性的信息
cdflib.inquireAttrEntry有关具有可变范围的属性中的条目的信息
cdflib.inquireAttrgEntry有关具有全局范围的属性中的条目的信息
cdflib.putAttrEntry将值写入具有可变范围的属性中的条目
cdflib.putAttrgEntry将值写入具有全局范围的属性中的条目
cdflib.renameAttr重命名现有属性

工具函数

cdflib.computeEpoch将时间值转换为 CDF_EPOCH
cdflib.computeEpoch16将时间值转换为 CDF_EPOCH16
cdflib.epoch16BreakdownCDF_EPOCH16 值转换为时间值
cdflib.epochBreakdownCDF_EPOCH 值转换为时间值

局限性

  • CDF 文件不支持采用非 ASCII 字符编码的输入。变量名称、属性名称、变量值和属性值必须采用 7 位 ASCII 编码。尝试写入采用非 ASCII 字符编码的输入将发生错误或者导致数据中包含损坏的字符。

  • CDF 库 3.6.1 版不支持数据类型 CDF_TIME_TT2000CDF_INT8