com.openinventor.imageviz.engines.imagesegmentation.computationalgeometry

Class SoCenterLineApproximation3d

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.imagesegmentation.computationalgeometry.SoCenterLineApproximation3d

All Implemented Interfaces:

SafeDisposable

public class SoCenterLineApproximation3d
extends SoImageVizEngine

SoCenterLineApproximation3d engine The engine extracts the centerline of a binary image. A centerline is a path with a tree topology that approximates the input shape. The extraction procedure enforces the path to be equidistant to its boundaries.

The engine searches for a graph with tree topology (without loops). If the object contains loops this algorithms will not fail, instead it will just ignore certain connectivity so that the tree topology of graph is preserved.

The engine searches iteratively for the longest branch that can be added to the tree.

File format/default:

CenterLineApproximation3d {

inBinaryImage	NULL
autoMode	false
numberOfBranches	1
newBranchSensibility	3.0
distanceMapSmoothing	0.3
smoothingIteration	3

}

Notice: This engine requires to preliminarily load the whole input data set into memory to be computed. As a consequence the input data set will be automatically loaded before the execution of this engine, ignoring the maximum memory parameter of the SbImageDataAdapterHelper.getAppropriateAdapter function or SoFileDataAdapter class If the input data set cannot fit in memory, this engine will fail during its computation.

Library references: centerline3d

Nested Class Summary

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
SoSFBool	autoMode If this parameter is set to true the number of branches is computed automatically (the parameter newBranchSensibility controls the adding of new branches) otherwise branches are added until numberOfBranches connections is reached.
SoSFDouble	distanceMapSmoothing This parameter controls the smoothing of the distance map which is computed internally to make the tree centered.
SoSFImageDataAdapter	inLabelImage Input label image.
SoSFDouble	newBranchSensibility This parameter controls the adding of a new branch in the tree in automatic mode.
SoSFUInt32	numberOfBranches Number of branches iteratively added to the reconstructed centerline tree.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outBinaryImage Output centerline.
SoImageVizEngineOutput<SoSFFieldContainer,SoIndexedLineSet>	outLineSet Output line set.
SoSFUInt32	smoothingIteration Number of smoothing iteration of the output line set (post processing).

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
SoCenterLineApproximation3d() 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

inLabelImage

public final SoSFImageDataAdapter inLabelImage

Input label image. One centerline will be extracted by label. Default is NULL.

autoMode

public final SoSFBool autoMode

If this parameter is set to true the number of branches is computed automatically (the parameter newBranchSensibility controls the adding of new branches) otherwise branches are added until numberOfBranches connections is reached. Default value is false.

numberOfBranches

public final SoSFUInt32 numberOfBranches

Number of branches iteratively added to the reconstructed centerline tree. This parameter is not used if autoMode is set to true. Default value is 1.

newBranchSensibility

public final SoSFDouble newBranchSensibility

This parameter controls the adding of a new branch in the tree in automatic mode. A new branch is added to the tree only if its length (b in scheme) is newBranchSensibility time farther than the closest boundary point at junction (a in scheme). Default value is 3.0.

distanceMapSmoothing

public final SoSFDouble distanceMapSmoothing

This parameter controls the smoothing of the distance map which is computed internally to make the tree centered. Smoothing of the distance map can be useful when the distance map is not sufficiently smooth ( generally it leads to oscillation in the tree ). The filter is a Gaussian filter of standard deviation euclideanDistanceMapSigmaSmoothing. Default value is 0.3.

smoothingIteration

public final SoSFUInt32 smoothingIteration

Number of smoothing iteration of the output line set (post processing). A smoothing iteration applies a mean filter of size 3 on vertices. Default value is 3.

outBinaryImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outBinaryImage

Output centerline. The resulting image is a binary image that represents the extracted centerline. Default value is NULL.

outLineSet

public final SoImageVizEngineOutput<SoSFFieldContainer,SoIndexedLineSet> outLineSet

Output line set. This output is the geometric counterpart of the output binary image. Default value is NULL.

Constructor Detail

SoCenterLineApproximation3d

public SoCenterLineApproximation3d()

Constructor.