Main Content

h5disp

显示 HDF5 文件的内容

说明

示例

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 可以采用下列形式之一。

位置

形式

当前文件夹

指定 filename 中文件的名称。

示例:'myFile.h5'

其他文件夹

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

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

示例:'myFolder\myFile.h5'

远程位置

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

scheme_name://path_to_file/my_file.ext

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

远程位置scheme_name
Amazon S3™s3
Windows Azure® Blob Storagewasbwasbs
HDFS™hdfs

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

示例:'s3://bucketname/path_to_file/myFile.h5'

文件中的位置,指定为包含文件中某个位置的完整路径的字符向量或字符串标量。要显示整个文件的元数据,请指定 '/' 作为位置。如果 loc 是一个组,则 h5disp 显示该组中的所有对象。

显示模式,指定为下列值之一:

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

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

版本历史记录

在 R2011a 中推出