FindHDF5

Поиск библиотеки иерархического формата данных (HDF5), библиотеки для чтения и записи самоописываемых массивов данных.

Этот модуль вызывает HDF5 оболочку компилятора, которая должна быть установлена вместе с HDF5. В зависимости от HDF5 конфигурации, оболочка компилятора вызывается либо h5cc, либо h5pcc. Если это успешно, модуль вызовет компилятор с аргументом show, чтобы увидеть какие флаги используются при компиляции HDF5 клиентского приложения.

Модуль может необязательно принять аргумент COMPONENTS. Если не указаны COMPONENTS, то модуль поиска по умолчанию будет искать только библиотеку HDF5 C. Если указан один или несколько COMPONENTS, модуль попытается найти языковые привязки для указанных компонентов. Единственными допустимыми компонентами являются C, CXX, Fortran, HL, и Fortran_HL. Если аргумент COMPONENTS не указан, модуль попытается найти только привязки C.

Этот модуль будет считывать переменную HDF5_USE_STATIC_LIBRARIES для определения того, следует ли отдавать предпочтение статической ссылке динамической ссылке для HDF5 и всех его зависимостей. Для использования этой функции, убедитесь, что переменная HDF5_USE_STATIC_LIBRARIES установлена до вызова find_package.

Чтобы предоставить модулю подсказку о том, где найти вашу HDF5 установку, вы можете установить переменную среды HDF5_ROOT. Модуль поиска затем будет искать в этом пути при поиске HDF5 исполняемых файлов, путей и библиотек.

Как последовательные, так и параллельные HDF5 оболочки учитываются, и будет использован первый каталог, содержащий любой из них. В случае если оба появятся в одном каталоге, отдаётся предпочтение последовательной версии. Это поведение можно изменить, установив переменную HDF5_PREFER_PARALLEL в True.

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

Переменные результата

Этот модуль установит следующие переменные в вашем проекте:

HDF5_FOUND

HDF5 найден на системе

HDF5_VERSION

Версия библиотеки HDF5

HDF5_INCLUDE_DIRS

Расположение заголовочных файлов HDF5

HDF5_DEFINITIONS

Необходимые определения компилятора для HDF5

HDF5_LIBRARIES

Необходимые библиотеки для всех запрошенных привязок

HDF5_HL_LIBRARIES

Необходимые библиотеки для высокоуровневого API HDF5 для всех привязок, если компонент HL включен

Доступные компоненты: C CXX Fortran и HL. Для каждой включенной языковой привязки будет определена соответствующая переменная HDF5_${LANG}_LIBRARIES, а возможно и HDF5_${LANG}_DEFINITIONS. Если компонент HL включен, также будет определена переменная HDF5_${LANG}_HL_LIBRARIES. При включении всех компонентов будут определены следующие переменные:

HDF5_C_DEFINITIONS

Необходимые определения компилятора для привязок HDF5 C

HDF5_CXX_DEFINITIONS

Необходимые определения компилятора для привязок HDF5 C++

HDF5_Fortran_DEFINITIONS

Необходимые определения компилятора для привязок HDF5 Fortran

HDF5_C_INCLUDE_DIRS

Необходимые каталоги включаемых файлов для привязок HDF5 C

HDF5_CXX_INCLUDE_DIRS

Необходимые каталоги включаемых файлов для привязок HDF5 C++

HDF5_Fortran_INCLUDE_DIRS

Необходимые каталоги включаемых файлов для привязок HDF5 Fortran

HDF5_C_LIBRARIES

Необходимые библиотеки для привязок HDF5 C

HDF5_CXX_LIBRARIES

Необходимые библиотеки для привязок HDF5 C++

HDF5_Fortran_LIBRARIES

Необходимые библиотеки для привязок HDF5 Fortran

HDF5_C_HL_LIBRARIES

Необходимые библиотеки для высокоуровневых C привязок

HDF5_CXX_HL_LIBRARIES

Необходимые библиотеки для высокоуровневых C++ привязок

HDF5_Fortran_HL_LIBRARIES

Необходимые библиотеки для высокоуровневых Fortran привязок.

HDF5_IS_PARALLEL

Библиотека HDF5 поддерживает параллельный ввод-вывод

HDF5_C_COMPILER_EXECUTABLE

путь к оболочке компилятора HDF5 C

HDF5_CXX_COMPILER_EXECUTABLE

путь к оболочке компилятора HDF5 C++

HDF5_Fortran_COMPILER_EXECUTABLE

путь к оболочке компилятора HDF5 Fortran

HDF5_C_COMPILER_EXECUTABLE_NO_INTERROGATE

путь к основному компилятору C, который также является оболочкой HDF5

HDF5_CXX_COMPILER_EXECUTABLE_NO_INTERROGATE

путь к основному компилятору C++, который также является оболочкой HDF5

HDF5_Fortran_COMPILER_EXECUTABLE_NO_INTERROGATE

путь к основному компилятору Fortran, который также является оболочкой HDF5

HDF5_DIFF_EXECUTABLE

путь к инструменту сравнения наборов данных HDF5

Подсказки

Следующая переменная может быть установлена для управления поиском библиотек и заголовочных файлов HDF5:

HDF5_ROOT

Укажите путь к установке HDF5 для использования.

HDF5_FIND_DEBUG

Установите true для получения дополнительных отладочных данных.

HDF5_NO_FIND_PACKAGE_CONFIG_FILE

Установите true для пропуска попытки поиска hdf5-config.cmake.