h5readatt

从 HDF5 文件中读取属性

全页折叠

语法

attval = h5readatt(filename,loc,attr)

说明

attval = h5readatt(filename,loc,attr) 从 HDF5 文件中的指定位置检索指定属性的值。

示例

全部折叠

读取组属性

打开实时脚本

从 HDF5 文件 example.h5 的根组中读取属性 attr2。

val = h5readatt('example.h5','/','attr2')

val = 2×2 int32 matrix

   0   2
   1   3

读取数据集属性

打开实时脚本

从 HDF5 文件 example.h5 中的数据集 lon 中读取属性 units。

val = h5readatt('example.h5','/g4/lon','units')

val = 
'degrees_east'

输入参数

全部折叠

`filename` — 文件名
字符串标量 | 字符向量

现有 HDF5 文件的文件名，指定为字符串标量或字符向量。

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

位置

形式

当前文件夹或 MATLAB^® 路径上的文件夹

如果文件位于当前文件夹中或 MATLAB 路径上的文件夹中，则在 filename 中指定文件名。

示例："myFile.h5"

其他文件夹

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

示例："C:\myFolder\myFile.h5"

例如："myFolder\myFile.h5"

统一资源定位器 (URL) (自 R2024b 起)

如果文件是通过 Internet URL 定位的，则 filename 必须包含协议类型，例如 http://。有关详细信息，请参阅处理远程数据。

例如："http://my_hostname/my_path/my_file.h5"

远程位置

如果文件存储在远程位置，则 filename 必须包含指定为统一资源定位器 (URL) 形式的文件的完整路径：

scheme_name://path_to_file/filename

根据您的远程位置，scheme_name 可以是下表中的值之一。

远程位置	`scheme_name`
Amazon S3™	`s3`
Windows Azure^® Blob 存储	`wasb`, `wasbs`
HDFS™	`hdfs`

有关详细信息，请参阅处理远程数据。

例如："s3://myBucket/myFolder/myFile.h5"

如果您的文件包含多个使用 Family 驱动的物理文件，请使用格式设定符指定 filename。如果这些物理文件不在您的当前文件夹中，则需使用完整或相对路径指定它们。例如，要将 Family 驱动用于您的当前文件夹中的两个文件 family0.h5 和 family1.h5，请将 filename 指定为 "family%d.h5"。
如果您的文件包含多个使用 Multi 驱动或 Split 驱动的物理文件，请指定 filename 作为物理文件名的前缀。如果这些物理文件不在您的当前文件夹中，则需使用完整或相对路径指定它们。例如，要将 Multi 驱动用于您的当前文件夹中的六个文件 multi-b.h5、multi-g.h5、multi-l.h5、multi-o.h5、multi-r.h5 和 multi-s.h5，请将 filename 指定为 "multi"。

`loc` — 文件中的位置
字符向量 | 字符串标量

文件中的位置，指定为字符向量或字符串标量，其中包含属性所属的现有组或数据集的完整路径。要从文件的根组中读取属性，请指定 '/' 作为位置。

`attr` — 属性名称
字符向量 | 字符串标量

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

限制

MATLAB 不支持要求身份验证的 Internet URL。
MATLAB Online™ 支持与 Microsoft^® OneDrive™ 文件和文件夹相关联的 Internet URL，而 MATLAB 的安装版本仅支持本地 OneDrive 文件。
h5readatt 函数对未通过文件完整性检查的属性和数据集报错。要在此类情况下读取属性，请使用 H5P.set_relax_file_integrity_checks 函数和低级 HDF5 接口。 (自 R2024b 起)

版本历史记录

在 R2011a 中推出

全部展开

R2024b: 不再支持未通过文件完整性检查的属性和数据集 (R2024b Update)

现在，h5readatt 函数对未通过文件完整性检查的属性和数据集报错。此前，该函数对此类属性或数据集不报错。要在此类情况下读取属性，请使用 H5P.set_relax_file_integrity_checks 函数和低级 HDF5 接口。下表说明如何更新代码以使用低级 HDF5 接口。

R2024a 及更早版本	从 R2024b 开始
myAttrValue = h5readatt("myFilename.h5","myDatasetName","myAttrName");	fapl = H5P.create("H5P_FILE_ACCESS"); H5P.set_relax_file_integrity_checks(fapl,"H5F_RFIC_UNUSUAL_NUM_UNUSED_NUMERIC_BITS") fid = H5F.open("myFilename.h5","H5F_ACC_RDONLY",fapl); dset_id = H5D.open(fid,"myDatasetName"); attrID = H5A.open(dset_id,"myAttrName"); myAttrValue = H5A.read(attrID); H5A.close(attrID) H5D.close(dset_id) H5F.close(fid) H5P.close(fapl)

R2024a 及更早版本

从 R2024b 开始

myAttrValue = h5readatt("myFilename.h5","myDatasetName","myAttrName");

fapl = H5P.create("H5P_FILE_ACCESS");
H5P.set_relax_file_integrity_checks(fapl,"H5F_RFIC_UNUSUAL_NUM_UNUSED_NUMERIC_BITS")
fid = H5F.open("myFilename.h5","H5F_ACC_RDONLY",fapl);
dset_id = H5D.open(fid,"myDatasetName");
attrID = H5A.open(dset_id,"myAttrName");
myAttrValue = H5A.read(attrID);
H5A.close(attrID)
H5D.close(dset_id)
H5F.close(fid)
H5P.close(fapl)

R2024b: 通过 HTTP 和 HTTPS 从 HDF5 文件读取属性

您可以通过使用 h5readatt 函数和 Internet URL 从存储在主要在线数据源中的 HDF5 文件读取属性。

R2020b: 从远程位置的 HDF5 文件中读取属性

您可以从远程位置（例如 Amazon S3、Windows Azure Blob 存储和 HDFS）的 HDF5 文件中读取属性。

R2020b: 从具有 Unicode 名称的 HDF5 文件中读取属性

您可以从其名称以 Unicode 字符编码的 HDF5 文件中读取属性。

R2020a: 将非标量字符串属性作为 MATLAB 字符串数组读取

h5readatt 将 HDF5 字符串数组属性返回为 MATLAB 字符串数组，而不是字符向量元胞数组。单精度（标量）HDF5 字符串属性以 MATLAB 字符向量形式返回。

另请参阅

h5writeatt | h5info | h5disp

主题

Import Data Using High-Level HDF5 Functions