com.openinventor.imageviz.engines.imageanalysis.morphometry

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 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.

See also:

SoStructureModelIndexQuantification3d.

File format/default:

FractalDimensionQuantification {

computeMode	MODE_AUTO
inBinaryImage	NULL
useOnlyBorders	true

}

Library references: fractal

Nested Class Summary

Nested Classes

Modifier and Type	Class and 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 and 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

CONNECTIVITY_18, CONNECTIVITY_26, CONNECTIVITY_6, MODE_2D, MODE_3D, MODE_AUTO, onBegin, onEnd, onProgress

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and 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, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable, touch

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

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.