Topology ToolKit


A Hands-on TTK Tutorial for Absolute Beginners

IEEE VIS 2023 Tutorial
Sunday October 22, 2023, 9:00am-12:00pm
IEEE VIS, Melbourne, Australia

 · Tutorial pre-registration
 · IEEE VIS 2023 registration

Please see our Events page for all tutorials in this series.

Note to attendees

 ·  We kindly ask potential attendees to pre-register at in order for us to reach out to them ahead of the tutorial with information updates (for instance, last minute updates, instructions for the download of the tutorial material package, etc.)
 ·  If you plan to attend this tutorial, we invite you to install TTK on your system before the tutorial. The easiest way is simply to download ParaView's latest binary. For alternatives, (sources, Ubuntu packages, Anaconda packages, Docker images, etc.), see the installation instructions.
 ·  Please do not hesitate to reach out ahead of the tutorial if you experience any issue installing TTK:

Resources and Materials

 ·  ParaView Download
 ·  Tutorial Data Package
 ·  Detailed tutorial submission document
 ·  TTK's online example database


This tutorial provides a basic, beginner’s introduction to topological data analysis and visualization with the Topology ToolKit (TTK). While previous editions of the TTK tutorial (2018 to 2022) were organized as mini-symposia (focused on the descriptions of TTK’s latest features), this year, in contrast, we would like to organize a very basic beginner’s hands-on tutorial. Specifically, the goal of this tutorial is to accompany attendees in the installation of TTK on their laptop as well as in the running of a few basic examples, all in a very beginner-friendly step-by-step description. This decision is motivated by attendee feedback which we collected at previous editions of the TTK tutorial. We address this feedback in this tutorial proposal. Then, for the first time, beginners would be able to come to the tutorial without prior TTK experience, and walk out with TTK installed on their system, capable of running a few examples and ready to go further. We believe this basic hands-on tutorial will facilitate the adoption of TTK and topological techniques to a broader audience. The tutorial will be organized as follows. The first hands-on exercise will be dedicated to the installation of TTK. The second hands-on exercise will be focused on ParaView’s basic usage. The following three hands-on exercises will be dedicated to the step-by-step replication of three examples extracted from TTK’s online example database (vortex extraction in fluid dynamics, Morse-Smale complex extraction in quantum chemistry and merge tree comparison in ensemble data).



  1. 9:00am Preliminaries (65 minutes)

  2. 10:05am Beak, discussion and Q&A (30 minutes)

  3. 10:35am Step-by-step examples (85 minutes)



 ·  General introduction (Julien Tierny)
 ·  Installing TTK
This first hands-on session will describe how to install TTK. Several options will be presented. The default option would be via the installation of Kitware’s official ParaView distribution. Other options will be presented, such as Ubuntu packages, Anaconda packages or Docker images. At the end of this session, we expect all attendees to have TTK installed and running on their laptop.
 ·  Introduction to Topological Data Analysis (Bei Wang)
This talk will cover the theoretical notions about Topological Data Analysis which are required for the followup step-by-step examples (Sec. B). Specifically, it will introduce: critical points, persistence diagrams, Reeb graphs, and Morse-Smale complexes. Also, it will illustrate how these notions can be used for data analysis.
 ·  Introduction to ParaView's basic usage (Julien Tierny)
This second hands-on session will describe the basic notions for using ParaView. The notion of pipeline browser will be presented, along with the properties and information panels for each filter of the pipeline. The different views will also be discussed. Screenshot features will be illustrated. Finally, pipeline IO will be presented (PVSM statefile) and Python exports will be illustrated.

Step-by-step examples

 ·  Vortex extraction in fluid dynamics (Florian Wetzels)
This hands-on exercise will present the entry Builtin Example 1 from TTK’s online example database. Then, we will describe to participants how to completely re-create this example from scratch.
 ·  Morse-Smale complex computation (Robin Maack)
This hands-on exercise will present the entry Morse-Smale Segmentation AT from TTK’s online example database. Then, we will describe to participants how to completely re-create this example from scratch.
 ·  Persistence diagram comparison and matching (Mathieu Pont)
This hands-on exercise will present the entry Persistence Diagram Distance from TTK’s online example database. Then, we will describe to participants how to completely re-create this example from scratch.
 ·  Concluding remarks (Julien Tierny)

Additional Material

 ·  TTK overview video
 ·  TTK example website (scripts, state files, screenshots, etc.)
 ·  TTK Technical presentation at IEEE VIS 2017 (for advanced users)
 ·  TTK Technical report (for advanced users)
 ·  TTK feature overview
 ·  TTK user forum
 · Using TTK in-situ with Catalyst: Online tutorial
 · Using TTK with Python: Online example - Online tutorial
 · Using TTK with VTK/C++: Online example
 · Using TTK with pure C++: Online example
 · Extending TTK with a new module: Online tutorial (computation of Betti numbers)
 · TTK developer documentation