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 может использоваться в версии 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

Данные 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

Описание групп 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.

Структура

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

Имя поля

Описание

Тип данных

DataFields

Поля данных на swath. Содержит поля Name, Rank, Dims, NumberType, и FillValue.

Массив структур

GeolocationFields

Поля геолокации на swath. Содержит поля 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