Class SoFractalDimensionQuantification
 java.lang.Object

 com.openinventor.inventor.Inventor

 com.openinventor.inventor.misc.SoBase

 com.openinventor.inventor.fields.SoFieldContainer

 com.openinventor.inventor.engines.SoEngine

 com.openinventor.imageviz.engines.SoImageVizEngine

 com.openinventor.imageviz.engines.imageanalysis.morphometry.SoFractalDimensionQuantification

 All Implemented Interfaces:
SafeDisposable
public class SoFractalDimensionQuantification extends SoImageVizEngine
SoFractalDimensionQuantification
engine. TheSoFractalDimensionQuantification
engine measures fractal dimension.For an introduction, see:
 section Analysis
 section Morphometry
This engine computes the fractal dimension of a binary 2D or 3D image. It should be used only if the feature is known as being potentially a fractal one. This is the case of complex and irregular curves which cannot be easily described with traditional geometric tools, and/or for curves which are very similar to a part of themselves at different scales.
2D definition:
The 2D fractal dimension is a number greater than 1 and strictly lower than 2. The result is 1 in case of standard geometric features (straight lines, broken lines, circles, ...). Applied to 2D images the fractal dimension is quite an effective indicator to measure and compare the irregularity and the fragmentation at different magnifications. It is also a good indicator to evaluate how the curve fills the space. The less smooth the curve is, the bigger the fractal dimension.Caution: Do not use this engine on surfaces but on contours, according to the fractal definition. To be able to compare results, the outlines thickness should be very similar between the studied images and as small as possible so as to keep as much information as possible.
3D definition:
The 3D fractal dimension is a number greater than 2 and strictly lower than 3. The result is 2 in case of standard geometric surfaces (cubes, planes, ellipsoids, ...). Applied to 3D images the fractal dimension is quite an effective indicator to measure and compare the roughness of a surface. It is also a good indicator to evaluate how the curve fills the space. The less smooth the surface is, the bigger the fractal dimension. It can also be interpreted as a quantification of how complex the surface is and how it fills the space.Caution: Do not use this engine on volumes but on surfaces, according to the fractal definition. To be able to compare results, the surface thickness should be very similar between the studied images and as small as possible so as to keep as much information as possible.


Nested Class Summary
Nested Classes Modifier and Type Class Description static class
SoFractalDimensionQuantification.SbFractalDetail
Results details of fractal dimension.
Nested classes/interfaces inherited from class com.openinventor.imageviz.engines.SoImageVizEngine
SoImageVizEngine.ComputeModes, SoImageVizEngine.EventArg, SoImageVizEngine.Neighborhood3ds

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor
Inventor.ConstructorCommand


Field Summary
Fields Modifier and Type Field Description SoSFEnum<SoImageVizEngine.ComputeModes>
computeMode
Select the compute Mode (2D or 3D or AUTO) .SoSFImageDataAdapter
inBinaryImage
The input binary image.SoImageVizEngineAnalysisOutput<SoFractalDimensionQuantification.SbFractalDetail>
outResult
The output measure result.SoSFBool
useOnlyBorders
Select if use only the object borders to compute measure.
Fields inherited from class com.openinventor.imageviz.engines.SoImageVizEngine
onBegin, onEnd, onProgress

Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle


Constructor Summary
Constructors Constructor Description SoFractalDimensionQuantification()
Constructor.

Method Summary

Methods inherited from class com.openinventor.imageviz.engines.SoImageVizEngine
abortEvaluate, isEvaluating, startEvaluate, waitEvaluate

Methods inherited from class com.openinventor.inventor.engines.SoEngine
copy, getByName, getOutput, getOutputName

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase
dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable, touch

Methods inherited from class com.openinventor.inventor.Inventor
getNativeResourceHandle




Field Detail

computeMode
public final SoSFEnum<SoImageVizEngine.ComputeModes> computeMode
Select the compute Mode (2D or 3D or AUTO) . Default is MODE_AUTO

inBinaryImage
public final SoSFImageDataAdapter inBinaryImage
The input binary image. Default value is NULL. Supported types include: binary color image.

useOnlyBorders
public final SoSFBool useOnlyBorders
Select if use only the object borders to compute measure. Default value is true.

outResult
public final SoImageVizEngineAnalysisOutput<SoFractalDimensionQuantification.SbFractalDetail> outResult
The output measure result. Default value is NULL.

