FindHDF5

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

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

Модуль необязательно принимает аргумент COMPONENTS. Если COMPONENTS не указаны, то модуль поиска по умолчанию будет искать только библиотеку HDF5 C. Если указан один или несколько компонентов 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_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.