DGtalTools  1.2.0
volSurfaceRegularization

Regularize a cubical complex into a smooth quadrangulated complex.

This is done by minimizing a quadratic energy function as decribed in ??. The variational formulation regularizes the position while aligning the regularized quads with an input normal vector field. In this tool, the input normal vector field can be either specified in the CSV input file, or computed using Integral Invariant (and -r option).

Usage: volSurfaceRegularization -input <volFileName> -o <regularizedcomplex.obj>

Allowed options are :

Positionals:
1 TEXT REQUIRED input vol filename for image shape (object voxels have values > 0) or input cvs filename for surfels and normals
1 TEXT REQUIRED output regularized obj
Options:
-h,--help Print this help message and exit
-i,--image-filename TEXT REQUIRED input vol filename for image shape (object voxels have values > 0) or input cvs filename for surfels and normals
-o,--regularized-obj-filename TEXT REQUIRED
output regularized obj
-n,--cubical-obj-filename TEXT output cubical obj
-k,--shape-noise FLOAT=0 noise shape parameter
[Option Group: Normal field estimator options]
Options:
-r,--normal-radius FLOAT=4 radius of normal estimator
[Option Group: Surface approximation options]
Options:
-p,--regularization-position FLOAT=0.001
vertex position regularization coeff
-c,--regularization-center FLOAT=0.01 face center regularization coeff
-a,--align FLOAT=1 normal alignment coeff
-f,--fairness FLOAT=0 face fairness coeff
-b,--barycenter FLOAT=0.1 barycenter fairness coeff

Example:

$ volSurfaceRegularization -i bunny.vol -o bunny_smooth.obj

You should obtain such a result:

Input cubical complex.
Smooth quadrangulated complex.
See also
volSurfaceRegularization.cpp