DGtalTools  1.2.0
3dLocalEstimators

Compares local estimators on implicit shapes using DGtal library.

Usage: 3dLocalEstimators [options] –shape <shape> –h <h> –radius <radius> –estimators <binaryWord> –output <output>

Below are the different available families of estimators:

  • Integral Invariant Mean
  • Integral Invariant Gaussian
  • Monge Jet Fitting Mean
  • Monge Jet Fitting Gaussian

Allowed options are :

-h,--help Print this help message and exit
-s,--shape TEXT REQUIRED Shape
-o,--output TEXT=result.dat REQUIRED Output file
-r,--radius FLOAT REQUIRED Kernel radius for IntegralInvariant
--alpha FLOAT=0.333333 Alpha parameter for Integral Invariant computation
--h FLOAT REQUIRED Grid step
-a,--minAABB FLOAT=-10 Min value of the AABB bounding box (domain)
-A,--maxAABB FLOAT=10 Max value of the AABB bounding box (domain)
-n,--noise FLOAT=0 Level of noise to perturb the shape
-l,--lambda Use the shape to get a better approximation of the surface (optional)
--properties TEXT=110 the i-th property is disabled iff there is a 0 at position i
-e,--estimators TEXT=110 the i-th estimator is disabled iff there is a 0 at position i

Example: The following example will estimate the curvature of an implicit cone shape and will produce six resulting files (toto_II_gaussian.dat,toto_II_mean.dat, toto_MongeJetFitting_gaussian.dat, toto_MongeJetFitting_mean.dat, toto_True_gaussian.dat, toto_True_mean.dat)

./estimators/3dlocalEstimators --shape "z^2-x^2-y^2" --output result --h 0.4 --radius 1.0

You can check other example of implicit shapes like the followinf:

  • whitney : x^2-y*z^2
  • 4lines : x*y*(y-x)*(y-z*x)
  • cone : z^2-x^2-y^2
  • simonU : x^2-z*y^2+x^4+y^4
  • cayley3 : 4*(x^2 + y^2 + z^2) + 16*x*y*z - 1
  • crixxi : -0.9*(y^2+z^2-1)^2-(x^2+y^2-1)^3