FindHDF5
Найдите формат данных HDF5 (Hierarchical Data Format), библиотеку для чтения и записи данных массивов с описанием.
Этот модуль вызывает оболочку компилятора 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.15/module/FindHDF5.html