Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

hdfinfo

有关 HDF4 或 HDF-EOS 文件的信息

语法

S = hdfinfo(filename)
S = hdfinfo(filename,mode)

说明

S = hdfinfo(filename) 返回结构体 S,其字段包含有关 HDF4 或 HDF-EOS 文件内容的信息。将 filename 指定为包含 HDF4 文件名的字符向量或字符串标量。

如果 mode'hdf'S = hdfinfo(filename,mode) 将文件作为 HDF4 文件读取;如果 mode'eos',则将文件作为 HDF-EOS 文件读取。如果 mode'eos',仅需要 HDF-EOS 数据对象。要检索有关同时包含 HDF4 和 HDF-EOS 对象的文件的完整内容信息,mode 必须是 'hdf'

注意

hdfinfo 可以对 4.x 版本的 HDF 文件或 2.x 版本的 HDF-EOS 文件使用。要获取有关 HDF5 文件的信息,请使用 h5info

返回的结构体 S 中的字段集取决于单个文件。S 结构体中可以存在的字段如下表所示。

模式

字段名称

说明

返回类型

HDF

Attributes

数据集的属性

结构体数组

 

Description

注释说明

元胞数组

 

Filename

文件的名称

字符向量

 

Label

注释标签

元胞数组

 

Raster8

8 位光栅图像的说明

结构体数组

 

Raster24

24 位光栅图像的说明

结构体数组

 

SDS

科学数据集的说明

结构体数组

 

Vdata

Vdata 集的说明

结构体数组

 

Vgroup

Vgroup 的说明

结构体数组

EOS

Filename

文件的名称

字符向量

 

Grid

网格数据

结构体数组

 

Point

点数据

结构体数组

 

Swath

分段数据

结构体数组

上表中包含结构体数组的字段将在下表中进一步介绍。

返回的结构体数组共用的字段

hdfinfo 返回的结构体数组包含一些共用字段。下表中说明了这些字段。并非所有的结构体数组都包含所有这些字段。

字段名称

说明

数据类型

Attributes

数据集属性。包含字段 NameValue

结构体数组

Description

注释说明

元胞数组

Filename

文件的名称

字符向量

Label

注释标签

元胞数组

Name

数据集的名称

字符向量

Rank

数据集的维数

双精度值

Ref

数据集引用编号

双精度值

Type

HDF 或 HDF-EOS 对象的类型

字符向量

特定于某些结构体的字段

hdfinfo 返回的结构体数组还包含对每个结构体唯一的字段。下表中说明了这些字段。

属性结构体的字段

字段名称

说明

数据类型

Name

属性名称

字符向量

Value

属性值或说明

数字或文本

Raster8 和 Raster24 结构体的字段

字段名称

说明

数据类型

HasPalette

如果图像具有关联的调色板,则为 1 (true),否则为 0 (false)(仅 8 位)

逻辑值

Height

图像的高度(以像素为单位)

数值

Interlace

图像的交错模式(仅 24 位)

字符向量

Name

图像的名称

字符向量

Width

图像的宽度(以像素为单位)

数值

SDS 结构体的字段

字段名称

说明

数据类型

DataType

数据精度

字符向量

Dims

数据集的维度。包含字段 NameDataTypeSizeScaleAttributesScale 是沿着数据集内的维度和划定区间放置的数字数组。

结构体数组

Index

SDS 索引

数值

Vdata 结构体的字段

字段名称

说明

数据类型

DataAttributes

整个数据集的属性。包含字段 NameValue

结构体数组

Class

数据集的类名称

字符向量

Fields

Vdata 的字段。包含字段 NameAttributes

结构体数组

NumRecords

数据集记录的数目

双精度值

IsAttribute

如果 Vdata 是属性,则为 1 (true),否则为 0 (false)

逻辑值

Vgroup 结构体的字段

字段名称

说明

数据类型

Class

数据集的类名称

字符向量

Raster8

8 位光栅图像的说明

结构体数组

Raster24

24 位光栅图像的说明

结构体数组

SDS

科学数据集的说明

结构体数组

Tag

该 Vgroup 的标签

数值

Vdata

Vdata 集的说明

结构体数组

Vgroup

Vgroup 的说明

结构体数组

网格结构体的字段

字段名称

说明

数据类型

Columns

网格中的列数

数值

DataFields

网格的每个 Grid 字段中数据字段的说明。包含字段 NameRankDimsNumberTypeFillValueTileDims

结构体数组

LowerRight

右下角位置(以米为单位)

数值

Origin Code

网格的原点代码

数值

PixRegCode

像素注册码

数值

Projection

网格的投影代码、区域代码、球体代码和投影参数。包含字段 ProjCodeZoneCodeSphereCodeProjParam

结构体

Rows

网格中的行数

数值

UpperLeft

左上角位置(以米为单位)

数值

点结构体的字段

字段名称

说明

数据类型

Level

点的每层的说明。包含字段 NameNumRecordsFieldNamesDataTypeIndex

结构体

分段结构体的字段

字段名称

说明

数据类型

DataFields

分段中的数据字段。包含字段 NameRankDimsNumberTypeFillValue

结构体数组

GeolocationFields

分段中的地理位置字段。包含字段 NameRankDimsNumberTypeFillValue

结构体数组

IdxMapInfo

地理位置映射的索引元素之间的关系。包含字段 MapSize

结构体

MapInfo

数据与地理位置字段之间的关系。包含字段 MapOffsetIncrement

结构体

示例

要检索有关文件 example.hdf 的信息,

fileinfo = hdfinfo('example.hdf')

fileinfo = 
    Filename: 'example.hdf'
         SDS: [1x1 struct]
       Vdata: [1x1 struct]

并且要从此处检索有关 example.hdf 中的科学数据集的信息,

sds_info = fileinfo.SDS

sds_info = 
       Filename: 'example.hdf'
           Type: 'Scientific Data Set'
           Name: 'Example SDS'
           Rank: 2
       DataType: 'int16'
     Attributes: []
           Dims: [2x1 struct]
          Label: {}
    Description: {}
          Index: 0

另请参阅

在 R2006a 之前推出