Wiki

Clone wiki

felix / Usage

Using Felix

The viewer executable is named mscomplex-tet-vtk-viewer. Launch the viewer. An example script that generates the visualizations for the Cosmogrid data set is available in the source code in vtk_viewer/scripts/.

You may load the script from the menu in the viewer or from command line as follows

$ mscomplex-tet-vtk-viewer -e vtk_viewer/scripts/cosmogrid_sgrid_ren.py

This will require the cosmogrid dataset. The dataset will be made available in due course. The script will compute the hierarchical MsComplex on the first load. Subsequent loads will be fast as the computations will be cached on disc.

Using the command line tool to compute mscomplexes

Note: This section is a little out of date. New featuers for structured grids are also now implemented.

The command line tool named mscomplex-tet-main. It accepts a manifold domain with boundary expressed as a collection of tetrahedra. The input is via an ascii file with extension .ts. The following is the format

<v> <t> <n>
x1 y1 z1 f11 f21 f31 .. fn1
x2 y2 z1 f12 f22 f32 .. fn2
..
..
xv yv zv f1v f2v f3v .. fnv
a1 b1 c1 d1
a2 b2 c2 d2
..
..
at bt ct dt

Here v is the number of vertices t is the number of tetrahedra n is the number of functions per vertex.

The tool is launched as follows

$ mscomplex-tet-main -f <ts-file> -t <simplification threshold> -c <scalar func to use>

The output is a binary file with the name .graph.bin replacing the .ts extension.

This file can contains the mscomplex and can be loaded by the mscomplex_t class in tet_mscomplex.cpp file.

Updated