Функции
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.
Детали
Входные параметры
srcID — Исходная группа или идентификатор файла.
srcname — Имя исходного файла или группы.
destID — Идентификатор группы в текущем файле или идентификатор различного файла. Если destID идентификатор файла, копия помещается в корневую группу destID.
destname — Имя новой копии группы или файла, и не должно существовать ранее в целевом месте. Если destname уже существует в местоположении destID, операция перестанет работать.
ocplID — Идентификатор списка свойств создания объекта.
lcplID — Соедините идентификатор списка свойств создания.
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 может помочь улучшать производительность.
Детали
Входные параметры
objID — Идентификатор объекта.
fields — Параметр, который содержит флаги, чтобы определить, какие поля будут заполнены в info. Для получения дополнительной информации о метаданных объекта, обратитесь к документации HDF5.
H5O.link
Создайте жесткую ссылку на заданный объект
H5O.link(objID,locID,linkname,lcplID,laplID) создает жесткую ссылку на объект, заданный objIDгде locID и linkname задайте местоположение. H5O.link спроектирован, чтобы добавить дополнительную структуру в существующий файл так, чтобы, например, объект мог быть общим для несколько групп.
Детали
Входные параметры
objID — Идентификатор объекта.
locID — Файл или идентификатор группы, где ссылка расположена.
linkname — Соедините имя.
lcplID — Соедините идентификатор списка свойств создания.
laplID — Соедините идентификатор списка свойств доступа.
H5O.open
Открытый заданный объект
objID = H5O.open(objID,relname,laplID) открывает объект, заданный objID и относительный путь relname.
Детали
Входные параметры
objID — Идентификатор объекта.
relname — Относительный путь.
laplID — Соедините идентификатор списка свойств доступа. Если свойства доступа к ссылке по умолчанию являются соответствующими, это может быть передано в как 'H5P_DEFAULT'.
H5O.open_by_idx
Открытый объект задан индексом
objID = H5O.open_by_idx(locID,groupName,idxtype,order,n,laplID) открывает объект в индексе n в группе, заданной locID и groupName.
Детали
Входные параметры
locID — Файл или идентификатор группы.
groupName — Имя группы относительно locID в котором может быть найден объект.
idxtype — Тип индекса в виде одного из этих векторов символов или строковых скаляров:
order — Индексируйте пересекающийся порядок в виде одного из этих векторов символов или строковых скаляров:
'H5_ITER_INC' — Итерация с начала до конца.
'H5_ITER_DEC' — Итерация от конца до начала.
'H5_ITER_NATIVE' — Итерация в самом быстром доступном порядке.
n— Основанное на нуле положение объекта в индексе.
laplID — Соедините идентификатор списка свойств доступа.
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. Это обеспечивает механизм для приложения, чтобы выполнить единый набор операций через все те объекты или динамически выбранное подмножество.
Детали
Входные параметры
objID — Идентификатор объекта. Если objID идентификатор группы, он служит корневой группой рекурсивной итерации. Если objID идентификатор файла, корневая группа заданного файла служит корнем рекурсивной итерации. Если objID любой другой тип объекта, такого как набор данных или названный тип данных, нет никакой итерации.
idxtype — Тип индекса. Если ссылки в группе не были индексированы типом индекса, они будут сначала отсортированы по тому индексу затем, итерация начнется. Если ссылки были так индексированы, шаг сортировки будет ненужным, таким образом, итерация сможет начаться более быстро. Задайте idxtype как один из этих векторов символов или строковых скаляров:
order — Индексируйте пересекающийся порядок в виде одного из этих векторов символов или строковых скаляров:
'H5_ITER_INC' — Итерация с начала до конца.
'H5_ITER_DEC' — Итерация от конца до начала.
'H5_ITER_NATIVE' — Итерация в самом быстром доступном порядке.
opdataIn — Пользовательское значение или структура передали первому шагу итерации opdataIn параметр fnc.
fnc — Функция обратного вызова с этой подписью: [status,opdataOut] = fnc(groupID,name,opdataIn).
groupID — Идентификатор группы.
name — Имя объекта.
Выходные аргументы
status — Значение возвращено функцией обратного вызова fnc и интерпретированный как одно из следующего:
zero — Продолжает итерацию или возвращает нулевое значение состояния вызывающей стороне, если все члены были обработаны.
positive — Останавливает итерацию и возвращает положительное значение состояния вызывающей стороне.
negative — Останавливает итерацию и выдает ошибку при указании на отказ.
opdataOut — Значение, которое формирует opdataIn для следующего шага итерации. Итоговый opdataOut в конце итерации затем возвращен в вызывающую сторону как opdataOut.
Примечание
Тип индекса передается в idxtype установка максимальных усилий. Если с передачами приложения в итерации указания значения в порядке создания и группе сталкиваются, который не был прослежен в порядке создания, что группа будет выполнена с помощью итераций в алфавитно-цифровом порядке по наименованию или порядке имени. (Назовите порядок, нативный порядок, используемый Библиотекой HDF5, и всегда доступен.)
H5O.visit2
Посетите объекты, заданные идентификатором объекта
[status,opdataOut] = H5O.visit(objID,idxtype,order,fnc,opdataIn,fields) рекурсивно посещения все объекты, доступные от объекта objID использование флагов задано в fields, и выполняет функциональный fnc на каждом объекте в objID.
Если вы сталкиваетесь с проблемами эффективности с помощью H5O.visit, использование H5O.visit2 может помочь улучшать производительность.
Детали
Входные параметры
objID — Идентификатор объекта. Если objID идентификатор группы, он служит корневой группой рекурсивной итерации. Если objID идентификатор файла, корневая группа заданного файла служит корнем рекурсивной итерации. Если objID любой другой тип объекта, такого как набор данных или названный тип данных, нет никакой итерации.
fields — содержит флаги, чтобы определить, какие поля будут получены fnc функция обратного вызова. Допустимые значения:
'H5O_INFO_BASIC' — Заполните fileno, addrВвод, и rc поля .
'H5O_INFO_TIME' — Заполните atime, mtime, ctime, и btime поля .
'H5O_INFO_NUM_ATTRS' — Заполните num_attrs поле .
'H5O_INFO_HDR' — Заполните hdr поле .
'H5O_INFO_META_SIZE' — Заполните meta_size поле .
'H5O_INFO_ALL' — Заполните все поля.
idxtype — Тип индекса. Если ссылки в группе не были индексированы типом индекса, они будут сначала отсортированы по тому индексу затем, итерация начнется. Если ссылки были так индексированы, шаг сортировки будет ненужным, таким образом, итерация сможет начаться более быстро. Задайте idxtype как один из этих векторов символов или строковых скаляров:
order — Индексируйте пересекающийся порядок в виде одного из этих векторов символов или строковых скаляров:
'H5_ITER_INC' — Итерация с начала до конца.
'H5_ITER_DEC' — Итерация от конца до начала.
'H5_ITER_NATIVE' — Итерация в самом быстром доступном порядке.
opdataIn — Пользовательское значение или структура передали первому шагу итерации opdataIn параметр fnc.
fnc — Функция обратного вызова с этой подписью: [status,opdataOut] = fnc(groupID,name,opdataIn).
groupID — Идентификатор группы.
name — Имя объекта.
Выходные аргументы
status — Значение возвращено функцией обратного вызова fnc и интерпретированный как одно из следующего:
zero — Продолжает итерацию или возвращает нулевое значение состояния вызывающей стороне, если все члены были обработаны.
positive — Останавливает итерацию и возвращает положительное значение состояния вызывающей стороне.
negative — Останавливает итерацию и выдает ошибку при указании на отказ.
opdataOut — Значение, которое формирует opdataIn для следующего шага итерации. Итоговый opdataOut в конце итерации затем возвращен в вызывающую сторону как opdataOut.
Примечание
Тип индекса передается в idxtype установка максимальных усилий. Если с передачами приложения в итерации указания значения в порядке создания и группе сталкиваются, который не был прослежен в порядке создания, что группа будет выполнена с помощью итераций в алфавитно-цифровом порядке по наименованию или порядке имени. (Назовите порядок, нативный порядок, используемый Библиотекой HDF5, и всегда доступен.)
H5O.visit_by_name
Посетите объекты, заданные местоположением и именем объекта
[status,opdata_out] = H5O.visit_by_name(locID,objname,idxtype,order,fnc,opdataIn,laplID) задает объект соединением идентификатора местоположения и имени объекта.
Детали
Входные параметры
locID — Идентификатор объекта. Если locID идентификатор группы, он служит корневой группой рекурсивной итерации. Если locID идентификатор файла, корневая группа заданного файла служит корнем рекурсивной итерации. Если locID любой другой тип объекта, такого как набор данных или названный тип данных, H5O.visit_by_name не выполняет итерации.
objname — Объект в файле или с абсолютным именем или относительно locID.
idxtype — Тип индекса. Если ссылки в группе не были индексированы типом индекса, они будут сначала отсортированы по тому индексу затем, итерация начнется. Если ссылки были так индексированы, шаг сортировки будет ненужным, таким образом, итерация сможет начаться более быстро. Задайте idxtype как один из этих векторов символов или строковых скаляров:
order — Индексируйте пересекающийся порядок в виде одного из этих векторов символов или строковых скаляров:
'H5_ITER_INC' — Итерация с начала до конца.
'H5_ITER_DEC' — Итерация от конца до начала.
'H5_ITER_NATIVE' — Итерация в самом быстром доступном порядке.
opdataIn — Пользовательское значение или структура передали первому шагу итерации opdataIn параметр fnc.
fnc — Функция обратного вызова с этой подписью: function [status,opdataOut] = fnc(groupID,name,opdataIn).
name — Имя объекта.
groupID — Идентификатор группы.
laplID — Соедините идентификатор списка свойств доступа. Список свойств доступа к ссылке может влиять на результат, если ссылки включены. Когда свойства доступа к ссылке по умолчанию приемлемы, 'H5P_DEFAULT' может использоваться.
Выходные аргументы
status — Значение возвращено функцией обратного вызова fnc и интерпретированный как одно из следующего:
zero — Продолжает итерацию или возвращает нулевое значение состояния вызывающей стороне, если все члены были обработаны.
positive — Останавливает итерацию и возвращает положительное значение состояния вызывающей стороне.
negative — Останавливает итерацию и выдает ошибку при указании на отказ.
opdataOut — Значение, которое формирует opdataIn для следующего шага итерации. Итоговый opdataOut в конце итерации затем возвращен в вызывающую сторону как opdataOut.
Примечание
Тип индекса передается в idxtype установка максимальных усилий. Если с передачами приложения в итерации указания значения в порядке создания и группе сталкиваются, который не был прослежен в порядке создания, что группа будет выполнена с помощью итераций в алфавитно-цифровом порядке по наименованию или порядке имени. (Назовите порядок, нативный порядок, используемый Библиотекой HDF5, и всегда доступен.)
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 может помочь улучшать производительность.
Детали
Входные параметры
locID — Идентификатор объекта. Если locID идентификатор группы, он служит корневой группой рекурсивной итерации. Если locID идентификатор файла, корневая группа заданного файла служит корнем рекурсивной итерации. Если locID любой другой тип объекта, такого как набор данных или названный тип данных, H5O.visit_by_name не выполняет итерации.
objname — Объект в файле или с абсолютным именем или относительно locID.
idxtype — Тип индекса. Если ссылки в группе не были индексированы типом индекса, они будут сначала отсортированы по тому индексу затем, итерация начнется. Если ссылки были так индексированы, шаг сортировки будет ненужным, таким образом, итерация сможет начаться более быстро. Задайте idxtype как один из этих векторов символов или строковых скаляров:
order — Индексируйте пересекающийся порядок в виде одного из этих векторов символов или строковых скаляров:
'H5_ITER_INC' — Итерация с начала до конца.
'H5_ITER_DEC' — Итерация от конца до начала.
'H5_ITER_NATIVE' — Итерация в самом быстром доступном порядке.
fields — содержит флаги, чтобы определить, какие поля будут получены fnc функция обратного вызова. Допустимые значения:
'H5O_INFO_BASIC' — Заполните fileno, addrВвод, и rc поля .
'H5O_INFO_TIME' — Заполните atime, mtime, ctime, и btime поля .
'H5O_INFO_NUM_ATTRS' — Заполните num_attrs поле .
'H5O_INFO_HDR' — Заполните hdr поле .
'H5O_INFO_META_SIZE' — Заполните meta_size поле .
'H5O_INFO_ALL' — Заполните все поля.
opdataIn — Пользовательское значение или структура передали первому шагу итерации opdataIn параметр fnc.
fnc — Функция обратного вызова с этой подписью: function [status,opdataOut] = fnc(groupID,name,opdataIn).
name — Имя объекта.
groupID — Идентификатор группы.
laplID — Соедините идентификатор списка свойств доступа. Список свойств доступа к ссылке может влиять на результат, если ссылки включены. Когда свойства доступа к ссылке по умолчанию приемлемы, 'H5P_DEFAULT' может использоваться.
Выходные аргументы
status — Значение возвращено функцией обратного вызова fnc и интерпретированный как одно из следующего:
zero — Продолжает итерацию или возвращает нулевое значение состояния вызывающей стороне, если все члены были обработаны.
positive — Останавливает итерацию и возвращает положительное значение состояния вызывающей стороне.
negative — Останавливает итерацию и выдает ошибку при указании на отказ.
opdataOut — Значение, которое формирует opdataIn для следующего шага итерации. Итоговый opdataOut в конце итерации затем возвращен в вызывающую сторону как opdataOut.
Примечание
Тип индекса передается в idxtype установка максимальных усилий. Если с передачами приложения в итерации указания значения в порядке создания и группе сталкиваются, который не был прослежен в порядке создания, что группа будет выполнена с помощью итераций в алфавитно-цифровом порядке по наименованию или порядке имени. (Назовите порядок, нативный порядок, используемый Библиотекой HDF5, и всегда доступен.)