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 :

File options:
  -i [ --image-filename ] arg           input vol filename for image shape (object voxels
                                        have values > 0) or input cvs filename for surfels and
                                        normals
  -o [ --regularized-obj-filename ] arg output regularized obj
  -n [ --cubical-obj-filename ] arg     output cubical obj
  -k [ --shape-noise ] arg (=0)         noise shape parameter

Normal field estimator options:
  -r [ --normal-radius ] arg (=4) radius of normal estimator

Surface approximation options:
  -p [ --regularization-position ] arg (=1e-3)
                                        vertex position regularization coeff
  -c [ --regularization-center ] arg (=1e-2)
                                        face center regularization coeff
  -a [ --align ] arg (=1)               normal alignment coeff
  -f [ --fairness ] arg (=0)            face fairness coeff
  -b [ --barycenter ] arg (=1e-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