mirror of
https://gitlab.kitware.com/vtk/vtk-m
synced 2024-10-05 09:59:12 +00:00
c44f686496
The `DeviceAdapter` provides an abstract interface to the accelerator devices worklets and other algorithms run on. As such, the programmer has less control about how the device launches each worklet. Each device adapter has its own configuration parameters and other ways to attempt to optimize how things are run, but these are always a universal set of options that are applied to everything run on the device. There is no way to specify launch parameters for a particular worklet. To provide this information, VTK-m now supports `Hint`s to the device adapter. The `DeviceAdapterAlgorithm::Schedule` method takes a templated argument that is of the type `HintList`. This object contains a template list of `Hint` types that provide suggestions on how to launch the parallel execution. The device adapter will pick out hints that pertain to it and adjust its launching accordingly. These are called hints rather than, say, directives, because they don't force the device adapter to do anything. The device adapter is free to ignore any (and all) hints. The point is that the device adapter can take into account the information to try to optimize for itself. A provided hint can be tied to specific device adapters. In this way, an worklet can further optimize itself. If multiple hints match a device adapter, the last one in the list will be selected. The `Worklet` base now has an internal type named `Hints` that points to a `HintList` that is applied when the worklet is scheduled. Derived worklet classes can provide hints by simply defining their own `Hints` type.
310 lines
8.2 KiB
CMake
310 lines
8.2 KiB
CMake
##============================================================================
|
|
## Copyright (c) Kitware, Inc.
|
|
## All rights reserved.
|
|
## See LICENSE.txt for details.
|
|
##
|
|
## 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.
|
|
##============================================================================
|
|
|
|
set(headers
|
|
Algorithm.h
|
|
ArrayCopy.h
|
|
ArrayCopyDevice.h
|
|
ArrayExtractComponent.h
|
|
ArrayGetValues.h
|
|
ArrayHandle.h
|
|
ArrayHandleBasic.h
|
|
ArrayHandleBitField.h
|
|
ArrayHandleCartesianProduct.h
|
|
ArrayHandleCast.h
|
|
ArrayHandleCompositeVector.h
|
|
ArrayHandleConcatenate.h
|
|
ArrayHandleConstant.h
|
|
ArrayHandleCounting.h
|
|
ArrayHandleDecorator.h
|
|
ArrayHandleDiscard.h
|
|
ArrayHandleExtractComponent.h
|
|
ArrayHandleGroupVec.h
|
|
ArrayHandleGroupVecVariable.h
|
|
ArrayHandleImplicit.h
|
|
ArrayHandleIndex.h
|
|
ArrayHandleMultiplexer.h
|
|
ArrayHandleOffsetsToNumComponents.h
|
|
ArrayHandlePermutation.h
|
|
ArrayHandleRecombineVec.h
|
|
ArrayHandleReverse.h
|
|
ArrayHandleRandomStandardNormal.h
|
|
ArrayHandleRandomUniformBits.h
|
|
ArrayHandleRandomUniformReal.h
|
|
ArrayHandleRuntimeVec.h
|
|
ArrayHandleSOA.h
|
|
ArrayHandleStride.h
|
|
ArrayHandleSwizzle.h
|
|
ArrayHandleTransform.h
|
|
ArrayHandleUniformPointCoordinates.h
|
|
ArrayHandleView.h
|
|
ArrayHandleXGCCoordinates.h
|
|
ArrayHandleZip.h
|
|
ArrayPortal.h
|
|
ArrayPortalToIterators.h
|
|
ArrayRangeCompute.h
|
|
ArrayRangeComputeTemplate.h
|
|
ArrayRangeComputeTemplateInstantiationsIncludes.h
|
|
AssignerPartitionedDataSet.h
|
|
AtomicArray.h
|
|
BitField.h
|
|
BoundsCompute.h
|
|
BoundsGlobalCompute.h
|
|
CastAndCall.h
|
|
CellLocatorBoundingIntervalHierarchy.h
|
|
CellLocatorChooser.h
|
|
CellLocatorGeneral.h
|
|
CellLocatorPartitioned.h
|
|
CellLocatorRectilinearGrid.h
|
|
CellLocatorTwoLevel.h
|
|
CellLocatorUniformBins.h
|
|
CellLocatorUniformGrid.h
|
|
CellSet.h
|
|
CellSetExplicit.h
|
|
CellSetExtrude.h
|
|
CellSetList.h
|
|
CellSetPermutation.h
|
|
CellSetSingleType.h
|
|
CellSetStructured.h
|
|
ColorTable.h
|
|
ColorTableMap.h
|
|
ColorTableSamples.h
|
|
ConvertNumComponentsToOffsets.h
|
|
CoordinateSystem.h
|
|
DataSet.h
|
|
DataSetBuilderCurvilinear.h
|
|
DataSetBuilderExplicit.h
|
|
DataSetBuilderRectilinear.h
|
|
DataSetBuilderUniform.h
|
|
DeviceAdapter.h
|
|
DeviceAdapterAlgorithm.h
|
|
DeviceAdapterList.h
|
|
DeviceAdapterTag.h
|
|
DIYMemoryManagement.h
|
|
EnvironmentTracker.h
|
|
Error.h
|
|
ErrorBadAllocation.h
|
|
ErrorBadDevice.h
|
|
ErrorBadType.h
|
|
ErrorBadValue.h
|
|
ErrorExecution.h
|
|
ErrorFilterExecution.h
|
|
ErrorInternal.h
|
|
ErrorUserAbort.h
|
|
ExecutionAndControlObjectBase.h
|
|
ExecutionObjectBase.h
|
|
Field.h
|
|
FieldRangeCompute.h
|
|
FieldRangeGlobalCompute.h
|
|
Initialize.h
|
|
Invoker.h
|
|
Logging.h
|
|
MergePartitionedDataSet.h
|
|
ParticleArrayCopy.h
|
|
PartitionedDataSet.h
|
|
PointLocatorSparseGrid.h
|
|
RuntimeDeviceInformation.h
|
|
RuntimeDeviceTracker.h
|
|
Serialization.h
|
|
Storage.h
|
|
StorageList.h
|
|
Timer.h
|
|
Token.h
|
|
TryExecute.h
|
|
SerializableTypeString.h
|
|
UncertainArrayHandle.h
|
|
UncertainCellSet.h
|
|
UnknownArrayHandle.h
|
|
UnknownCellSet.h
|
|
Variant.h
|
|
)
|
|
|
|
set(template_sources
|
|
CellSetExplicit.hxx
|
|
ParticleArrayCopy.hxx
|
|
)
|
|
|
|
set(sources
|
|
ArrayHandle.cxx
|
|
ArrayHandleBasic.cxx
|
|
ArrayHandleSOA.cxx
|
|
ArrayHandleStride.cxx
|
|
AssignerPartitionedDataSet.cxx
|
|
BitField.cxx
|
|
BoundsCompute.cxx
|
|
BoundsGlobalCompute.cxx
|
|
CellLocatorGeneral.cxx
|
|
CellLocatorPartitioned.cxx
|
|
CellLocatorRectilinearGrid.cxx
|
|
CellLocatorUniformBins.cxx
|
|
CellLocatorUniformGrid.cxx
|
|
CellSet.cxx
|
|
CellSetStructured.cxx
|
|
ColorTablePresets.cxx
|
|
CoordinateSystem.cxx
|
|
DataSet.cxx
|
|
DataSetBuilderCurvilinear.cxx
|
|
DataSetBuilderExplicit.cxx
|
|
DataSetBuilderRectilinear.cxx
|
|
DataSetBuilderUniform.cxx
|
|
DeviceAdapterTag.cxx
|
|
DIYMemoryManagement.cxx
|
|
EnvironmentTracker.cxx
|
|
ErrorBadDevice.cxx
|
|
ErrorBadType.cxx
|
|
FieldRangeCompute.cxx
|
|
FieldRangeGlobalCompute.cxx
|
|
internal/DeviceAdapterMemoryManager.cxx
|
|
internal/DeviceAdapterMemoryManagerShared.cxx
|
|
internal/FieldCollection.cxx
|
|
internal/RuntimeDeviceConfiguration.cxx
|
|
internal/RuntimeDeviceConfigurationOptions.cxx
|
|
internal/RuntimeDeviceOption.cxx
|
|
Initialize.cxx
|
|
Logging.cxx
|
|
RuntimeDeviceTracker.cxx
|
|
PartitionedDataSet.cxx
|
|
Storage.cxx
|
|
Token.cxx
|
|
TryExecute.cxx
|
|
UnknownArrayHandle.cxx
|
|
UnknownCellSet.cxx
|
|
)
|
|
|
|
# This list of sources has code that uses devices and so might need to be
|
|
# compiled with a device-specific compiler (like CUDA).
|
|
set(device_sources
|
|
ArrayCopy.cxx
|
|
ArrayGetValues.cxx
|
|
ArrayHandleIndex.cxx
|
|
ArrayHandleUniformPointCoordinates.cxx
|
|
ArrayRangeCompute.cxx
|
|
CellLocatorBoundingIntervalHierarchy.cxx
|
|
CellLocatorUniformBins.cxx
|
|
CellLocatorTwoLevel.cxx
|
|
CellSetExplicit.cxx
|
|
CellSetExtrude.cxx
|
|
ColorTable.cxx
|
|
ConvertNumComponentsToOffsets.cxx
|
|
Field.cxx
|
|
internal/ArrayCopyUnknown.cxx
|
|
internal/ArrayRangeComputeUtils.cxx
|
|
internal/Buffer.cxx
|
|
internal/MapArrayPermutation.cxx
|
|
MergePartitionedDataSet.cxx
|
|
PointLocatorSparseGrid.cxx
|
|
RuntimeDeviceInformation.cxx
|
|
Timer.cxx
|
|
)
|
|
|
|
#-----------------------------------------------------------------------------
|
|
# Set up default types, which can be custom configured by other build systems.
|
|
vtkm_get_kit_name(kit_name kit_dir)
|
|
|
|
# Some custom types included with VTK-m
|
|
vtkm_option(VTKm_USE_DEFAULT_TYPES_FOR_VTK
|
|
"Compile VTK-m algorithms for use with types from VTK."
|
|
OFF
|
|
)
|
|
if (VTKm_USE_DEFAULT_TYPES_FOR_VTK)
|
|
set(VTKm_DEFAULT_TYPES_HEADER "internal/DefaultTypesVTK.h.in")
|
|
vtkm_option(VTKm_ADD_XGC_TO_DEFAULT_TYPES_VTK "Add XGC types to default VTK types." OFF)
|
|
mark_as_advanced(VTKm_ADD_XGC_TO_DEFAULT_TYPES_VTK)
|
|
if (VTKm_ADD_XGC_TO_DEFAULT_TYPES_VTK)
|
|
set(VTKM_ADD_XGC_DEFAULT_TYPES TRUE)
|
|
endif()
|
|
endif()
|
|
|
|
vtkm_option(VTKm_USE_DEFAULT_TYPES_FOR_ASCENT
|
|
"Compile VTK-m algorithms for use with types from Ascent."
|
|
OFF
|
|
)
|
|
if (VTKm_USE_DEFAULT_TYPES_FOR_ASCENT)
|
|
set(VTKm_DEFAULT_TYPES_HEADER "internal/DefaultTypesAscent.h.in")
|
|
if (VTKm_USE_64BIT_IDS)
|
|
message(SEND_ERROR
|
|
"When VTKm_USE_DEFAULT_TYPES_FOR_ASCENT is ON, VTKm_USE_64BIT_IDS must be set to OFF"
|
|
)
|
|
endif()
|
|
if (NOT VTKm_USE_DOUBLE_PRECISION)
|
|
message(SEND_ERROR
|
|
"When VTKm_USE_DEFAULT_TYPES_FOR_ASCENT is ON, VTKm_USE_DOUBLE_PRECISION must be set to ON"
|
|
)
|
|
endif()
|
|
endif()
|
|
|
|
mark_as_advanced(
|
|
VTKm_USE_DEFAULT_TYPES_FOR_VTK
|
|
VTKm_USE_DEFAULT_TYPES_FOR_ASCENT
|
|
)
|
|
|
|
if (VTKm_DEFAULT_TYPES_HEADER)
|
|
set(VTK_M_HAS_DEFAULT_TYPES_HEADER TRUE)
|
|
get_filename_component(VTKm_DEFAULT_TYPES_HEADER_FILENAME ${VTKm_DEFAULT_TYPES_HEADER} NAME_WE)
|
|
set(VTKm_DEFAULT_TYPES_HEADER_FILENAME "${VTKm_DEFAULT_TYPES_HEADER_FILENAME}.h")
|
|
configure_file(${VTKm_DEFAULT_TYPES_HEADER}
|
|
${VTKm_BINARY_INCLUDE_DIR}/${kit_dir}/internal/${VTKm_DEFAULT_TYPES_HEADER_FILENAME}
|
|
@ONLY
|
|
)
|
|
vtkm_install_headers(vtkm/cont/internal
|
|
${VTKm_BINARY_INCLUDE_DIR}/${kit_dir}/internal/${VTKm_DEFAULT_TYPES_HEADER_FILENAME}
|
|
)
|
|
endif()
|
|
|
|
configure_file(${CMAKE_CURRENT_SOURCE_DIR}/DefaultTypes.h.in
|
|
${VTKm_BINARY_INCLUDE_DIR}/${kit_dir}/DefaultTypes.h
|
|
@ONLY
|
|
)
|
|
vtkm_install_headers(vtkm/cont
|
|
${VTKm_BINARY_INCLUDE_DIR}/${kit_dir}/DefaultTypes.h
|
|
)
|
|
|
|
#-----------------------------------------------------------------------------
|
|
# Some operations are pre-compiled for many different types. Improve parallel
|
|
# compiles by breaking them up into smaller units.
|
|
vtkm_add_instantiations(array_range_instantiations
|
|
INSTANTIATIONS_FILE ArrayRangeComputeTemplate.h
|
|
TEMPLATE_SOURCE ArrayRangeComputeTemplateInstantiationsIncludes.h
|
|
)
|
|
list(APPEND device_sources ${array_range_instantiations})
|
|
|
|
#-----------------------------------------------------------------------------
|
|
vtkm_library( NAME vtkm_cont
|
|
SOURCES ${sources}
|
|
TEMPLATE_SOURCES ${template_sources}
|
|
HEADERS ${headers}
|
|
DEVICE_SOURCES ${device_sources}
|
|
)
|
|
|
|
target_sources(vtkm_cont
|
|
PRIVATE
|
|
internal/Hints.h
|
|
)
|
|
|
|
add_subdirectory(internal)
|
|
add_subdirectory(arg)
|
|
|
|
set(backends )
|
|
if(TARGET vtkm_tbb)
|
|
list(APPEND backends vtkm_tbb)
|
|
endif()
|
|
if(TARGET vtkm_cuda)
|
|
list(APPEND backends vtkm_cuda)
|
|
endif()
|
|
if(TARGET vtkm_openmp)
|
|
list(APPEND backends vtkm_openmp)
|
|
endif()
|
|
if(TARGET vtkm_kokkos)
|
|
list(APPEND backends vtkm_kokkos)
|
|
endif()
|
|
|
|
target_link_libraries(vtkm_cont PUBLIC vtkm_compiler_flags ${backends})
|
|
target_link_libraries(vtkm_cont PUBLIC Threads::Threads)
|