exponenta event banner

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Символьный вектор или структура, описывающая тип данных.
SizeРазмер именованного типа данных в байтах.
Представлен в R2011a