interactive-track-and-trace/particle-track-and-trace

Vtk

This folder contains the Vtk program which actually displays the simulated data. The code is driven by the Program class, which contains the upper level of the vtk pipeline: the class has attributes for a vtkRenderWindow and vtkRenderWindowInteractor. vtkRenderers are managed through an abstract Layer class, which the program keeps track of trough a vector attribute.

Each layer implementation contains and manages one vtkRenderer, this includes managing which layer of the vtkrenderwindow ths layer renders to. Currently implemented are three such layers:

• the BackgroundImage class reads in image data and displays this to the screen on the 0th layer - the background.
• the EGlyphLayer class renders a visualization of the Eulerian flow-velocities as a grid of arrow-glyphs (in which the direction and length of the glyph represents the direction and strength of the velocity at that point). Right now it spoofs the data for these glyphs, but this class will interface with the code for reading h5 data to accurately display the velocities at a given timestamp.
• the LGlyphLayer class renders a given set of particles as circular glyphs. These particles are advected according to an advection function, which in this implementation is spoofed. Like the EglyphLayer class, this layer will interact with the code for advecting particles according to the actual dataset, to accurately simulate its particles.

The LGlyphLayer deserves some more explanation, as it depends on the SpawnpointCallback class to place particles in its dataset. The SpawnpointCallback makes use of the vtkCallbackCommand class and the vtk observer pattern to create new particles on mouseclick. It does so through a shared reference to the LGlyphLayer's data and points attributes, which the SpawnpointCallback then edits directlr.

The program also adds a second observer to the vtk pattern through the TimerCallbackCommand. This class subscribes to a vtkTimerEvent to manage the simulation of the program. To this end the TimerCallbackCommand has attributes for a timestep (dt) and current time (time). On every callback, the current time is updated according to the dt attribute, and this change is propagated to the layers containing the data by use of the program and layer's updateData() functions.

Location of data

The data path is hardcoded such that the following tree structure is assumed:

data/
  grid.h5
  hydrodynamic_U.h5
  hydrodynamic_V.h5
interactive-track-and-trace/
  particle-track-and-trace/
     ...

Compiling

Let the current directory be the src directory. Run:

mkdir build
cd build
cmake ..
make