hdfinfo

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

语法

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

说明

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

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

注意

hdfinfo 可用于 HDF4 文件或 HDF-EOS2 文件。要获取有关 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`	数据集属性。包含字段 `Name` 和 `Value`。	结构体数组
`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`	数据集的维度。包含字段 `Name`、`DataType`、`Size`、`Scale` 和 `Attributes`。`Scale` 是沿着数据集内的维度和划定区间放置的数字数组。	结构体数组
`Index`	SDS 索引	数字

Vdata 结构体的字段

字段名称	描述	数据类型
`DataAttributes`	整个数据集的属性。包含字段 `Name` 和 `Value`。	结构体数组
`Class`	数据集的类名称	字符向量
`Fields`	Vdata 的字段。包含字段 `Name` 和 `Attributes`。	结构体数组
`NumRecords`	数据集记录的数目	双精度值
`IsAttribute`	如果 Vdata 是属性，则为 `1` (`true`)，否则为 `0` (`false`)	逻辑值

Vgroup 结构体的字段

字段名称	描述	数据类型
`Class`	数据集的类名称	字符向量
`Raster8`	8 位光栅图像的说明	结构体数组
`Raster24`	24 位光栅图像的说明	结构体数组
`SDS`	科学数据集的说明	结构体数组
`Tag`	该 Vgroup 的标签	数字
`Vdata`	Vdata 集的说明	结构体数组
`Vgroup`	Vgroup 的说明	结构体数组

网格结构体的字段

字段名称	描述	数据类型
`Columns`	网格中的列数	数字
`DataFields`	网格的每个 `Grid` 字段中数据字段的说明。包含字段 `Name`、`Rank`、`Dims`、`NumberType`、`FillValue` 和 `TileDims`。	结构体数组
`LowerRight`	右下角位置（以米为单位）	数字
`Origin Code`	网格的原点代码	数字
`PixRegCode`	像素注册码	数字
`Projection`	网格的投影代码、区域代码、球体代码和投影参数。包含字段 `ProjCode`、`ZoneCode`、`SphereCode` 和 `ProjParam`。	结构体
`Rows`	网格中的行数	数字
`UpperLeft`	左上角位置（以米为单位）	数字

点结构体的字段

字段名称	描述	数据类型
`Level`	点的每层的说明。包含字段 `Name`、`NumRecords`、`FieldNames`、`DataType` 和 `Index`。	结构体

分段结构体的字段

字段名称	描述	数据类型
`DataFields`	分段中的数据字段。包含字段 `Name`、`Rank`、`Dims`、`NumberType` 和 `FillValue`。	结构体数组
`GeolocationFields`	分段中的地理位置字段。包含字段 `Name`、`Rank`、`Dims`、`NumberType` 和 `FillValue`。	结构体数组
`IdxMapInfo`	地理位置映射的索引元素之间的关系。包含字段 `Map` 和 `Size`。	结构体
`MapInfo`	数据与地理位置字段之间的关系。包含字段 `Map`、`Offset` 和 `Increment`。	结构体

示例

要检索有关文件 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 之前推出

另请参阅

hdfread