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 label 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 orSoFileDataAdapter
classIf 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 Description SoSFBool
autoMode
If this parameter is set to true the number of branches is computed automatically (the parameternewBranchSensibility
controls the adding of new branches) otherwise branches are added untilnumberOfBranches
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
onBegin, onEnd, onProgress
-
Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle
-
-
Constructor Summary
Constructors Constructor 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, getName, isDisposable, isSynchronizable, setName, setSynchronizable, touch
-
Methods inherited from class com.openinventor.inventor.Inventor
getNativeResourceHandle
-
-
-
-
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 parameternewBranchSensibility
controls the adding of new branches) otherwise branches are added untilnumberOfBranches
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.
-
-