Exponenta Banner
exponenta event banner

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' как кодировка.

Примеры

свернуть все

Открыть Live Script

Запись атрибута в корневую группу 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'
Открыть Live Script

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

Документация MATLAB

Поддержка