Object (H5O)

Описание

Используйте MATLAB® Интерфейс объекта HDF5, H5O, обработать и получить доступ к информации об объектах HDF5.

Функции

H5O.are_mdc_flushes_disabled

Определите, отключены ли сбросы записей метаданных (начиная с R2021b)

tf = H5O.are_mdc_flushes_disabled(objID) возвращает true, если объект HDF5 имел сбросы отключенных записей метаданных. Идентификатор объекта задан в objID должен быть идентификатор для набора данных, группы или фиксировавшего типа данных.

H5O.close

Закрыть объект

H5O.close(objID) закрывает объект objID. Вход objID не может быть пространство данных, атрибут, список свойств или файл.

H5O.copy

Объект копии от исходного местоположения до целевого местоположения

H5O.copy(srcID,srcname,destID,destname,ocplID,lcplID) копирует набор данных, группу или фиксировавший тип данных, заданный srcname из файла или группы, заданной srcID к целевому местоположению destID.

 Детали

H5O.disable_mdc_flushes

Препятствуйте тому, чтобы объект или записи метаданных были сброшены (начиная с R2021b)

H5O.disable_mdc_flushes(objID) предотвращает записи метаданных для объекта или кэша objID с кэша метаданных на устройство хранения данных. Эта функция предотвращает грязные записи метаданных объекта или кэша от того, чтобы быть сброшенным из кэша обычной политикой замещения/сброса кэша.

Вместо этого необходимо вручную сбросить кэш или записи для отдельных объектов с помощью соответствующей функции:

  • H5F.flush

  • H5D.flush

  • H5G.flush

  • H5O.flush

  • H5T.flush

H5O.enable_mdc_flushes

Позвольте объекту или записям метаданных быть сброшенным (начиная с R2021b)

H5O.enable_mdc_flushes(objID) позволяет грязные записи метаданных объекта или кэша objID быть сброшенным из кэша обычной политикой замещения/сброса кэша. Идентификатор входного объекта должен быть идентификатором набора данных, группы или фиксировавшего типа данных.

H5O.flush

Сбросьте все буферы данных к диску (начиная с R2021b)

H5O.flush(objID) причины все буферы сопоставлены с объектом objID быть сразу сброшенным к диску, не удаляя данные из кэша. objID может быть любой именованный объект, сопоставленный с файлом включая набор данных, группу или зафиксированный тип данных.

H5O.get_comment

Получите комментарий для объекта, заданного идентификатором объекта

comment = H5O.get_comment(objID) получает комментарий для объекта, заданного objID.

H5O.get_comment_by_name

Получите комментарий для местоположения объекта и имени объекта

comment = H5O.get_comment_by_name(locID,objname,laplID) получает комментарий, где ID местоположения и имя вместе задают объект. Список свойств доступа к ссылке может влиять на результат, если ссылка пересечена, чтобы получить доступ к объекту.

H5O.get_info

Метаданные объекта

info = H5O.get_info(objID) получает метаданные для объекта, заданного objID. Для получения дополнительной информации о метаданных объекта, обратитесь к документации HDF5.

H5O.get_info2

Метаданные объекта от заданных полей

info = H5O.flush(objID,fields) получает метаданные для объекта, заданного objID использование параметра fields.

Если вы сталкиваетесь с проблемами эффективности с помощью H5O.get_info, использование H5O.get_info2 может помочь улучшать производительность.

 Детали

H5O.link

Создайте жесткую ссылку на заданный объект

H5O.link(objID,locID,linkname,lcplID,laplID) создает жесткую ссылку на объект, заданный objIDгде locID и linkname задайте местоположение. H5O.link спроектирован, чтобы добавить дополнительную структуру в существующий файл так, чтобы, например, объект мог быть общим для несколько групп.

 Детали

H5O.open

Открытый заданный объект

objID = H5O.open(objID,relname,laplID) открывает объект, заданный objID и относительный путь relname.

 Детали

H5O.open_by_idx

Открытый объект задан индексом

objID = H5O.open_by_idx(locID,groupName,idxtype,order,n,laplID) открывает объект в индексе n в группе, заданной locID и groupName.

 Детали

H5O.refresh

Очистите и перезагрузите все буферы данных (начиная с R2021b)

H5O.refresh(objID) причины все буферы сопоставлены с объектом objID быть очищенным и сразу перезагруженным с обновленным содержимым от диска. Эта функция по существу закрывает объект, выселяет все метаданные, сопоставленные с ним из кэша, и затем вновь открыла объект. Вновь открытый объект автоматически потворен регистрацию с тем же идентификатором. objID может быть любой именованный объект, сопоставленный с файлом включая набор данных, группу или зафиксированный тип данных.

H5O.set_comment

Установите комментарий для объекта, заданного идентификатором объекта

H5O.set_comment(objID,comment) устанавливает комментарий для объекта, заданного objID.

H5O.set_comment_by_name

Установите комментарий для объекта, заданного местоположением и именем объекта

H5O.set_comment_by_name(objID,relname,comment,laplID) устанавливает комментарий для объекта, заданного objID и родственник называет relname. Идентификатор списка свойств доступа к ссылке, laplID, может влиять на результат, если ссылки пересечены.

H5O.visit

Посетите объекты, заданные идентификатором объекта

[status,opdataOut] = H5O.visit(objID,idxtype,order,fnc,opdataIn) рекурсивная функция итерации должна посетить объект objID и, если objID группа, все объекты в и ниже его в файле HDF5. Это обеспечивает механизм для приложения, чтобы выполнить единый набор операций через все те объекты или динамически выбранное подмножество.

 Детали

H5O.visit2

Посетите объекты, заданные идентификатором объекта

[status,opdataOut] = H5O.visit(objID,idxtype,order,fnc,opdataIn,fields) рекурсивно посещения все объекты, доступные от объекта objID использование флагов задано в fields, и выполняет функциональный fnc на каждом объекте в objID.

Если вы сталкиваетесь с проблемами эффективности с помощью H5O.visit, использование H5O.visit2 может помочь улучшать производительность.

 Детали

H5O.visit_by_name

Посетите объекты, заданные местоположением и именем объекта

[status,opdata_out] = H5O.visit_by_name(locID,objname,idxtype,order,fnc,opdataIn,laplID) задает объект соединением идентификатора местоположения и имени объекта.

 Детали

H5O.visit_by_name2

Посетите объекты, заданные местоположением и именем объекта

[status,opdata_out] = H5O.visit_by_name(locID,objname,idxtype,order,fnc,opdataIn,fields,laplID) задает объект соединением идентификатора местоположения и имени объекта дополнительным параметром fields.

Если вы сталкиваетесь с проблемами эффективности с помощью H5O.visit_by_name, использование H5O.visit_by_name2 может помочь улучшать производительность.

 Детали

Примеры

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

Скопируйте группу '/g3' и все его наборы данных новой группе '/g3.5'.

srcFile = [matlabroot '/toolbox/matlab/demos/example.h5'];
copyfile(srcFile,'myfile.h5');
fileattrib('myfile.h5','+w');
ocpl = H5P.create('H5P_OBJECT_COPY');
lcpl = H5P.create('H5P_LINK_CREATE');
H5P.set_create_intermediate_group(lcpl,true);
fid = H5F.open('myfile.h5','H5F_ACC_RDWR','H5P_DEFAULT');
gid = H5G.open(fid,'/');
H5O.copy(gid,'g3',gid,'g3.5',ocpl,lcpl);
H5G.close(gid);
H5P.close(ocpl);
H5P.close(lcpl);
H5F.close(fid);
fid = H5F.open('example.h5');
obj_id = H5O.open(fid,'g3','H5P_DEFAULT');
H5O.close(obj_id);
H5F.close(fid);
Представлено до R2006a