Building VTK-m

Revision as of 23:39, 10 December 2014 by Kmorel (talk | contribs)
Jump to navigation Jump to search

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.

Getting VTK-m

VTK-m is currently available from a kitware git repository, which has public anonymous read access. URLs that can be used to clone the git repository can be found on the git project web page(

If you haven't used git before, consider following github's excellent setup guide. To get a copy of the repository, issue a git clone command.

git clone

The repository supports access with the http, git, and ssh protocols. Push access is only allowed with the SSH protocol. If you want to contribute to Dax please read the Contributing to VTK-m page. If you are a core developer of Dax please use this link to send your public SSH key to Kitware.


  • 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
mkdir vtkm-build
cd vtkm-build
cmake-gui ../vtkm
make test

(Note that parallel makes are supported, so you can run something like make -j4 to take advantage of multiple cores during the build.)


Documentation is currently a work in progress. For the latest version of the User's Guide, contact Ken Moreland <>.