2017-09-25 12:47:47 +00:00
|
|
|
##============================================================================
|
|
|
|
## Copyright (c) Kitware, Inc.
|
|
|
|
## All rights reserved.
|
|
|
|
## See LICENSE.txt for details.
|
2019-04-15 23:24:21 +00:00
|
|
|
##
|
2017-09-25 12:47:47 +00:00
|
|
|
## This software is distributed WITHOUT ANY WARRANTY; without even
|
|
|
|
## the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
|
|
## PURPOSE. See the above copyright notice for more information.
|
|
|
|
##============================================================================
|
|
|
|
|
|
|
|
include(CMakeParseArguments)
|
|
|
|
|
2020-06-18 19:48:48 +00:00
|
|
|
include(VTKmCMakeBackports)
|
2017-10-31 21:28:22 +00:00
|
|
|
include(VTKmDeviceAdapters)
|
2018-01-11 20:20:03 +00:00
|
|
|
include(VTKmCPUVectorization)
|
2020-06-18 19:48:48 +00:00
|
|
|
|
|
|
|
if(VTKm_ENABLE_MPI AND NOT TARGET MPI::MPI_CXX)
|
|
|
|
find_package(MPI REQUIRED MODULE)
|
|
|
|
endif()
|
2017-09-25 12:47:47 +00:00
|
|
|
|
2019-07-08 20:19:31 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
# INTERNAL FUNCTIONS
|
|
|
|
# No promises when used from outside VTK-m
|
|
|
|
|
2017-09-25 12:47:47 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
# Utility to build a kit name from the current directory.
|
|
|
|
function(vtkm_get_kit_name kitvar)
|
|
|
|
# Will this always work? It should if ${CMAKE_CURRENT_SOURCE_DIR} is
|
|
|
|
# built from ${VTKm_SOURCE_DIR}.
|
|
|
|
string(REPLACE "${VTKm_SOURCE_DIR}/" "" dir_prefix ${CMAKE_CURRENT_SOURCE_DIR})
|
|
|
|
string(REPLACE "/" "_" kit "${dir_prefix}")
|
|
|
|
set(${kitvar} "${kit}" PARENT_SCOPE)
|
|
|
|
# Optional second argument to get dir_prefix.
|
|
|
|
if (${ARGC} GREATER 1)
|
|
|
|
set(${ARGV1} "${dir_prefix}" PARENT_SCOPE)
|
2020-12-28 15:36:00 +00:00
|
|
|
endif ()
|
2017-09-25 12:47:47 +00:00
|
|
|
endfunction(vtkm_get_kit_name)
|
|
|
|
|
|
|
|
#-----------------------------------------------------------------------------
|
2018-04-09 15:05:51 +00:00
|
|
|
function(vtkm_pyexpander_generated_file generated_file_name)
|
2018-01-03 17:11:10 +00:00
|
|
|
# If pyexpander is available, add targets to build and check
|
2020-05-29 20:39:55 +00:00
|
|
|
if(PYEXPANDER_FOUND AND TARGET Python::Interpreter)
|
2018-01-03 17:11:10 +00:00
|
|
|
add_custom_command(
|
|
|
|
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/${generated_file_name}.checked
|
|
|
|
COMMAND ${CMAKE_COMMAND}
|
2020-05-29 20:39:55 +00:00
|
|
|
-DPYTHON_EXECUTABLE=${Python_EXECUTABLE}
|
2018-01-03 17:11:10 +00:00
|
|
|
-DPYEXPANDER_COMMAND=${PYEXPANDER_COMMAND}
|
|
|
|
-DSOURCE_FILE=${CMAKE_CURRENT_SOURCE_DIR}/${generated_file_name}
|
|
|
|
-DGENERATED_FILE=${CMAKE_CURRENT_BINARY_DIR}/${generated_file_name}
|
2019-04-03 16:32:42 +00:00
|
|
|
-P ${VTKm_CMAKE_MODULE_PATH}/testing/VTKmCheckPyexpander.cmake
|
2018-01-03 17:11:10 +00:00
|
|
|
MAIN_DEPENDENCY ${CMAKE_CURRENT_SOURCE_DIR}/${generated_file_name}.in
|
|
|
|
DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/${generated_file_name}
|
|
|
|
COMMENT "Checking validity of ${generated_file_name}"
|
|
|
|
)
|
|
|
|
add_custom_target(check_${generated_file_name} ALL
|
|
|
|
DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/${generated_file_name}.checked
|
|
|
|
)
|
|
|
|
endif()
|
2017-09-25 12:47:47 +00:00
|
|
|
endfunction(vtkm_pyexpander_generated_file)
|
|
|
|
|
2021-08-14 17:39:53 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
# Internal function that parses a C++ header file and extract explicit
|
|
|
|
# template instantiations.
|
|
|
|
#
|
|
|
|
# USAGE:
|
|
|
|
#
|
|
|
|
# _vtkm_extract_instantiations(
|
|
|
|
# instantiations # Out: List of instantiations (; are escaped to $)
|
|
|
|
# filter_header # In: The path of the header file to parse.
|
|
|
|
# )
|
|
|
|
#
|
|
|
|
function(_vtkm_extract_instantiations instantiations filter_header)
|
|
|
|
file(STRINGS "${filter_header}" read_file)
|
|
|
|
|
|
|
|
foreach(line ${read_file})
|
|
|
|
if("${line}" MATCHES "VTKM_INSTANTIATION_BEGIN")
|
|
|
|
set(buf "")
|
|
|
|
endif()
|
|
|
|
|
|
|
|
# Escape semicolon to zip line in list
|
|
|
|
string(REPLACE ";" "$" line "${line}")
|
|
|
|
list(APPEND buf ${line})
|
|
|
|
|
|
|
|
if("${line}" MATCHES "VTKM_INSTANTIATION_END")
|
|
|
|
list(JOIN buf "\n" buf)
|
|
|
|
|
|
|
|
# Extract, prepare, and store the instantiation
|
|
|
|
if(${buf} MATCHES
|
|
|
|
"VTKM_INSTANTIATION_BEGIN(.*)VTKM_INSTANTIATION_END")
|
|
|
|
|
|
|
|
set(buf ${CMAKE_MATCH_1})
|
|
|
|
|
|
|
|
# Remove heading and trailing spaces and newlines
|
|
|
|
string(REGEX REPLACE "(^[ \n]+)|([ \n]+$)|([ ]*extern[ ]*)" "" buf ${buf})
|
|
|
|
string(REPLACE "_TEMPLATE_EXPORT" "_EXPORT" buf ${buf})
|
|
|
|
|
|
|
|
list(APPEND _instantiations ${buf})
|
|
|
|
endif()
|
|
|
|
endif()
|
|
|
|
|
|
|
|
endforeach(line)
|
|
|
|
|
|
|
|
set(${instantiations} "${_instantiations}" PARENT_SCOPE)
|
|
|
|
endfunction(_vtkm_extract_instantiations)
|
|
|
|
|
2017-09-25 12:47:47 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
function(vtkm_generate_export_header lib_name)
|
|
|
|
# Get the location of this library in the directory structure
|
|
|
|
# export headers work on the directory structure more than the lib_name
|
|
|
|
vtkm_get_kit_name(kit_name dir_prefix)
|
|
|
|
|
|
|
|
# Now generate a header that holds the macros needed to easily export
|
|
|
|
# template classes. This
|
2020-08-19 23:20:43 +00:00
|
|
|
string(TOUPPER ${lib_name} BASE_NAME_UPPER)
|
2017-09-25 12:47:47 +00:00
|
|
|
set(EXPORT_MACRO_NAME "${BASE_NAME_UPPER}")
|
|
|
|
|
|
|
|
set(EXPORT_IS_BUILT_STATIC 0)
|
|
|
|
get_target_property(is_static ${lib_name} TYPE)
|
|
|
|
if(${is_static} STREQUAL "STATIC_LIBRARY")
|
|
|
|
#If we are building statically set the define symbol
|
|
|
|
set(EXPORT_IS_BUILT_STATIC 1)
|
|
|
|
endif()
|
|
|
|
unset(is_static)
|
|
|
|
|
|
|
|
get_target_property(EXPORT_IMPORT_CONDITION ${lib_name} DEFINE_SYMBOL)
|
|
|
|
if(NOT EXPORT_IMPORT_CONDITION)
|
|
|
|
#set EXPORT_IMPORT_CONDITION to what the DEFINE_SYMBOL would be when
|
|
|
|
#building shared
|
2020-08-19 23:20:43 +00:00
|
|
|
set(EXPORT_IMPORT_CONDITION ${lib_name}_EXPORTS)
|
2017-09-25 12:47:47 +00:00
|
|
|
endif()
|
|
|
|
|
|
|
|
|
|
|
|
configure_file(
|
2017-11-30 17:33:05 +00:00
|
|
|
${VTKm_SOURCE_DIR}/CMake/VTKmExportHeaderTemplate.h.in
|
2020-08-19 23:20:43 +00:00
|
|
|
${VTKm_BINARY_DIR}/include/${dir_prefix}/${lib_name}_export.h
|
2017-09-25 12:47:47 +00:00
|
|
|
@ONLY)
|
|
|
|
|
2018-01-02 16:06:40 +00:00
|
|
|
if(NOT VTKm_INSTALL_ONLY_LIBRARIES)
|
2020-08-19 23:20:43 +00:00
|
|
|
install(FILES ${VTKm_BINARY_DIR}/include/${dir_prefix}/${lib_name}_export.h
|
2018-01-02 16:06:40 +00:00
|
|
|
DESTINATION ${VTKm_INSTALL_INCLUDE_DIR}/${dir_prefix}
|
|
|
|
)
|
|
|
|
endif()
|
2017-09-25 12:47:47 +00:00
|
|
|
endfunction(vtkm_generate_export_header)
|
|
|
|
|
2018-10-16 19:01:39 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
2017-09-25 12:47:47 +00:00
|
|
|
function(vtkm_install_headers dir_prefix)
|
2018-01-02 16:06:40 +00:00
|
|
|
if(NOT VTKm_INSTALL_ONLY_LIBRARIES)
|
|
|
|
set(hfiles ${ARGN})
|
|
|
|
install(FILES ${hfiles}
|
|
|
|
DESTINATION ${VTKm_INSTALL_INCLUDE_DIR}/${dir_prefix}
|
|
|
|
)
|
|
|
|
endif()
|
2017-09-25 12:47:47 +00:00
|
|
|
endfunction(vtkm_install_headers)
|
|
|
|
|
|
|
|
|
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
function(vtkm_declare_headers)
|
|
|
|
vtkm_get_kit_name(name dir_prefix)
|
2019-01-24 19:26:40 +00:00
|
|
|
vtkm_install_headers("${dir_prefix}" ${ARGN})
|
2017-09-25 12:47:47 +00:00
|
|
|
endfunction(vtkm_declare_headers)
|
|
|
|
|
2019-11-29 20:49:54 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
function(vtkm_setup_job_pool)
|
|
|
|
# The VTK-m job pool is only used for components that use large amounts
|
|
|
|
# of memory such as worklet tests, filters, and filter tests
|
|
|
|
get_property(vtkm_pool_established
|
|
|
|
GLOBAL PROPERTY VTKM_JOB_POOL_ESTABLISHED SET)
|
|
|
|
if(NOT vtkm_pool_established)
|
|
|
|
# The VTK-m filters uses large amounts of memory to compile as it does lots
|
|
|
|
# of template expansion. To reduce the amount of tension on the machine when
|
|
|
|
# using generators such as ninja we restrict the number of VTK-m enabled
|
|
|
|
# compilation units to be built at the same time.
|
|
|
|
#
|
|
|
|
# We try to allocate a pool size where we presume each compilation process
|
2019-12-19 13:44:12 +00:00
|
|
|
# will require 3GB of memory. To allow for other NON VTK-m jobs we leave at
|
|
|
|
# least 3GB of memory as 'slop'.
|
2019-11-29 20:49:54 +00:00
|
|
|
cmake_host_system_information(RESULT vtkm_mem_ QUERY TOTAL_PHYSICAL_MEMORY)
|
2019-12-19 13:44:12 +00:00
|
|
|
math(EXPR vtkm_pool_size "(${vtkm_mem_}/3072)-1")
|
|
|
|
|
|
|
|
if (vtkm_pool_size LESS 1)
|
2019-11-29 20:49:54 +00:00
|
|
|
set(vtkm_pool_size 1)
|
|
|
|
endif ()
|
2019-12-19 13:44:12 +00:00
|
|
|
|
2019-11-29 20:49:54 +00:00
|
|
|
set_property(GLOBAL APPEND
|
|
|
|
PROPERTY
|
|
|
|
JOB_POOLS vtkm_pool=${vtkm_pool_size})
|
|
|
|
set_property(GLOBAL PROPERTY VTKM_JOB_POOL_ESTABLISHED TRUE)
|
|
|
|
endif()
|
|
|
|
endfunction()
|
|
|
|
|
2019-07-08 20:19:31 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
# FORWARD FACING API
|
|
|
|
|
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
# Pass to consumers extra compile flags they need to add to CMAKE_CUDA_FLAGS
|
|
|
|
# to have CUDA compatibility.
|
|
|
|
#
|
2020-06-11 13:59:17 +00:00
|
|
|
# If VTK-m was built with CMake 3.18+ and you are using CMake 3.18+ and have
|
|
|
|
# a cmake_minimum_required of 3.18 or have set policy CMP0105 to new, this will
|
|
|
|
# return an empty string as the `vtkm::cuda` target will correctly propagate
|
|
|
|
# all the necessary flags.
|
|
|
|
#
|
|
|
|
# This is required for CMake < 3.18 as they don't support the `$<DEVICE_LINK>`
|
|
|
|
# generator expression for `target_link_options`. Instead they need to be
|
|
|
|
# specified in CMAKE_CUDA_FLAGS
|
2019-07-08 20:19:31 +00:00
|
|
|
#
|
|
|
|
#
|
|
|
|
# add_library(lib_that_uses_vtkm ...)
|
|
|
|
# vtkm_add_cuda_flags(CMAKE_CUDA_FLAGS)
|
|
|
|
# target_link_libraries(lib_that_uses_vtkm PRIVATE vtkm_filter)
|
|
|
|
#
|
|
|
|
function(vtkm_get_cuda_flags settings_var)
|
2020-06-11 13:59:17 +00:00
|
|
|
|
2019-07-08 20:19:31 +00:00
|
|
|
if(TARGET vtkm::cuda)
|
2020-06-11 13:59:17 +00:00
|
|
|
if(POLICY CMP0105)
|
|
|
|
cmake_policy(GET CMP0105 does_device_link)
|
|
|
|
get_property(arch_flags
|
|
|
|
TARGET vtkm::cuda
|
|
|
|
PROPERTY INTERFACE_LINK_OPTIONS)
|
|
|
|
if(arch_flags AND CMP0105 STREQUAL "NEW")
|
|
|
|
return()
|
|
|
|
endif()
|
|
|
|
endif()
|
|
|
|
|
2019-07-08 20:19:31 +00:00
|
|
|
get_property(arch_flags
|
|
|
|
TARGET vtkm::cuda
|
2019-08-26 20:54:43 +00:00
|
|
|
PROPERTY cuda_architecture_flags)
|
2019-07-08 20:19:31 +00:00
|
|
|
set(${settings_var} "${${settings_var}} ${arch_flags}" PARENT_SCOPE)
|
|
|
|
endif()
|
|
|
|
endfunction()
|
|
|
|
|
2019-09-09 16:31:01 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
# Add to a target linker flags that allow unused VTK-m functions to be dropped,
|
|
|
|
# which helps keep binary sizes down. This works as VTK-m is compiled with
|
|
|
|
# ffunction-sections which allows for the linker to remove unused functions.
|
|
|
|
# If you are building a program that loads runtime plugins that can call
|
|
|
|
# VTK-m this most likely shouldn't be used as symbols the plugin expects
|
|
|
|
# to exist will be removed.
|
|
|
|
#
|
|
|
|
# add_library(lib_that_uses_vtkm ...)
|
|
|
|
# vtkm_add_drop_unused_function_flags(lib_that_uses_vtkm)
|
|
|
|
# target_link_libraries(lib_that_uses_vtkm PRIVATE vtkm_filter)
|
|
|
|
#
|
|
|
|
function(vtkm_add_drop_unused_function_flags uses_vtkm_target)
|
|
|
|
get_target_property(lib_type ${uses_vtkm_target} TYPE)
|
|
|
|
if(${lib_type} STREQUAL "SHARED_LIBRARY" OR
|
|
|
|
${lib_type} STREQUAL "MODULE_LIBRARY" OR
|
|
|
|
${lib_type} STREQUAL "EXECUTABLE" )
|
|
|
|
|
|
|
|
if(APPLE)
|
|
|
|
#OSX Linker uses a different flag for this
|
|
|
|
set_property(TARGET ${uses_vtkm_target} APPEND_STRING PROPERTY
|
|
|
|
LINK_FLAGS " -Wl,-dead_strip")
|
|
|
|
elseif(VTKM_COMPILER_IS_GNU OR VTKM_COMPILER_IS_CLANG)
|
|
|
|
set_property(TARGET ${uses_vtkm_target} APPEND_STRING PROPERTY
|
|
|
|
LINK_FLAGS " -Wl,--gc-sections")
|
|
|
|
endif()
|
|
|
|
|
|
|
|
endif()
|
|
|
|
endfunction()
|
|
|
|
|
2019-07-08 20:19:31 +00:00
|
|
|
|
2019-07-08 18:09:09 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
# Add a relevant information to target that wants to use VTK-m.
|
|
|
|
#
|
2019-09-11 12:45:36 +00:00
|
|
|
# This higher order function allow build-systems that use VTK-m
|
|
|
|
# to use `add_library` or `add_executable` calls but still have an
|
|
|
|
# easy to way to get the required information to have VTK-m using
|
|
|
|
# compilation units compile correctly.
|
2019-07-08 20:19:31 +00:00
|
|
|
#
|
2019-07-08 18:09:09 +00:00
|
|
|
# vtkm_add_target_information(
|
2019-09-11 12:45:36 +00:00
|
|
|
# target[s]
|
2019-09-09 16:31:01 +00:00
|
|
|
# [ DROP_UNUSED_SYMBOLS ]
|
2019-07-08 20:19:31 +00:00
|
|
|
# [ MODIFY_CUDA_FLAGS ]
|
|
|
|
# [ EXTENDS_VTKM ]
|
2019-09-09 16:31:01 +00:00
|
|
|
# [ DEVICE_SOURCES <source_list> ]
|
2019-07-08 18:09:09 +00:00
|
|
|
# )
|
2019-07-08 20:19:31 +00:00
|
|
|
#
|
|
|
|
# Usage:
|
|
|
|
# add_library(lib_that_uses_vtkm STATIC a.cxx)
|
|
|
|
# vtkm_add_target_information(lib_that_uses_vtkm
|
2019-09-09 16:31:01 +00:00
|
|
|
# DROP_UNUSED_SYMBOLS
|
2019-07-08 20:19:31 +00:00
|
|
|
# MODIFY_CUDA_FLAGS
|
|
|
|
# DEVICE_SOURCES a.cxx
|
|
|
|
# )
|
|
|
|
# target_link_libraries(lib_that_uses_vtkm PRIVATE vtkm_filter)
|
|
|
|
#
|
2019-09-09 16:31:01 +00:00
|
|
|
# DROP_UNUSED_SYMBOLS: If enabled will apply the appropiate link
|
|
|
|
# flags to drop unused VTK-m symbols. This works as VTK-m is compiled with
|
|
|
|
# -ffunction-sections which allows for the linker to remove unused functions.
|
|
|
|
# If you are building a program that loads runtime plugins that can call
|
|
|
|
# VTK-m this most likely shouldn't be used as symbols the plugin expects
|
|
|
|
# to exist will be removed.
|
|
|
|
# Enabling this will help keep library sizes down when using static builds
|
|
|
|
# of VTK-m as only the functions you call will be kept. This can have a
|
|
|
|
# dramatic impact on the size of the resulting executable / shared library.
|
|
|
|
#
|
|
|
|
#
|
2019-07-08 20:19:31 +00:00
|
|
|
# MODIFY_CUDA_FLAGS: If enabled will add the required -arch=<ver> flags
|
2020-06-11 13:59:17 +00:00
|
|
|
# that VTK-m was compiled with.
|
|
|
|
#
|
|
|
|
# If VTK-m was built with CMake 3.18+ and you are using CMake 3.18+ and have
|
|
|
|
# a cmake_minimum_required of 3.18 or have set policy CMP0105 to new, this will
|
|
|
|
# return an empty string as the `vtkm::cuda` target will correctly propagate
|
|
|
|
# all the necessary flags.
|
|
|
|
#
|
|
|
|
# Note: calling `vtkm_add_target_information` multiple times with
|
2019-09-11 12:45:36 +00:00
|
|
|
# `MODIFY_CUDA_FLAGS` will cause duplicate compiler flags. To resolve this issue
|
|
|
|
# you can; pass all targets and sources to a single `vtkm_add_target_information`
|
|
|
|
# call, have the first one use `MODIFY_CUDA_FLAGS`, or use the provided
|
|
|
|
# standalone `vtkm_get_cuda_flags` function.
|
2019-07-08 20:19:31 +00:00
|
|
|
#
|
2019-09-11 12:45:36 +00:00
|
|
|
# DEVICE_SOURCES: The collection of source files that are used by `target(s)` that
|
2019-07-08 20:19:31 +00:00
|
|
|
# need to be marked as going to a special compiler for certain device adapters
|
2021-10-12 19:48:28 +00:00
|
|
|
# such as CUDA. A source file generally needs to be in DEVICE_SOURCES if (and
|
|
|
|
# usually only if) it includes vtkm/cont/DeviceAdapterAlgorithm.h (either directly
|
|
|
|
# or indirectly). The most common code to include DeviceAdapterAlgorithm.h are
|
|
|
|
# those that use vtkm::cont::Algorithm or those that define worklets. Templated
|
|
|
|
# code that does computation often links to device adapter algorithms. Some
|
|
|
|
# device adapters that require a special compiler for device code will check in
|
|
|
|
# their headers that a device compiler is being used when it is needed. Such
|
|
|
|
# errors can be corrected by adding the source code to `DEVICE_SOURCES` (or
|
|
|
|
# removing the dependence on device algorithm when possible).
|
2019-07-08 20:19:31 +00:00
|
|
|
#
|
2019-08-27 17:31:45 +00:00
|
|
|
# EXTENDS_VTKM: Some programming models have restrictions on how types can be used,
|
|
|
|
# passed across library boundaries, and derived from.
|
2019-07-08 20:19:31 +00:00
|
|
|
# For example CUDA doesn't allow device side calls across dynamic library boundaries,
|
|
|
|
# and requires all polymorphic classes to be reachable at dynamic library/executable
|
|
|
|
# link time.
|
|
|
|
#
|
|
|
|
# To accommodate these restrictions we need to handle the following allowable
|
|
|
|
# use-cases:
|
|
|
|
# Object library: do nothing, zero restrictions
|
|
|
|
# Executable: do nothing, zero restrictions
|
|
|
|
# Static library: do nothing, zero restrictions
|
|
|
|
# Dynamic library:
|
|
|
|
# -> Wanting to use VTK-m as implementation detail, doesn't expose VTK-m
|
|
|
|
# types to consumers. This is supported no matter if CUDA is enabled.
|
2019-08-27 17:31:45 +00:00
|
|
|
# -> Wanting to extend VTK-m and provide these types to consumers.
|
|
|
|
# This is only supported when CUDA isn't enabled. Otherwise we need to ERROR!
|
|
|
|
# -> Wanting to pass known VTK-m types across library boundaries for others
|
|
|
|
# to use in filters/worklets.
|
|
|
|
# This is only supported when CUDA isn't enabled. Otherwise we need to ERROR!
|
2019-07-08 20:19:31 +00:00
|
|
|
#
|
|
|
|
# For most consumers they can ignore the `EXTENDS_VTKM` property as the default
|
|
|
|
# will be correct.
|
|
|
|
#
|
|
|
|
#
|
|
|
|
function(vtkm_add_target_information uses_vtkm_target)
|
2019-09-09 16:31:01 +00:00
|
|
|
set(options DROP_UNUSED_SYMBOLS MODIFY_CUDA_FLAGS EXTENDS_VTKM)
|
2019-07-08 20:19:31 +00:00
|
|
|
set(multiValueArgs DEVICE_SOURCES)
|
|
|
|
cmake_parse_arguments(VTKm_TI
|
|
|
|
"${options}" "${oneValueArgs}" "${multiValueArgs}"
|
|
|
|
${ARGN}
|
|
|
|
)
|
2019-07-08 18:09:09 +00:00
|
|
|
|
2019-09-11 12:45:36 +00:00
|
|
|
if(VTKm_TI_MODIFY_CUDA_FLAGS)
|
2020-06-11 13:59:17 +00:00
|
|
|
vtkm_get_cuda_flags(cuda_flags)
|
|
|
|
if(cuda_flags)
|
|
|
|
set(CMAKE_CUDA_FLAGS ${cuda_flags} PARENT_SCOPE)
|
|
|
|
endif()
|
2019-09-11 12:45:36 +00:00
|
|
|
endif()
|
|
|
|
|
|
|
|
set(targets ${uses_vtkm_target})
|
|
|
|
foreach(item IN LISTS VTKm_TI_UNPARSED_ARGUMENTS)
|
|
|
|
if(TARGET ${item})
|
|
|
|
list(APPEND targets ${item})
|
|
|
|
endif()
|
|
|
|
endforeach()
|
|
|
|
|
|
|
|
# set the required target properties
|
2021-08-20 22:01:30 +00:00
|
|
|
if(NOT VTKm_NO_DEPRECATED_VIRTUAL)
|
|
|
|
set_target_properties(${targets} PROPERTIES POSITION_INDEPENDENT_CODE ON)
|
|
|
|
set_target_properties(${targets} PROPERTIES CUDA_SEPARABLE_COMPILATION ON)
|
|
|
|
endif()
|
2020-06-11 13:59:17 +00:00
|
|
|
# CUDA_ARCHITECTURES added in CMake 3.18
|
|
|
|
set_target_properties(${targets} PROPERTIES CUDA_ARCHITECTURES OFF)
|
2019-09-11 12:45:36 +00:00
|
|
|
|
2019-09-09 16:31:01 +00:00
|
|
|
if(VTKm_TI_DROP_UNUSED_SYMBOLS)
|
|
|
|
foreach(target IN LISTS targets)
|
|
|
|
vtkm_add_drop_unused_function_flags(${target})
|
|
|
|
endforeach()
|
|
|
|
endif()
|
|
|
|
|
2020-09-16 13:57:54 +00:00
|
|
|
if((TARGET vtkm::cuda) OR (TARGET vtkm::kokkos_cuda))
|
|
|
|
set_source_files_properties(${VTKm_TI_DEVICE_SOURCES} PROPERTIES LANGUAGE "CUDA")
|
|
|
|
elseif(TARGET vtkm::kokkos_hip)
|
|
|
|
set_source_files_properties(${VTKm_TI_DEVICE_SOURCES} PROPERTIES LANGUAGE "HIP")
|
2021-08-06 19:41:07 +00:00
|
|
|
kokkos_compilation(SOURCE ${VTKm_TI_DEVICE_SOURCES})
|
2020-09-16 13:57:54 +00:00
|
|
|
endif()
|
|
|
|
|
2019-07-08 20:19:31 +00:00
|
|
|
# Validate that following:
|
|
|
|
# - We are building with CUDA enabled.
|
|
|
|
# - We are building a VTK-m library or a library that wants cross library
|
|
|
|
# device calls.
|
2019-07-08 18:09:09 +00:00
|
|
|
#
|
2019-07-08 20:19:31 +00:00
|
|
|
# This is required as CUDA currently doesn't support device side calls across
|
|
|
|
# dynamic library boundaries.
|
2021-08-20 22:01:30 +00:00
|
|
|
if((NOT VTKm_NO_DEPRECATED_VIRTUAL) AND ((TARGET vtkm::cuda) OR (TARGET vtkm::kokkos_cuda)))
|
2019-09-11 12:45:36 +00:00
|
|
|
foreach(target IN LISTS targets)
|
|
|
|
get_target_property(lib_type ${target} TYPE)
|
2020-06-16 12:54:01 +00:00
|
|
|
if (TARGET vtkm::cuda)
|
|
|
|
get_target_property(requires_static vtkm::cuda requires_static_builds)
|
|
|
|
endif()
|
|
|
|
if (TARGET vtkm::kokkos)
|
|
|
|
get_target_property(requires_static vtkm::kokkos requires_static_builds)
|
|
|
|
endif()
|
2019-07-08 18:09:09 +00:00
|
|
|
|
2019-09-11 12:45:36 +00:00
|
|
|
if(requires_static AND ${lib_type} STREQUAL "SHARED_LIBRARY" AND VTKm_TI_EXTENDS_VTKM)
|
|
|
|
#We provide different error messages based on if we are building VTK-m
|
|
|
|
#or being called by a consumer of VTK-m. We use PROJECT_NAME so that we
|
|
|
|
#produce the correct error message when VTK-m is a subdirectory include
|
|
|
|
#of another project
|
|
|
|
if(PROJECT_NAME STREQUAL "VTKm")
|
|
|
|
message(SEND_ERROR "${target} needs to be built STATIC as CUDA doesn't"
|
2019-07-08 20:19:31 +00:00
|
|
|
" support virtual methods across dynamic library boundaries. You"
|
2021-08-20 22:01:30 +00:00
|
|
|
" need to set the CMake option BUILD_SHARED_LIBS to `OFF` or"
|
|
|
|
" (better) turn VTKm_NO_DEPRECATED_VIRTUAL to `ON`.")
|
2019-09-11 12:45:36 +00:00
|
|
|
else()
|
|
|
|
message(SEND_ERROR "${target} needs to be built STATIC as CUDA doesn't"
|
|
|
|
" support virtual methods across dynamic library boundaries. You"
|
|
|
|
" should either explicitly call add_library with the `STATIC` keyword"
|
2021-08-20 22:01:30 +00:00
|
|
|
" or set the CMake option BUILD_SHARED_LIBS to `OFF` or"
|
|
|
|
" (better) turn VTKm_NO_DEPRECATED_VIRTUAL to `ON`.")
|
2019-09-11 12:45:36 +00:00
|
|
|
endif()
|
2019-07-08 20:19:31 +00:00
|
|
|
endif()
|
2019-09-11 12:45:36 +00:00
|
|
|
endforeach()
|
2019-07-08 20:19:31 +00:00
|
|
|
endif()
|
|
|
|
endfunction()
|
2019-07-08 18:09:09 +00:00
|
|
|
|
|
|
|
|
2017-09-25 12:47:47 +00:00
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
# Add a VTK-m library. The name of the library will match the "kit" name
|
|
|
|
# (e.g. vtkm_rendering) unless the NAME argument is given.
|
|
|
|
#
|
|
|
|
# vtkm_library(
|
2019-07-08 18:09:09 +00:00
|
|
|
# [ NAME <name> ]
|
2019-07-08 16:09:51 +00:00
|
|
|
# [ OBJECT | STATIC | SHARED ]
|
2017-09-25 12:47:47 +00:00
|
|
|
# SOURCES <source_list>
|
|
|
|
# TEMPLATE_SOURCES <.hxx >
|
|
|
|
# HEADERS <header list>
|
2019-11-29 20:49:54 +00:00
|
|
|
# USE_VTKM_JOB_POOL
|
2019-07-08 18:09:09 +00:00
|
|
|
# [ DEVICE_SOURCES <source_list> ]
|
2017-09-25 12:47:47 +00:00
|
|
|
# )
|
|
|
|
function(vtkm_library)
|
2019-11-29 20:49:54 +00:00
|
|
|
set(options OBJECT STATIC SHARED USE_VTKM_JOB_POOL)
|
2017-09-25 12:47:47 +00:00
|
|
|
set(oneValueArgs NAME)
|
2019-07-08 18:09:09 +00:00
|
|
|
set(multiValueArgs SOURCES HEADERS TEMPLATE_SOURCES DEVICE_SOURCES)
|
2017-09-25 12:47:47 +00:00
|
|
|
cmake_parse_arguments(VTKm_LIB
|
|
|
|
"${options}" "${oneValueArgs}" "${multiValueArgs}"
|
|
|
|
${ARGN}
|
|
|
|
)
|
|
|
|
|
|
|
|
if(NOT VTKm_LIB_NAME)
|
|
|
|
message(FATAL_ERROR "vtkm library must have an explicit name")
|
|
|
|
endif()
|
|
|
|
set(lib_name ${VTKm_LIB_NAME})
|
|
|
|
|
2019-07-08 16:09:51 +00:00
|
|
|
if(VTKm_LIB_OBJECT)
|
|
|
|
set(VTKm_LIB_type OBJECT)
|
|
|
|
elseif(VTKm_LIB_STATIC)
|
2018-12-13 18:47:39 +00:00
|
|
|
set(VTKm_LIB_type STATIC)
|
2019-07-08 16:09:51 +00:00
|
|
|
elseif(VTKm_LIB_SHARED)
|
|
|
|
set(VTKm_LIB_type SHARED)
|
2017-09-25 12:47:47 +00:00
|
|
|
endif()
|
|
|
|
|
|
|
|
add_library(${lib_name}
|
2018-08-16 20:34:44 +00:00
|
|
|
${VTKm_LIB_type}
|
2017-09-25 12:47:47 +00:00
|
|
|
${VTKm_LIB_SOURCES}
|
|
|
|
${VTKm_LIB_HEADERS}
|
|
|
|
${VTKm_LIB_TEMPLATE_SOURCES}
|
2019-07-08 18:09:09 +00:00
|
|
|
${VTKm_LIB_DEVICE_SOURCES}
|
2017-09-25 12:47:47 +00:00
|
|
|
)
|
2019-07-08 20:19:31 +00:00
|
|
|
vtkm_add_target_information(${lib_name}
|
2019-08-27 17:31:45 +00:00
|
|
|
EXTENDS_VTKM
|
2019-07-08 20:19:31 +00:00
|
|
|
DEVICE_SOURCES ${VTKm_LIB_DEVICE_SOURCES}
|
|
|
|
)
|
2020-05-12 20:02:16 +00:00
|
|
|
if(VTKm_HIDE_PRIVATE_SYMBOLS)
|
2019-07-08 20:19:31 +00:00
|
|
|
set_property(TARGET ${lib_name} PROPERTY CUDA_VISIBILITY_PRESET "hidden")
|
|
|
|
set_property(TARGET ${lib_name} PROPERTY CXX_VISIBILITY_PRESET "hidden")
|
2019-07-08 16:09:51 +00:00
|
|
|
endif()
|
2018-01-16 22:23:12 +00:00
|
|
|
#specify where to place the built library
|
2018-01-31 16:52:50 +00:00
|
|
|
set_property(TARGET ${lib_name} PROPERTY ARCHIVE_OUTPUT_DIRECTORY ${VTKm_LIBRARY_OUTPUT_PATH})
|
|
|
|
set_property(TARGET ${lib_name} PROPERTY LIBRARY_OUTPUT_DIRECTORY ${VTKm_LIBRARY_OUTPUT_PATH})
|
|
|
|
set_property(TARGET ${lib_name} PROPERTY RUNTIME_OUTPUT_DIRECTORY ${VTKm_EXECUTABLE_OUTPUT_PATH})
|
2017-09-25 12:47:47 +00:00
|
|
|
|
2018-04-17 18:05:07 +00:00
|
|
|
# allow the static cuda runtime find the driver (libcuda.dyllib) at runtime.
|
|
|
|
if(APPLE)
|
|
|
|
set_property(TARGET ${lib_name} PROPERTY BUILD_RPATH ${CMAKE_CUDA_IMPLICIT_LINK_DIRECTORIES})
|
|
|
|
endif()
|
|
|
|
|
2021-08-26 02:01:01 +00:00
|
|
|
if (NOT VTKm_SKIP_LIBRARY_VERSIONS)
|
|
|
|
# Setup the SOVERSION and VERSION information for this vtkm library
|
|
|
|
set_property(TARGET ${lib_name} PROPERTY VERSION 1)
|
|
|
|
set_property(TARGET ${lib_name} PROPERTY SOVERSION 1)
|
|
|
|
endif ()
|
2017-09-25 12:47:47 +00:00
|
|
|
|
2018-01-16 22:23:12 +00:00
|
|
|
# Support custom library suffix names, for other projects wanting to inject
|
|
|
|
# their own version numbers etc.
|
|
|
|
if(DEFINED VTKm_CUSTOM_LIBRARY_SUFFIX)
|
|
|
|
set(_lib_suffix "${VTKm_CUSTOM_LIBRARY_SUFFIX}")
|
|
|
|
else()
|
|
|
|
set(_lib_suffix "-${VTKm_VERSION_MAJOR}.${VTKm_VERSION_MINOR}")
|
|
|
|
endif()
|
|
|
|
set_property(TARGET ${lib_name} PROPERTY OUTPUT_NAME ${lib_name}${_lib_suffix})
|
|
|
|
|
|
|
|
#generate the export header and install it
|
2017-09-25 12:47:47 +00:00
|
|
|
vtkm_generate_export_header(${lib_name})
|
2018-01-16 22:23:12 +00:00
|
|
|
|
2019-01-24 19:26:40 +00:00
|
|
|
#install the headers
|
2018-04-05 14:10:20 +00:00
|
|
|
vtkm_declare_headers(${VTKm_LIB_HEADERS}
|
2019-01-24 19:26:40 +00:00
|
|
|
${VTKm_LIB_TEMPLATE_SOURCES})
|
2018-01-16 22:23:12 +00:00
|
|
|
|
2018-12-05 20:30:45 +00:00
|
|
|
# When building libraries/tests that are part of the VTK-m repository inherit
|
|
|
|
# the properties from vtkm_developer_flags. The flags are intended only for
|
|
|
|
# VTK-m itself and are not needed by consumers. We will export
|
|
|
|
# vtkm_developer_flags so consumer can use VTK-m's build flags if they so
|
|
|
|
# desire
|
|
|
|
if (VTKm_ENABLE_DEVELOPER_FLAGS)
|
|
|
|
target_link_libraries(${lib_name} PUBLIC $<BUILD_INTERFACE:vtkm_developer_flags>)
|
|
|
|
else()
|
|
|
|
target_link_libraries(${lib_name} PRIVATE $<BUILD_INTERFACE:vtkm_developer_flags>)
|
|
|
|
endif()
|
|
|
|
|
2018-01-16 22:23:12 +00:00
|
|
|
#install the library itself
|
2017-09-25 12:47:47 +00:00
|
|
|
install(TARGETS ${lib_name}
|
|
|
|
EXPORT ${VTKm_EXPORT_NAME}
|
|
|
|
ARCHIVE DESTINATION ${VTKm_INSTALL_LIB_DIR}
|
|
|
|
LIBRARY DESTINATION ${VTKm_INSTALL_LIB_DIR}
|
|
|
|
RUNTIME DESTINATION ${VTKm_INSTALL_BIN_DIR}
|
|
|
|
)
|
|
|
|
|
2019-11-29 20:49:54 +00:00
|
|
|
if(VTKm_LIB_USE_VTKM_JOB_POOL)
|
|
|
|
vtkm_setup_job_pool()
|
|
|
|
set_property(TARGET ${lib_name} PROPERTY JOB_POOL_COMPILE vtkm_pool)
|
|
|
|
endif()
|
|
|
|
|
2017-09-25 12:47:47 +00:00
|
|
|
endfunction(vtkm_library)
|
2021-08-14 17:39:53 +00:00
|
|
|
|
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
# Produce _instantiation-files_ given a filter.
|
|
|
|
#
|
|
|
|
# This function will parse the header file of a given filter and for each of
|
|
|
|
# the extern template found on it, it will produce its corresponding
|
|
|
|
# _instantiation-files_. Those produced `instantiation-files` are stored in
|
|
|
|
# the build directory and are not versioned.
|
|
|
|
#
|
|
|
|
# Usage:
|
|
|
|
# vtkm_add_instantiations(
|
|
|
|
# instantiations_list
|
|
|
|
# FILTER <name>
|
|
|
|
# [ INSTANTIATIONS_FILE <path> ]
|
|
|
|
# )
|
|
|
|
#
|
|
|
|
# instantiations_list: Output variable which contain the path of the newly
|
|
|
|
# produced _instantiation-files_.
|
|
|
|
#
|
|
|
|
# FILTER: The name of the filter of which we wish to produce those
|
|
|
|
# instantiations from.
|
|
|
|
#
|
|
|
|
# INSTANTIATIONS_FILE: _Optional_ parameter with the relative path of the file
|
|
|
|
# which contains the extern template instantiations. When omitted,
|
|
|
|
# `vtkm_add_instantiations` will default to `${FILTER}.h`.
|
|
|
|
#
|
|
|
|
function(vtkm_add_instantiations instantiations_list)
|
|
|
|
# Parse and validate parameters
|
|
|
|
set(oneValueArgs FILTER INSTANTIATIONS_FILE)
|
|
|
|
cmake_parse_arguments(VTKm_instantiations "" "${oneValueArgs}" "" ${ARGN})
|
|
|
|
|
|
|
|
if(NOT VTKm_instantiations_FILTER)
|
|
|
|
message(FATAL_ERROR "vtkm_add_instantiations needs a valid FILTER parameter")
|
|
|
|
endif()
|
|
|
|
|
|
|
|
set(filter ${VTKm_instantiations_FILTER})
|
|
|
|
set(file_header "${filter}.h")
|
|
|
|
|
|
|
|
set(file_template_source "${filter}.h")
|
|
|
|
if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/${filter}.hxx")
|
|
|
|
set(file_template_source "${filter}.hxx")
|
|
|
|
endif()
|
|
|
|
|
|
|
|
# Extract explicit instantiations
|
|
|
|
set(instantiations_file ${file_header})
|
|
|
|
if(VTKm_instantiations_INSTANTIATIONS_FILE)
|
|
|
|
set(instantiations_file ${VTKm_instantiations_INSTANTIATIONS_FILE})
|
|
|
|
endif()
|
|
|
|
_vtkm_extract_instantiations(instantiations ${instantiations_file})
|
|
|
|
|
|
|
|
# Compute relative path of header files
|
|
|
|
file(RELATIVE_PATH INSTANTIATION_FILTER_HEADER
|
2021-09-20 20:10:29 +00:00
|
|
|
${VTKm_SOURCE_DIR}
|
2021-08-14 17:39:53 +00:00
|
|
|
"${CMAKE_CURRENT_SOURCE_DIR}/${file_header}"
|
|
|
|
)
|
|
|
|
|
|
|
|
file(RELATIVE_PATH INSTANTIATION_FILTER_TEMPLATE_SOURCE
|
2021-09-20 20:10:29 +00:00
|
|
|
${VTKm_SOURCE_DIR}
|
2021-08-14 17:39:53 +00:00
|
|
|
"${CMAKE_CURRENT_SOURCE_DIR}/${file_template_source}"
|
|
|
|
)
|
|
|
|
|
|
|
|
# Generate instatiation file in the build directory
|
|
|
|
set(counter 0)
|
|
|
|
foreach(instantiation IN LISTS instantiations)
|
|
|
|
string(REPLACE "$" ";" instantiation ${instantiation})
|
|
|
|
set(INSTANTIATION_FILTER_METHOD "${instantiation}")
|
|
|
|
set(INSTANTIATION_FILTER_INC_GUARD "vtkm_filter_${filter}Instantiation${counter}_cxx")
|
|
|
|
|
|
|
|
# Create instantiation in build directory
|
|
|
|
set(instantiation_path "${CMAKE_CURRENT_BINARY_DIR}/${filter}Instantiation${counter}.cxx")
|
|
|
|
configure_file("${CMAKE_CURRENT_SOURCE_DIR}/InstantiationTemplate.cxx.in"
|
|
|
|
${instantiation_path}
|
|
|
|
@ONLY)
|
|
|
|
|
|
|
|
# Return value
|
|
|
|
list(APPEND _instantiations_list ${instantiation_path})
|
|
|
|
math(EXPR counter "${counter} + 1")
|
|
|
|
endforeach(instantiation)
|
|
|
|
|
|
|
|
set_source_files_properties(${_instantiations_list}
|
|
|
|
PROPERTIES SKIP_UNITY_BUILD_INCLUSION ON
|
|
|
|
)
|
|
|
|
set(${instantiations_list} ${_instantiations_list} PARENT_SCOPE)
|
|
|
|
endfunction(vtkm_add_instantiations)
|