Exponenta Banner
exponenta event banner

h5writeatt

Запись атрибута HDF5

свернуть все на странице

Синтаксис

h5writeatt (имя файла, loc, attr, val)
h5writeatt (имя файла, loc, attr, val, TextEncoding, кодировка)

Описание

пример

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'
Открыть сценарий в реальном времени

Создайте массив двойников и запишите его в набор данных /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

Поддержка