## Class SoFractalDimensionQuantification

• All Implemented Interfaces:
`SafeDisposable`

```public class SoFractalDimensionQuantification
extends SoImageVizEngine```
`SoFractalDimensionQuantification` engine. The `SoFractalDimensionQuantification` 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.

```SoStructureModelIndexQuantification3d File format/default: FractalDimensionQuantification { computeMode MODE_AUTO inBinaryImage NULL useOnlyBorders true } Library references: fractal```
• ### 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.

• ### 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`
• ### Methods inherited from class java.lang.Object

`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`
• ### 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.
• ### Constructor Detail

• #### SoFractalDimensionQuantification

`public SoFractalDimensionQuantification()`
Constructor.