com.openinventor.imageviz.engines.mathematicalmorphology.geodesictransformations

Class SoGrayscaleResconstructionProcessing

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.mathematicalmorphology.geodesictransformations.SoGrayscaleResconstructionProcessing

All Implemented Interfaces:

SafeDisposable

public class SoGrayscaleResconstructionProcessing
extends SoImageVizEngine

SoGrayscaleResconstructionProcessing engine The SoGrayscaleResconstructionProcessing engine removes the light points in a dark image (case Dilation) or the dark points in a light image (case Erosion).

It performs a numerical reconstruction from a grayscale marker image into the grayscale input image.

Case Dilation

This case of use removes the light points in a dark image.

At each step the marker image is dilated by a structuring element of size 1. This algorithm is based on a recursive method whereby the minimum of the dilated image and the mask image is retained and used as the marker image at the next step. This operation is repeated until stability. The number of iterations depends on the input image and the marker image. As shown in the figure 1, peaks and ridges are levelled down, which results in a much more homogeneous output image.

Case Erosion

This case of use removes the dark points in a light image.

At each step the marker image is eroded by a structuring element of size 1. This algorithm is based on a recursive method whereby the maximum of the eroded image and the mask image is retained and used as the marker image at the next step. This operation is repeated until stability. The number of iterations depends on the input image and the marker image. As shown in the figure 2, the valleys are levelled up, which results in a much more homogeneous output image.

This algorithm is used by the SoHExtremaProcessing engine.

See also:

SoHExtremaProcessing, SoMarkerBasedWatershedProcessing.

File format/default:

GrayscaleResconstructionProcessing {

computeMode	MODE_AUTO
neighborhood3d	CONNECTIVITY_26
reconstructMode	EROSION
inMaskImage	NULL
inMarkerImage	NULL

}

Library references: dualreconstruct numreconstruct

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoGrayscaleResconstructionProcessing.ReconstructModes

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) .
static int	DILATION Deprecated. Use SoGrayscaleResconstructionProcessing.ReconstructModes.DILATION instead.
static int	EROSION Deprecated. Use SoGrayscaleResconstructionProcessing.ReconstructModes.EROSION instead.
SoSFImageDataAdapter	inMarkerImage The input grayscale marker image containing seeds for reconstruction.
SoSFImageDataAdapter	inMaskImage The input grayscale mask image constraining reconstruction.
SoSFEnum<SoImageVizEngine.Neighborhood3ds>	neighborhood3d In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outImage The output image.
SoSFEnum<SoGrayscaleResconstructionProcessing.ReconstructModes>	reconstructMode Select the reconstruction mode to use.

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

DILATION

@Deprecated
public static final int DILATION

Deprecated. Use SoGrayscaleResconstructionProcessing.ReconstructModes.DILATION instead.

EROSION

@Deprecated
public static final int EROSION

Deprecated. Use SoGrayscaleResconstructionProcessing.ReconstructModes.EROSION instead.

computeMode

public final SoSFEnum<SoImageVizEngine.ComputeModes> computeMode

Select the compute Mode (2D or 3D or AUTO) . Default is MODE_AUTO

neighborhood3d

public final SoSFEnum<SoImageVizEngine.Neighborhood3ds> neighborhood3d

In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels. . Default is CONNECTIVITY_26.

reconstructMode

public final SoSFEnum<SoGrayscaleResconstructionProcessing.ReconstructModes> reconstructMode

Select the reconstruction mode to use. . Default is EROSION

inMaskImage

public final SoSFImageDataAdapter inMaskImage

The input grayscale mask image constraining reconstruction. Default value is NULL. Supported types include: grayscale binary label image.

inMarkerImage

public final SoSFImageDataAdapter inMarkerImage

The input grayscale marker image containing seeds for reconstruction. Default value is NULL. Supported types include: grayscale binary label image.

outImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outImage

The output image. Default value is NULL. Supported types include: grayscale binary label color image.

Constructor Detail

SoGrayscaleResconstructionProcessing

public SoGrayscaleResconstructionProcessing()

Constructor.