h5writeatt

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

Описание

пример

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 = 
'24-Aug-2021 23:40:27'

Создайте массив типа 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.

В зависимости от местоположения вы пишете в, filename может взять одну из следующих форм.

Местоположение

Форма

Текущая папка

Чтобы записать в текущую папку, задайте имя файла в filename.

Пример: 'myFile.h5'

Другие папки

Чтобы записать в папку, отличающуюся от текущей папки, задайте полное имя или относительный путь в 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® Устройство хранения данных блобаwasb, wasbs

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

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

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

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

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

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

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

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

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

Ограничения

  • h5writeatt не поддерживает запись в файлы, хранившие удаленно в HDFS™.

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

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

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

Введенный в R2011a