FindHDF5

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

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

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

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

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

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

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

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

HDF5_INCLUDE_DIRS - Location of the hdf5 includes
HDF5_INCLUDE_DIR - Location of the hdf5 includes (deprecated)
HDF5_DEFINITIONS - Required compiler definitions for HDF5
HDF5_C_LIBRARIES - Required libraries for the HDF5 C bindings.
HDF5_CXX_LIBRARIES - Required libraries for the HDF5 C++ bindings
HDF5_Fortran_LIBRARIES - Required libraries for the HDF5 Fortran bindings
HDF5_HL_LIBRARIES - Required libraries for the HDF5 high level API
HDF5_Fortran_HL_LIBRARIES - Required libraries for the high level Fortran
                            bindings.
HDF5_LIBRARIES - Required libraries for all requested bindings
HDF5_FOUND - true if HDF5 was found on the system
HDF5_VERSION - HDF5 version in format Major.Minor.Release
HDF5_LIBRARY_DIRS - the full set of library directories
HDF5_IS_PARALLEL - Whether or not HDF5 was found with parallel IO support
HDF5_C_COMPILER_EXECUTABLE - the path to the HDF5 C wrapper compiler
HDF5_CXX_COMPILER_EXECUTABLE - the path to the HDF5 C++ wrapper compiler
HDF5_Fortran_COMPILER_EXECUTABLE - the path to the HDF5 Fortran wrapper compiler
HDF5_DIFF_EXECUTABLE - the path to the HDF5 dataset comparison tool