A Hands-on TTK Tutorial for Absolute Beginners
Note to
attendees
·
We kindly ask potential attendees to pre-register at
https://forms.gle/t4xX4a3pJjyiU67D9
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:
ttk-users@googlegroups.com
·
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).
- 9:00am Preliminaries (65 minutes)
- 10:05am Beak, discussion and Q&A (30 minutes)
- 10:35am Step-by-step examples (85 minutes)
Preliminaries
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.
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.
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
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.
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.
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.
·
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