FindHDF5
Поиск HDF5, библиотеки для чтения и записи данных массивов с самоописанием.
Этот модуль вызывает компилятор оболочки HDF5, который должен быть установлен вместе с HDF5. В зависимости от конфигурации HDF5, компилятор оболочки вызывается как h5cc или h5pcc. Если это успешно, модуль затем вызовет компилятор с аргументом -show, чтобы увидеть, какие флаги используются при компиляции приложения клиента HDF5.
Модуль необязательно принимает аргумент COMPONENTS. Если COMPONENTS не указаны, то модуль поиска по умолчанию ищет только библиотеку C HDF5. Если один или несколько 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.
© 2000–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.14/module/FindHDF5.html