h5info

Информация о HDF5 файле

Описание

пример

info = h5info(filename) возвращает информацию о целом файле HDF5, включая информацию о группах, наборах данных и именованных типах данных, содержащихся в нем.

пример

info = h5info(filename,loc) возвращает информацию об указанном местоположении в файле HDF5.

info = h5info(filename,loc,'TextEncoding','UTF-8') заставляет имена объектов и атрибутов рассматриваться как UTF-8-encoded текст. Это использование не требуется, если HDF5 файл точно задает использование UTF-8 кодировки.

Примеры

свернуть все

Возвращает информацию обо всем файле 'example.h5'.

info = h5info('example.h5')
info = struct with fields:
      Filename: '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/demos/example.h5'
          Name: '/'
        Groups: [4x1 struct]
      Datasets: []
     Datatypes: []
         Links: []
    Attributes: [2x1 struct]

Возвращает информацию о групповой g4.

info = h5info('example.h5','/g4')
info = struct with fields:
      Filename: '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/demos/example.h5'
          Name: '/g4'
        Groups: []
      Datasets: [4x1 struct]
     Datatypes: []
         Links: []
    Attributes: []

Возвращает информацию о наборе данных time в групповом g4.

info = h5info('example.h5','/g4/time')
info = struct with fields:
      Filename: '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/demos/example.h5'
          Name: 'time'
      Datatype: [1x1 struct]
     Dataspace: [1x1 struct]
     ChunkSize: 10
     FillValue: 0
       Filters: []
    Attributes: [2x1 struct]

Входные параметры

свернуть все

Имя файла, заданное как вектор символов или строковый скаляр, содержащий имя существующего файла 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
Амазонки S3™s3
Windows Azure® Хранилище больших двоичных объектовwasb, wasbs
HDFS™hdfs

Для получения дополнительной информации см. раздел Работа с удаленными данными.

Пример: 's3://bucketname/path_to_file/myFile.h5'

Расположение в файле, заданное как вектор символов или строковый скаляр, содержащий путь к файлу группы, набора данных или именованного типа данных в файле. Чтобы вернуть информацию о целом файле, задайте '/' в качестве местоположения.

Выходные аргументы

свернуть все

Информация о файле, возвращенная как структура. Структура имеет различные поля в зависимости от loc аргумент указывает на файл или группу, набор данных или именованный тип данных. В следующих таблицах перечислены поля, которые присутствуют для каждого типа местоположения.

Файлы и группы

ОбластьОписание
NameВектор символов, задающий имя группы или набора данных. Если вы задаете только имя файла HDF5, функция вернёт информацию о корневой группе.
GroupsМассив структур, описывающих подгруппы.
DatasetsМассив структур, описывающих наборы данных.
DatatypesМассив структур, описывающих именованные типы данных.
LinksМассив структур, описывающих мягкие, внешние, пользовательские и определенные жесткие ссылки.
Attributes Массив структур, описывающих атрибуты группы.

Наборы данных

ОбластьОписание
NameВектор символов, задающий имя набора данных.
DatatypeСтруктура, описывающая тип данных.
DataspaceСтруктура, описывающая размер набора данных.
ChunkSizeРазмерности фрагмента набора данных, если задан.
FillValueЗаполните значение отсутствующих данных, если оно задано.
FilterМассив структур, описывающих любые определенные фильтры, такие как сжатие.
AttributesМассив структур, описывающих атрибуты набора данных.

Именованные типы данных

ОбластьОписание
NameВектор символов, задающий имя объекта типа данных.
Class HDF5 класс именованного типа данных.
TypeВектор символов или struct, дополнительно описывающая тип данных.
SizeРазмер именованного типа данных в байтах.
Введенный в R2011a