h5disp

显示 HDF5 文件的内容

全页折叠

语法

h5disp(filename)
h5disp(filename,loc)
h5disp(filename,loc,mode)
h5disp(___,'TextEncoding','UTF-8')

说明

h5disp(filename) 显示了描述指定的 HDF5 文件结构的元数据。

示例

h5disp(filename,loc) 显示文件内指定位置的元数据。

示例

h5disp(filename,loc,mode)（其中 mode 是 'min'）仅显示组和数据集名称。mode 的默认值为 'simple'，它显示数据集元数据和属性值。

示例

h5disp(___,'TextEncoding','UTF-8') 强制将对象和属性名称视为 UTF-8 编码文本。如果 HDF5 文件准确地指定使用 UTF-8 编码，则这种用法是不必要的。

示例

全部折叠

打开实时脚本

创建一个 50×50 数据集，其块大小为 5×5。 

h5create('exampleFile2.h5','/exampleDataset',[50,50],'ChunkSize',[5 5])

显示该 HDF5 文件的元数据。在此示例中，HDF5 文件在其根组中包含一个数据集。属于该数据集的属性显示在其名称下方。

h5disp('exampleFile2.h5')
HDF5 exampleFile2.h5 
Group '/' 
    Dataset 'exampleDataset' 
        Size:  50x50
        MaxSize:  50x50
        Datatype:   H5T_IEEE_F64LE (double)
        ChunkSize:  5x5
        Filters:  none
        FillValue:  0.000000
打开实时脚本

在文件 example.h5 中显示数据集 /g4/world 的属性。如果在 HDF5 文件中指定了数据集的完整路径，h5disp 将仅显示数据集的属性。

h5disp('example.h5','/g4/world')
HDF5 example.h5 
Dataset 'world' 
    Size:  36x19
    MaxSize:  36x19
    Datatype:   H5T_IEEE_F64LE (double)
    ChunkSize:  []
    Filters:  none
    FillValue:  0.000000
打开实时脚本

通过指定显示模式 'min'，仅显示组和数据集名称。 

h5disp('example.h5','/g4/world','min')
HDF5 example.h5 
Dataset 'world'

输入参数

全部折叠

现有 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 是一个组，则 h5disp 显示该组中的所有对象。

显示模式，指定为下列值之一：

  • 'simple' - 显示数据集名称和属性值（如果属性是整数、浮点数或标量字符串）。

  • 'min' - 仅显示组和数据集名称。

限制

  • MATLAB 不支持要求身份验证的 Internet URL。

  • MATLAB Online™ 支持与 Microsoft® OneDrive™ 文件和文件夹相关联的 Internet URL，而 MATLAB 的安装版本仅支持本地 OneDrive 文件。

  • h5disp 函数输出省略文件完整性检查失败的数据集和属性的信息。 (自 R2024b 起)

版本历史记录

在 R2011a 中推出

全部展开

另请参阅

| | |

主题