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 - true if HDF5 was found on the system
HDF5_VERSION - HDF5 version in format Major.Minor.Release
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_LIBRARIES - Required libraries for all requested bindings
HDF5_HL_LIBRARIES - Required libraries for the HDF5 high level API for all
                    bindings, if the HL component is enabled

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

HDF5_C_DEFINITIONS -- Required compiler definitions for HDF5 C bindings
HDF5_CXX_DEFINITIONS -- Required compiler definitions for HDF5 C++ bindings
HDF5_Fortran_DEFINITIONS -- Required compiler definitions for HDF5 Fortran bindings
HDF5_C_INCLUDE_DIRS -- Required include directories for HDF5 C bindings
HDF5_CXX_INCLUDE_DIRS -- Required include directories for HDF5 C++ bindings
HDF5_Fortran_INCLUDE_DIRS -- Required include directories for HDF5 Fortran bindings
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_C_HL_LIBRARIES - Required libraries for the high level C bindings
HDF5_CXX_HL_LIBRARIES - Required libraries for the high level C++ bindings
HDF5_Fortran_HL_LIBRARIES - Required libraries for the high level Fortran
                            bindings.

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_C_COMPILER_EXECUTABLE_NO_INTERROGATE - path to the primary C compiler
                                            which is also the HDF5 wrapper
HDF5_CXX_COMPILER_EXECUTABLE_NO_INTERROGATE - path to the primary C++
                                              compiler which is also
                                              the HDF5 wrapper
HDF5_Fortran_COMPILER_EXECUTABLE_NO_INTERROGATE - path to the primary
                                                  Fortran compiler which
                                                  is also the HDF5 wrapper
HDF5_DIFF_EXECUTABLE - the path to the HDF5 dataset comparison tool

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

HDF5_ROOT

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

HDF5_FIND_DEBUG

Установите в значение true, чтобы получить дополнительные данные отладки.

HDF5_NO_FIND_PACKAGE_CONFIG_FILE

Установите в значение true, чтобы пропустить попытку найти hdf5-config.cmake.