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 = 
'23-Mar-2021 16:52:50'

Создайте массив типа 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
Амазонки S3™s3
Windows Azure® Хранилище больших двоичных объектовwasb, wasbs

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

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

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

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

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

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

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

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

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

Ограничения

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

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

расширить все

Поведение изменено в R2020a

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