Main Content

hdf5info

(不推荐)有关 HDF5 文件的信息

不推荐使用 hdf5info。请改用 h5info

语法

fileinfo = hdf5info(filename)
fileinfo = hdf5info(...,'ReadAttributes',BOOL)
[...] = hdf5info(..., 'V71Dimensions', BOOL)

说明

fileinfo = hdf5info(filename) 返回结构体 fileinfo,其字段包含有关 HDF5 文件 filename 内容的信息。filename 是一个字符向量或字符串标量,用于指定 HDF5 文件的名称。

fileinfo = hdf5info(...,'ReadAttributes',BOOL) 指定 hdf5info 是返回属性值还是仅返回描述属性的信息。默认情况下,hdf5info 读入属性值 (BOOL = true)。

[...] = hdf5info(..., 'V71Dimensions', BOOL) 指定是否报告数据集和属性的维度,因为它们是在以前版本的 hdf5info(MATLAB® 7.1 [R14SP3] 及更低版本)中返回的。如果 BOOL 为 true,hdf5info 将交换数据集的前两个维度。这种行为旨在将 HDF5 和 MATLAB 如何表示数组维度的差异考虑在内。HDF5 按照行优先的顺序描述数据集维度,MATLAB 按照列优先的顺序存储数据。但是,交换这些维度可能无法正确反映文件数据的意图,并且可能会使元数据失效。如果 BOOL 为 false(默认值),hdf5info 返回可正确反映数据排序的数据维度,即和写入文件的排序一样,输出变量中的每个维度与文件中的相同维度匹配。

注意

如果您使用 'V71Dimensions' 参数并希望将返回的 fileinfo 结构体传递到 hdf5read 函数,则还应与 hdf5read 一起指定 'V71Dimensions' 参数。如果未指定,hdf5read 在读取数据集时使用新行为并且 hdf5info 返回的某些元数据与 hdf5read 返回的实际数据不相符。

示例

fileinfo = hdf5info('example.h5');

要获取有关 HDF5 文件内容的详细信息,请查看 hdf5info 返回的 fileinfo 结构体中的 GroupHierarchy 字段。

toplevel = fileinfo.GroupHierarchy

toplevel = 

      Filename: [1x64 char]
          Name: '/'
        Groups: [1x2 struct]
      Datasets: []
     Datatypes: []
         Links: []
    Attributes: [1x2 struct]

要深入查看文件层次结构,请仔细查看 Groups 字段。

另请参阅

| |