h5writeatt

Запишите атрибут HDF5

Синтаксис

h5writeatt(filename,loc,attr,val)
h5writeatt(filename,loc,attr,val,'TextEncoding',encoding)

Описание

h5writeatt(filename,loc,attr,val) пишет атрибут под названием attr со значением val к заданному местоположению в файле HDF5.

h5writeatt(filename,loc,attr,val,'TextEncoding',encoding) записи attr к заданному местоположению в файле HDF5 с помощью заданного кодирования. 'UTF-8' настройка по умолчанию для 'TextEncoding', в то время как 'system' использует системное кодирование, чтобы представлять символы. Является обычно ненужным задать 'system' как кодирование.

Примеры

свернуть все

Запишите атрибут в корневую группу examplefile.h5 чье значение является текущим временем.

date = datestr(now);
h5writeatt('examplefile.h5','/','creation_date', date);

Считайте атрибут из корневой группы файла HDF5.

val1 = h5readatt('examplefile.h5','/','creation_date')
val1 = 
'29-Jan-2020 12:50:19'

Создайте массив типа double и запишите его в набор данных /g4/world.

attData = [0 1 2 3];
h5writeatt('examplefile.h5','/g4/world','val2',attData);

Отобразите метаданные набора данных. Атрибут val2 перечислен один из атрибутов, принадлежащих набору данных.

h5disp('examplefile.h5','/g4/world');
HDF5 examplefile.h5 
Dataset 'world' 
    Size:  36x19
    MaxSize:  36x19
    Datatype:   H5T_IEEE_F64LE (double)
    ChunkSize:  []
    Filters:  none
    FillValue:  0.000000
    Attributes:
        'val2':  0.000000 1.000000 2.000000 3.000000 

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

свернуть все

Имя файла в виде вектора символов или строкового скаляра, содержащего имя существующего файла HDF5.

Местоположение в файле в виде вектора символов или строкового скаляра, содержащего имя полного пути существующей группы или набора данных, к которому вы хотите сопоставить атрибут.

Имя атрибута в виде вектора символов или строкового скаляра, содержащего имя атрибута, принадлежащего группе или набору данных. Если атрибут не существует, h5writeatt создает атрибут с заданным именем.

Если заданный атрибут уже существует, но не имеет типа данных или пространства данных сопоставимыми с valh5writeatt удаляет атрибут и воссоздает его. Атрибуты строки создаются со скалярным пространством данных, которое является одной, нулевой размерной точкой данных.

Значение атрибута, который будет записан в виде вектора символов, строкового скаляра или числового значения.

Текстовое кодирование в виде разделенной запятой пары, состоящей из 'TextEncoding' и одно из этих значений:

  • 'UTF-8' — Представляет символы с помощью кодирования UTF-8.

  • 'system' — Представляет символы как байты с помощью системного кодирования (не рекомендуемый).

Вопросы совместимости

развернуть все

Поведение изменяется в R2020a

Введенный в R2011a

Для просмотра документации необходимо авторизоваться на сайте