com.openinventor.imageviz.engines.mathematicalmorphology.geodesictransformations

Class SoRegionalExtremaProcessing

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

All Implemented Interfaces:

SafeDisposable

public class SoRegionalExtremaProcessing
extends SoImageVizEngine

SoRegionalExtremaProcessing engine. The SoRegionalExtremaProcessing engine computes the regional or relative fast maxima and minima in a grayscale image, , and displays the result in a binary image, . This algorithm is based on [1] and uses a recursive method combined with a geodesic propagation. To avoid getting too many regions in the output image, input should first be smoothed with a low-pass filter or with the dual numerical reconstruction algorithm.

Case Minima

This case of use computes the regional or relative minima in a grayscale image and creates a binary image containing these minima.

A regional minimum is a set of connected pixels such that:

  - Pixels belonging to \form#70 have the same intensity \form#583.
  - Pixels connected to \form#70, but not belonging to \form#70 (neighbors), 

have an intensity greater than .

Case Maxima

This engine computes the regional or relative maxima in a grayscale image and creates a binary image containing these maxima.

A regional maximum is a set of connected pixels such that:

  - Pixels belonging to \form#70 have the same intensity \form#583.
  - Pixels connected to \form#70, but not belonging to \form#70 (neighbors), 

have an intensity greater than .

[1] B. La. "Recursive Algorithms in Mathematical Morphology." In Acta Stereologica. Vol. 6/III, pp 691-696, Caen, France, Sept. 1987. 7th International Congress For Stereology.

See also:

SoGrayscaleResconstructionProcessing.

File format/default:

RegionalExtremaProcessing {

computeMode	MODE_AUTO
neighborhood3d	CONNECTIVITY_26
regionalOperator	MAXIMA
inImage	NULL

}

Library references: fastmaxima fastminima

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoRegionalExtremaProcessing.RegionalOperators

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	inImage The input image.
SoSFEnum<SoImageVizEngine.Neighborhood3ds>	neighborhood3d In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outBinaryImage The output binary image.
SoSFEnum<SoRegionalExtremaProcessing.RegionalOperators>	regionalOperator Select the operator.

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 and Description
SoRegionalExtremaProcessing() 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

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

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.

regionalOperator

public final SoSFEnum<SoRegionalExtremaProcessing.RegionalOperators> regionalOperator

Select the operator. . Default is MAXIMA

inImage

public final SoSFImageDataAdapter inImage

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

outBinaryImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outBinaryImage

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

Constructor Detail

SoRegionalExtremaProcessing

public SoRegionalExtremaProcessing()

Constructor.