com.openinventor.imageviz.engines.imagefiltering.smoothinganddenoising

Class SoMedianFilterProcessing

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.imagefiltering.smoothinganddenoising.SoMedianFilterProcessing

All Implemented Interfaces:

SafeDisposable

public class SoMedianFilterProcessing
extends SoImageVizEngine

SoMedianFilterProcessing engine The SoMedianFilterProcessing engine smoothes the image using morphological operators.

For an introduction to image filters, see section Images Filters.

This module uses morphological operators to set the pixel value to the median for the defined neighborhood. The SoMedianFilterProcessing usually works well when images contain non-Gaussian noise and/or very small artifacts. It does not cause blurring to the same extend as the SoBoxFilterProcessing, but does take considerably longer to execute.

The gray levels of all pixels in the neighborhood are sorted from the smallest value to the largest one. The central pixel in the sort is then the median value, i.e. the value for which there are as many lower gray levels as higher ones. The process may be iterated.

To explain this, consider the array:

The sorted gray level values will be: 12 14 14 15 17 18 19 20.
The median value is 16, and it will be the value of the output pixel.

The separable mode performs a Median filtering considering the lines and then the columns.

See also:

SoGaussianFilterProcessing, SoRecursiveExponentialFilterProcessing, SoBoxFilterProcessing.

File format/default:

MedianFilterProcessing {

computeMode	MODE_AUTO
neighborhood3d	CONNECTIVITY_26
kernelType	STANDARD
inImage	NULL
elementSize	3
kernelMode	ITERATIVE

}

Library references: medianfilter medianfilter3d separablemedian separablemedian3d

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoMedianFilterProcessing.KernelModes
static class	SoMedianFilterProcessing.KernelTypes Deprecated.

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
static int	BALL Deprecated. Use SoMedianFilterProcessing.KernelModes.BALL instead.
SoSFEnum<SoImageVizEngine.ComputeModes>	computeMode Select the compute Mode (2D or 3D or AUTO) .
static int	CUBE Deprecated. Use SoMedianFilterProcessing.KernelModes.CUBE instead.
SoSFInt32	elementSize The half size of the structuring element.
SoSFImageDataAdapter	inImage The input grayscale image.
static int	ITERATIVE Deprecated. Use SoMedianFilterProcessing.KernelModes.ITERATIVE instead.
SoSFEnum<SoMedianFilterProcessing.KernelModes>	kernelMode The shape of the 3D neighborhood.
SoSFEnum<SoMedianFilterProcessing.KernelTypes>	kernelType Deprecated. As of Open Inventor 9700 See documentation for more details
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.
static int	SEPARABLE Deprecated. Use SoMedianFilterProcessing.KernelTypes.SEPARABLE instead.
static int	STANDARD Deprecated. Use SoMedianFilterProcessing.KernelTypes.STANDARD instead.

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

SEPARABLE

@Deprecated
public static final int SEPARABLE

Deprecated. Use SoMedianFilterProcessing.KernelTypes.SEPARABLE instead.

STANDARD

@Deprecated
public static final int STANDARD

Deprecated. Use SoMedianFilterProcessing.KernelTypes.STANDARD instead.

ITERATIVE

@Deprecated
public static final int ITERATIVE

Deprecated. Use SoMedianFilterProcessing.KernelModes.ITERATIVE instead.

CUBE

@Deprecated
public static final int CUBE

Deprecated. Use SoMedianFilterProcessing.KernelModes.CUBE instead.

BALL

@Deprecated
public static final int BALL

Deprecated. Use SoMedianFilterProcessing.KernelModes.BALL 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.

kernelType

@Deprecated
public final SoSFEnum<SoMedianFilterProcessing.KernelTypes> kernelType

Deprecated. As of Open Inventor 9700 See documentation for more details

Kernel type for median filter. . Default is STANDARDDeprecated since Open Inventor 9700
Only STANDARD will be supported.

inImage

public final SoSFImageDataAdapter inImage

The input grayscale image. Default value is NULL. Supported types include: grayscale binary label 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.

kernelMode

public final SoSFEnum<SoMedianFilterProcessing.KernelModes> kernelMode

The shape of the 3D neighborhood. . Default is ITERATIVE

outImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outImage

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

Constructor Detail

SoMedianFilterProcessing

public SoMedianFilterProcessing()

Constructor.