Main Content

hdf5read

(不推荐)读取 HDF5 文件

不推荐使用 hdf5read。请改用 h5read

说明

data = hdf5read(filename,ds) 读取 HDF5 文件 filename 中包含的数据集 ds 中的所有数据。

attr = hdf5read(filename,attrname) 读取包含在 HDF5 文件 filename 中的属性 attrname 的所有元数据。

data = hdf5read(info) 读取在结构体 info 中指定的数据集中的所有数据。info 结构体是由 hdf5info 返回的输出。

[data,attr] = hdf5read(___,Name,Value) 支持上述语法中的任何输入参数,且可使用可选的名称-值对组参数。

输入参数

全部折叠

文件名,指定为包含现有 HDF5 文件名称的字符向量或字符串标量。

根据文件的位置,filename 可以采用下列形式之一。

位置

形式

当前文件夹

指定 filename 中文件的名称。

示例:'myFile.h5'

其他文件夹

如果该文件不在当前文件夹或 MATLAB® 路径下的文件夹中,则在 filename 中指定完整或相对路径名。

示例:'C:\myFolder\myFile.h5'

示例:'myFolder\myFile.h5'

数据集名称,指定为字符向量或字符串标量,其中包含 HDF5 文件中数据集的完整路径名称。

属性名称,指定为包含属于某组或数据集的属性的完整路径名称的字符向量或字符串标量。

输入数据,指定为结构体数组。info 结构体是由 hdf5info 函数返回的输出。

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参数名称,Value 是对应的值。名称-值参数必须出现在其他参数之后,但参数对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: 'ReadAttributes',true 读取该数据集中包含的所有相关联的属性信息。

用于读取属性的指示符,指定为逗号分隔的对组,包含 'ReadAttributes'truefalse

如果指定 true,则 hdf5read 读取该数据集中包含的所有相关联的属性信息。'ReadAttributes' 的默认值为 false,它会在从 HDF5 文件中读取数据时忽略属性信息。

与 MATLAB 7.1 及更早版本的兼容性,指定为包含 'V71Dimensions' 以及 truefalse 的逗号分隔对组。如果指定 true,则 hdf5read 会置换数据集的前两个维度,使输出数据集的维度顺序与以前版本的 hdf5read(MATLAB 7.1 [R14SP3] 和更早版本)一致。这种行为旨在将 HDF5 和 MATLAB 如何表示数组维度的差异考虑在内。

'V71Dimensions' 的默认值为 false,它不会更改输出数据维度的顺序。

HDF5 以行优先排序描述数据集维度,MATLAB 以列优先顺序存储数据。但是,置换这些维度可能无法正确反映数据的意图,并且可能会使元数据失效。如果 'V71Dimensions' 指定为 false,数据维度可正确反映数据排序,即和写入文件的排序一样;输出变量中的每个维度与文件中的相同维度匹配。

示例: 'V71Dimensions',true

输出参数

全部折叠

输出数据,由 hdf5read 以多维数组形式返回。

示例

全部折叠

使用 hdf5info 获取有关 HDF5 文件的信息,然后使用 hdf5read 读取数据集,并使用 hdf5info 返回的信息结构体 (hinfo) 指定数据集。

hinfo = hdf5info('example.h5');
dset = hdf5read(hinfo.GroupHierarchy.Groups(2).Datasets(1));

提示

  • hdf5read 在读取数值数据集时性能最佳。如果您需要读取字符串、复合数据或可变长度数据集,强烈建议您使用低级 HDF5 接口函数 H5D.read。要读取数据集的一个子集,请使用 h5read 函数或 MATLAB HDF5 低级接口。

  • hdf5read 尽可能将 HDF5 数据类型映射为本机 MATLAB 数据类型。如果它不能使用 MATLAB 数据类型表示数据,hdf5read 使用 HDF5 数据类型对象之一。例如,如果 HDF5 文件包含由枚举数据类型组成的数据集,hdf5read 使用 hdf5.h5enum 对象表示 MATLAB 工作区中的数据。hdf5.h5enum 对象包含存储枚举(名称)、其相应值以及枚举数据的数据成员。

版本历史记录

在 R2006a 之前推出

另请参阅

| |