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.