Overview

HTTPS SSH

Mesh generation and visualization utilities based on CGAL.

Folder content

drawmesh
Visualize slices of the mesh (surface/volumetric) as wireframe on top of an image (3D).
drawsurf
Visualize surfaces of the mesh (surface/volumetric).
img2mesh
Convert isosurface in image to volumetric mesh (medit format).
img2off
Convert isosurface in image to surface mesh (off format).
off2mesh
Convert surface mesh (off format) to volumetric mesh (medit format).
reduce
Crop and resize 3D and stacks of images.
data
Example data to test the library on.

Compilation and installation

All provided utilities are written in C++ and python wrappers are provided for img2mesh, img2off and off2mesh.

Compile and install binaries with CMake

To do this, navigate to the subfolder bin and type "ccmake .." once makefiles have been generated type "make" to compile the mesher and/or "make install" to compile and install the mesher.

Note: for faster execution, change the CMAKE_BUILD_TYPE variable to Release

Dependencies: - CGAL - Boost - CImg - NiftiCLib (optional) - TIFF (optional) - SDL (optional - OpenGL (optional)

The python wrapper can optionally be build with: python setup.py build_ext --inplace

Usage

Help messages can be printed for each program by using -h or --help arguments.

Create a surface mesh from the example data:
img2off -i data/cropped.vol -o data/cropped.off
Create a volumetric mesh from the example data:
img2mesh -i data/cropped.vol -o data/cropped.mesh
Create a volumetric mesh from a surface mesh:
off2mesh -i data/cropped.off -o data/cropped.mesh