Main Content

cdflib.getVarData

来自变量中的记录的单个值

语法

datum = cdflib.getVarData(cdfId,varNum,recNum,indices)
datum = cdflib.getVarData(cdfId,varNum,recNum)

说明

datum = cdflib.getVarData(cdfId,varNum,recNum,indices) 返回来自常用数据格式 (CDF) 文件中的变量的单个值。

datum = cdflib.getVarData(cdfId,varNum,recNum) 返回来自常用数据格式 (CDF) 文件中没有维度的变量的单个值。

输入参数

cdfId

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

varNum

标识包含数据的变量的数值。变量编号从 0 开始。

recNum

数值,用于标识变量中的数据位置。在 CDF 术语中,这称为记录编号。记录编号从 0 开始。

indices

记录中由维度索引组成的数组。维度索引从 0 开始。如果变量没有任何维度,则可以省略此参数。

输出参量

datum

指定记录的值。

示例

打开示例 CDF 文件并检索与变量关联的数据:

cdfId = cdflib.open("example.cdf");

% Determine how many variables are in the file
info = cdflib.inquire(cdfId);
numVars = info.numVars
numVars =

     6
% Determine if the first variable has dimensions
varnum = 0;
varinfo = cdflib.inquireVar(cdfId,varnum);
vardims = varinfo.dims
vardims =

     []
% Get first data record from variable, without specifying dimensions
recnum = 0;
datum = cdflib.getVarData(cdfId,varnum,recnum)
datum =

   6.3146e+13
% Get dimensions of another variable in file
varnum = 3;
varinfo = cdflib.inquireVar(cdfId,varnum);
vardims = varinfo.dims
vardims =

     4     2     2
% Retrieve the first datum in the record (indices are zero-based)
datum = cdflib.getVarData(cdfId,varnum,recnum,[0 0 0])
datum =

    30
% Clean up
cdflib.close(cdfId)
clear cdfId

参考

此函数对应于 CDF 库的 C API 例程 CDFgetzVarData

要使用此函数,必须熟悉 CDF C 接口。您可以在 CDF 网站上访问 CDF 文档。

版本历史记录

全部展开