Difference between revisions of "Tutorial"

From VTKM
Jump to navigation Jump to search
m
(One intermediate revision by the same user not shown)
Line 14: Line 14:
 
* Download V1.4.0 [http://m.vtk.org/index.php/VTK-m_Releases#VTK-m_Version_1.4.0 here].
 
* Download V1.4.0 [http://m.vtk.org/index.php/VTK-m_Releases#VTK-m_Version_1.4.0 here].
 
** (note the build page assumes you will be accessing the master via a git clone, but we encourage you to use the released version for the tutorial)
 
** (note the build page assumes you will be accessing the master via a git clone, but we encourage you to use the released version for the tutorial)
* Do not enable the TBB or CUDA, at least at first.
+
* Do not enable the TBB, OpenMP or CUDA support, at least at first.
 
** (we stand behind our support for these backends, but it is good to start simple)
 
** (we stand behind our support for these backends, but it is good to start simple)
  
 
In all, your process on Unix/Mac should be something like:
 
In all, your process on Unix/Mac should be something like:
 
<pre>
 
<pre>
# (download VTK-m 1.4.0)
+
# wget https://gitlab.kitware.com/vtk/vtk-m/-/archive/v1.4.0/vtk-m-v1.4.0.tar.gz
 
# tar xvfz vtk-m-v1.4.0.tar.gz
 
# tar xvfz vtk-m-v1.4.0.tar.gz
 
# mkdir vtkm-build # out of source build
 
# mkdir vtkm-build # out of source build
 
# cd vtkm-build
 
# cd vtkm-build
# cmake ../vtk-m
+
# cmake ../vtk-m-v1.4.0
# make
+
# cmake --build . -j 4
 
</pre>
 
</pre>
  
Line 47: Line 47:
 
# cd $P
 
# cd $P
 
# tar xvf VTKm_tutorial_examples.tar # places 9 files in $PWD
 
# tar xvf VTKm_tutorial_examples.tar # places 9 files in $PWD
# <edit your CMakeLists.txt file so that VTKm_DIR points to the correct location>
+
# cmake . -DCMAKE_PREFIX_PATH="<path_to_vtkm-build>/vtkm/"
# cmake .
+
# cmake --build .  
# make
 
 
# ./tut_io # run 1st example
 
# ./tut_io # run 1st example
 
# ls out_io.vtk # confirms 1st example successfully completed
 
# ls out_io.vtk # confirms 1st example successfully completed
 
</pre>
 
</pre>

Revision as of 15:20, 9 August 2019

WARNING: Under development!


About this page

This page contains materials for a VTK-m tutorial. A mini version of the tutorial will be offered at the VTK-m Code Sprint in Albuquerque on July 30th. The full version (3.5 hours) will be offered at VIS19 in Vancouver, Canada on Sunday October 20th.


Download and build VTK-m

Process:

  • Download V1.4.0 here.
    • (note the build page assumes you will be accessing the master via a git clone, but we encourage you to use the released version for the tutorial)
  • Do not enable the TBB, OpenMP or CUDA support, at least at first.
    • (we stand behind our support for these backends, but it is good to start simple)

In all, your process on Unix/Mac should be something like:

# wget https://gitlab.kitware.com/vtk/vtk-m/-/archive/v1.4.0/vtk-m-v1.4.0.tar.gz
# tar xvfz vtk-m-v1.4.0.tar.gz
# mkdir vtkm-build # out of source build
# cd vtkm-build
# cmake ../vtk-m-v1.4.0
# cmake --build . -j 4

The main instructions to download and build are here. That said, we recommend following the instructions above.

Download tutorial materials

  1. [slides] (60+MB)
  2. [examples] (0.03MB)
  3. [kitchen.vtk data file] (2MB) (on Mac: right-click and "Save Link As")

Build example code

Your process on Unix/Mac should be something like:

# (downloads from above)
# export P=/path/where/you/want/to/run/tutorial/examples
# export D=/path/to/where/your/browser/downloads/files
# cp $D/kitchen.vtk $D/VTKm_tutorial_examples.tar $P
# cd $P
# tar xvf VTKm_tutorial_examples.tar # places 9 files in $PWD
# cmake . -DCMAKE_PREFIX_PATH="<path_to_vtkm-build>/vtkm/"
# cmake --build . 
# ./tut_io # run 1st example
# ls out_io.vtk # confirms 1st example successfully completed