com.openinventor.imageviz.engines.imageanalysis.morphometry

Class SoFragmentationIndexQuantification

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

All Implemented Interfaces:

SafeDisposable

public class SoFragmentationIndexQuantification
extends SoImageVizEngine

SoFragmentationIndexQuantification engine The SoFragmentationIndexQuantification engine computes an index of relative convexity or concavity of the surface.

For an introduction, see section Morphometry.

This engine computes an indicator of connectivity. It calculates an index of relative convexity or concavity of the surface. This index can be interpreted in mater of connectivity taken into account that concavity indicates connectivity, and that convexity indicates isolated disconnected structures.

The fragmentation index is calculated plane by plane for a 2D image by comparing area and perimeter (or volume and surface, respectively for a 3D image) of binarised image before and after an image dilation. It is defined :

Where and are respectively a perimeter and an area. The subscript and means for before and after dilation.

Dilation of an highly connected area will narrow spaces and then produce a smaller perimeter. On the other hand, open ends or nodes will have their perimeter expanded by surface dilation. As a result, lower fragmentation index signifies better connected area while higher fragmentation index means a more disconnected structure. In some case, high ratio of enclosed cavities and concave surfaces can result in fragmentation index to negative values.

See also:

SoAverageObjectThicknessQuantification3d, SoObjectLinearDensityQuantification3d.

File format/default:

FragmentationIndexQuantification {

computeMode	MODE_AUTO
inBinaryImage	NULL
elementSize	3

}

Library references: fragmentation

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoFragmentationIndexQuantification.SbFragmentationDetail Results details of fragmentation global measure.

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) .
SoSFInt32	elementSize The half size of the structuring element.
SoSFImageDataAdapter	inBinaryImage The input binary image.
SoImageVizEngineAnalysisOutput<SoFragmentationIndexQuantification.SbFragmentationDetail>	outResult The output measure result.

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
SoFragmentationIndexQuantification() 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.

elementSize

public final SoSFInt32 elementSize

The half size of the structuring element. A structuring element always has an odd side length (3x3, 5x5, etc) which is defined by 2 * elementSize + 1. Default value is 3.

outResult

public final SoImageVizEngineAnalysisOutput<SoFragmentationIndexQuantification.SbFragmentationDetail> outResult

The output measure result. Default value is NULL.

Constructor Detail

SoFragmentationIndexQuantification

public SoFragmentationIndexQuantification()

Constructor.