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
Amazon S3™s3
Устройство хранения данных Windows Azure® Blobwasb, 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