3DCurvatureViewer
Computes and visualizes mean or gaussian curvature of binary shapes.
Vol file viewer, with curvature (mean or Gaussian, see parameters) information on surface. Blue color means lowest curvature Yellow color means highest curvature Red means the in-between
Uses IntegralInvariantCurvatureEstimation
- See also
- related article: Coeurjolly, D.; Lachaud, J.O; Levallois, J., (2013). Integral based Curvature Estimators in Digital Geometry. DGCI 2013. Retrieved from https://liris.cnrs.fr/publis/?id=5866
Usage: 3dCurvatureViewer -i file.vol –radius 5 –mode mean
Allowed options are:
Positionals:
1 TEXT:FILE REQUIRED vol file (.vol, .longvol .p3d, .pgm3d and if WITH_ITK is selected: dicom, dcm, mha, mhd). For longvol, dicom, dcm, mha or mhd formats, the input values are linearly scaled between 0 and 255.
Options:
-h,--help Print this help message and exit
-i,--input TEXT:FILE REQUIRED vol file (.vol, .longvol .p3d, .pgm3d and if WITH_ITK is selected: dicom, dcm, mha, mhd). For longvol, dicom, dcm, mha or mhd formats, the input values are linearly scaled between 0 and 255.
-r,--radius FLOAT REQUIRED Kernel radius for IntegralInvariant
-t,--threshold UINT=8 Min size of SCell boundary of an object
-l,--minImageThreshold INT=0 set the minimal image threshold to define the image object (object defined by the voxel with intensity belonging to ]minImageThreshold, maxImageThreshold ] ).
-u,--maxImageThreshold INT=255 set the maximal image threshold to define the image object (object defined by the voxel with intensity belonging to ]minImageThreshold, maxImageThreshold] ).
-m,--mode TEXT:{mean,gaussian,k1,k2,prindir1,prindir2,normal}=mean
type of output : mean, gaussian, k1, k2, prindir1, prindir2 or normal(default mean)
-o,--exportOBJ TEXT Export the scene to specified OBJ/MTL filename (extensions added).
-d,--exportDAT TEXT Export resulting curvature (for mean, gaussian, k1 or k2 mode) in a simple data file each line representing a surfel.
--exportOnly Used to only export the result without the 3d Visualisation (usefull for scripts).
-s,--imageScale FLOAT x 3 scaleX, scaleY, scaleZ: re sample the source image according with a grid of size 1.0/scale (usefull to compute curvature on image defined on anisotropic grid). Set by default to 1.0 for the three axis.
-n,--normalization BOOLEAN When exporting to OBJ, performs a normalization so that the geometry fits in [-1/2,1/2]^3
Below are the different available modes:
- "mean" for the mean curvature
- "gaussian" for the Gaussian curvature
- "k1" for the first principal curvature
- "k2" for the second principal curvature
- "prindir1" for the first principal curvature direction
- "prindir2" for the second principal curvature direction
- "normal" for the normal vector
Example:
Now we compare the different curvature values from the two shapes:
3dCurvatureViewer $DGtal/examples/samples/lobster.vol -r 10 -l 40 -u 255 -m mean
You should obtain such a visualisation:
resulting visualisation of mean curvature.
