exponenta event banner

hdfinfo

Информация о файле HDF4 или HDF-EOS

Синтаксис

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

Описание

S = hdfinfo(filename) возвращает структуру S поля которого содержат информацию о содержимом файла HDF4 или HDF-EOS. Определить filename в виде вектора символов или строкового скаляра, содержащего имя файла HDF4.

S = hdfinfo(filename,mode) читает файл как файл HDF4, если mode является 'hdf'или в виде файла HDF-EOS, если mode является 'eos'. Если mode является 'eos'запрашиваются только объекты данных HDF-EOS. Для получения информации обо всем содержимом файла, содержащего объекты HDF4 и HDF-EOS, mode должно быть 'hdf'.

Примечание

hdfinfo может использоваться в файлах HDF версии 4.x или HDF-EOS версии 2.x. Для получения информации о файле HDF5 используйте h5info.

Набор полей в возвращаемой структуре S зависит от отдельного файла. Поля, которые могут присутствовать в S структура показана в следующей таблице.

Способ

Имя поля

Описание

Тип возврата

HDF

Attributes

Атрибуты набора данных

Структурный массив

 

Description

Описание аннотации

Массив ячеек

 

Filename

Имя файла

Символьный вектор

 

Label

Метка аннотации

Массив ячеек

 

Raster8

Описание 8-разрядных растровых изображений

Структурный массив

 

Raster24

Описание 24-разрядных растровых изображений

Структурный массив

 

SDS

Описание наборов научных данных

Структурный массив

 

Vdata

Описание наборов Vdata

Структурный массив

 

Vgroup

Описание Vgroups

Структурный массив

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

1 (true), если Vdata является атрибутом, в противном случае 0 (false)

Логичный

Поля структуры Vgroup

Имя поля

Описание

Тип данных

Class

Имя класса набора данных

Символьный вектор

Raster8

Описание 8-разрядного растрового изображения

Структурный массив

Raster24

Описание 24-разрядного растрового изображения

Структурный массив

SDS

Описание наборов научных данных

Структурный массив

Tag

Тег этой Vgroup

Число

Vdata

Описание наборов Vdata

Структурный массив

Vgroup

Описание Vgroups

Структурный массив

Поля структуры сетки

Имя поля

Описание

Тип данных

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.

Структура

Поля структуры Swath

Имя поля

Описание

Тип данных

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