Difference between revisions of "Building VTK-m"

From VTKM
Jump to navigation Jump to search
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
VTK-m is an open source C++ header toolkit that provides the ability to do fine-grained concurrency on scientific visualization data structures. VTK-m has few required dependencies but supports several optional components.
+
Information about [https://gitlab.kitware.com/vtk/vtk-m/blob/master/README.md#dependencies dependencies] and [https://gitlab.kitware.com/vtk/vtk-m/blob/master/README.md#building building VTK-m] has moved to the [https://gitlab.kitware.com/vtk/vtk-m/blob/master/README.md#building VTK-m README]. More detailed information can be found in the [[Media:VTKmUsersGuide.pdf|VTK-m User's Guide]].
 
 
== Getting VTK-m ==
 
 
 
VTK-m is currently available from a kitware gitlab instance, which has public anonymous read access. The git repository can be found on [https://gitlab.kitware.com/vtk/vtk-m the project web page](https://gitlab.kitware.com/vtk/vtk-m).
 
 
 
If you haven't used git before, consider following [https://help.github.com/articles/set-up-git github's excellent setup guide]. To get a copy of the repository, issue a git clone command.
 
 
 
git clone https://gitlab.kitware.com/vtk/vtk-m.git
 
 
 
The repository supports read access with the https, and ssh protocols.If you want to contribute to VTK-m please read the [[Contributing to VTK-m]] page.
 
 
 
== Dependencies ==
 
 
 
* CMake: VTK-m uses CMake to configure the build. You will need a relatively new version of CMake. CMake 2.8.10 or newer is recommended.
 
* Boost: VTK-m requires the header version of Boost 1.48.0 or better. You do not need to install the Boost libraries.
 
 
 
== Supported Operating Systems and Compilers ==
 
 
 
VTK-m is supported on Windows, Mac OSX, and Linux and should work on other varieties of Unix. It is possible to compile VTK-m with many different compiler versions including GNU, CLANG, MSVC, Intel, and PGI.
 
 
 
== Building VTK-m with CMake ==
 
 
 
Although VTK-m is header only, the code needs to be configured for the local system. VTK-m also has a large testing framework that will ensure it is working correctly on your system.
 
 
 
Always configure VTK-m so that the build tree is not the same as the source directory. The project will not run in if the source and build directories are the same.
 
 
 
The basic steps to setting up VTK-m are as follows:
 
 
 
git clone  https://gitlab.kitware.com/vtk/vtk-m.git
 
mkdir vtkm-build
 
cd vtkm-build
 
cmake-gui ../vtkm
 
make
 
make test
 
 
 
(Note that parallel makes are supported, so you can run something like <tt>make -j4</tt> to take advantage of multiple cores during the build.)
 
 
 
=== VTK-m CMake Settings ===
 
 
 
The VTK-m CMake configuration supports several options. Here are some options specific to VTK-m
 
 
 
{| cellpadding="2" cellspacing="0"
 
|- style="background:#abcdef"
 
! Variable
 
! Description
 
|-
 
| VTKm_ENABLE_BENCHMARKS || Turn on additional timing tests.
 
|-
 
| VTKm_ENABLE_CUDA || Enable CUDA backend.  Requires CUDA Toolkit and Thrust.
 
|-
 
| VTKm_ENABLE_TBB || Enable Intel Threading Building Blocks backend. Requires the TBB library.
 
|-
 
| VTKm_ENABLE_TESTING || Turn on header, unit, and benchmark tests.
 
|-
 
| VTKm_USE_64BIT_IDS || Enable 64 bit index support. This is the size of integers used to index arrays, points, cells, etc.
 
|-
 
| VTKm_USE_DOUBLE_PRECISION || Precision to use in floating point numbers when no other precision can be inferred. Use 64 bit precision when on, 32 bit precision when off.
 
|-
 
|}
 
 
 
== Documentation ==
 
 
 
Documentation is currently a work in progress. You can get download latest version of the [[Media:VTKmUsersGuide.pdf|VTK-m Users' Guide]] (Work in progress).
 
 
 
== Manual CMake Settings ==
 
 
 
Examples:
 
 
 
Boost only:
 
 
 
    cmake -DBoost_INCLUDE_DIR=/apps/boost/1.57.0/include ../vtk-m
 
 
 
Or with cuda:
 
 
 
    cmake -DBoost_INCLUDE_DIR=/apps/boost/1.57.0/include -DVTKm_ENABLE_CUDA=ON -DCUDA_TOOLKIT_ROOT_DIR=/usr/local/cuda70 ../vtk-m
 

Latest revision as of 16:27, 17 July 2019

Information about dependencies and building VTK-m has moved to the VTK-m README. More detailed information can be found in the VTK-m User's Guide.