com.openinventor.imageviz.engines.geometryandmatching.patternrecognition

Class SoGrayscaleCorrelationProcessing2d

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.geometryandmatching.patternrecognition.SoGrayscaleCorrelationProcessing2d

All Implemented Interfaces:

SafeDisposable

public class SoGrayscaleCorrelationProcessing2d
extends SoImageVizEngine

SoGrayscaleCorrelationProcessing2d engine The SoGrayscaleCorrelationProcessing2d image filter performs a correlation between a grey level image I and a grey level kernel K returning the correlation image O.

See Correlation for generalities.

Notations:

The different possibilities are presented below using a 1-D correlation between an image and kernel. In the image, the kernel appears 6 times with different contrast and luminosity. The 6 examples show the kernel appearing with different contrast and luminosity. Multiply correlation

The correlation is performed depending on SoGrayscaleCorrelationProcessing2d.CorrelationMode.

For DIRECT

In this mode, we have detected 3 of the 6 patterns matching the kernel. Only high luminosity patterns have been detected. The best matching is obtained for the high contrast and luminosity pattern. For MEAN

In this mode, we have detected 2 of the 6 patterns matching the kernel. Only high contrast patterns have been detected. The confidence rate is the same for the two 2 patterns. For VARIANCE

In this mode, we have detected the 2 patterns matching the kernel with the same confidence rate. For MEAN_VARIANCE

In this mode, we have detected the 6 patterns matching the kernel with the same confidence rate. Difference correlation

The correlation is performed depending on SoGrayscaleCorrelationProcessing2d.CorrelationMode.

For DIRECT

In this mode, we have detected 3 of the 6 patterns matching the kernel. Only similar luminosity patterns have been detected. The best matching is obtained with the similar contrast and luminosity pattern. For MEAN

In this mode, we have detected 2 of the 6 patterns matching the kernel. Only similar contrast patterns have been detected. The confidence rate is the same for the 2 patterns. For VARIANCE

In this mode, we have detected 3 of the 6 patterns matching the kernel. Only similar luminosity patterns have been detected. The confidence rate is the same for the 3 patterns. For MEAN_VARIANCE

In this mode, we have detected the 6 patterns matching the kernel with the same confidence rate. Sign Change correlation

The correlation is performed depending on SoGrayscaleCorrelationProcessing2d.CorrelationMode.

is the sign change criterion performed on the difference image. It corresponds to the number of sign changes calculated on every line. The object in the model and the object in the image have luminosity, contrast and noise differences. After normalization depending on the correlation type, the sign change criterion is applied on the difference image. The noise is supposed to be additive and zero mean. The statistical density function of the noise is supposed to be symmetrical. The best matching will correspond to the maximum number of sign changes.

This correlation gives very good results with big kernels. It was created for medical applications where images are often very noisy.

For DIRECT

For MEAN

For VARIANCE

For MEAN_VARIANCE

File format/default:

GrayscaleCorrelationProcessing2d {

correlationCriterion	MULTIPLY
inGrayImage	NULL
inKernelImage	NULL
offsetMode	OFFSET_1
correlationMode	DIRECT

}

Library references: dcorrel mcorrel scorrel

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoGrayscaleCorrelationProcessing2d.CorrelationCriterions See Correlation.
static class	SoGrayscaleCorrelationProcessing2d.CorrelationModes See Correlation and for each SoGrayscaleCorrelationProcessing2d.CorrelationCriterion.
static class	SoGrayscaleCorrelationProcessing2d.OffsetModes This field is ignored in the multiply correlation mode.
static class	SoGrayscaleCorrelationProcessing2d.SbCorrelationDetail Results details of image correlation.

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<SoGrayscaleCorrelationProcessing2d.CorrelationCriterions>	correlationCriterion Select the correlation operator.
SoSFEnum<SoGrayscaleCorrelationProcessing2d.CorrelationModes>	correlationMode Select the normalization mode for correlation.
static int	DIRECT Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationModes.DIRECT instead.
SoSFImageDataAdapter	inGrayImage The input grayscale image.
SoSFImageDataAdapter	inKernelImage The correlation kernel.
static int	MEAN Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationModes.MEAN instead.
static int	MEAN_VARIANCE Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationModes.MEAN_VARIANCE instead.
static int	MULTIPLY Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationCriterions.MULTIPLY instead.
static int	OFFSET_1 Deprecated. Use SoGrayscaleCorrelationProcessing2d.OffsetModes.OFFSET_1 instead.
static int	OFFSET_2 Deprecated. Use SoGrayscaleCorrelationProcessing2d.OffsetModes.OFFSET_2 instead.
static int	OFFSET_4 Deprecated. Use SoGrayscaleCorrelationProcessing2d.OffsetModes.OFFSET_4 instead.
static int	OFFSET_8 Deprecated. Use SoGrayscaleCorrelationProcessing2d.OffsetModes.OFFSET_8 instead.
SoSFEnum<SoGrayscaleCorrelationProcessing2d.OffsetModes>	offsetMode Select the calculation offset (number of pixels).
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outMatchingImage The output correlation image.
SoImageVizEngineAnalysisOutput<SoGrayscaleCorrelationProcessing2d.SbCorrelationDetail>	outResult The correlation matching results.
static int	SIGNCHANGE Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationCriterions.SIGNCHANGE instead.
static int	SUBSTRACT Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationCriterions.SUBSTRACT instead.
static int	VARIANCE Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationModes.VARIANCE 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
SoGrayscaleCorrelationProcessing2d() 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

SIGNCHANGE

@Deprecated
public static final int SIGNCHANGE

Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationCriterions.SIGNCHANGE instead.

SUBSTRACT

@Deprecated
public static final int SUBSTRACT

Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationCriterions.SUBSTRACT instead.

MULTIPLY

@Deprecated
public static final int MULTIPLY

Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationCriterions.MULTIPLY instead.

OFFSET_1

@Deprecated
public static final int OFFSET_1

Deprecated. Use SoGrayscaleCorrelationProcessing2d.OffsetModes.OFFSET_1 instead.

OFFSET_2

@Deprecated
public static final int OFFSET_2

Deprecated. Use SoGrayscaleCorrelationProcessing2d.OffsetModes.OFFSET_2 instead.

OFFSET_4

@Deprecated
public static final int OFFSET_4

Deprecated. Use SoGrayscaleCorrelationProcessing2d.OffsetModes.OFFSET_4 instead.

OFFSET_8

@Deprecated
public static final int OFFSET_8

Deprecated. Use SoGrayscaleCorrelationProcessing2d.OffsetModes.OFFSET_8 instead.

DIRECT

@Deprecated
public static final int DIRECT

Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationModes.DIRECT instead.

MEAN

@Deprecated
public static final int MEAN

Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationModes.MEAN instead.

VARIANCE

@Deprecated
public static final int VARIANCE

Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationModes.VARIANCE instead.

MEAN_VARIANCE

@Deprecated
public static final int MEAN_VARIANCE

Deprecated. Use SoGrayscaleCorrelationProcessing2d.CorrelationModes.MEAN_VARIANCE instead.

correlationCriterion

public final SoSFEnum<SoGrayscaleCorrelationProcessing2d.CorrelationCriterions> correlationCriterion

Select the correlation operator. . Default is MULTIPLY

inGrayImage

public final SoSFImageDataAdapter inGrayImage

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

inKernelImage

public final SoSFImageDataAdapter inKernelImage

The correlation kernel. Default value is NULL. Supported types include: grayscale binary label image.

offsetMode

public final SoSFEnum<SoGrayscaleCorrelationProcessing2d.OffsetModes> offsetMode

Select the calculation offset (number of pixels). . Default is OFFSET_1

correlationMode

public final SoSFEnum<SoGrayscaleCorrelationProcessing2d.CorrelationModes> correlationMode

Select the normalization mode for correlation. . Default is DIRECT

outMatchingImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outMatchingImage

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

outResult

public final SoImageVizEngineAnalysisOutput<SoGrayscaleCorrelationProcessing2d.SbCorrelationDetail> outResult

The correlation matching results. Default value is NULL.

Constructor Detail

SoGrayscaleCorrelationProcessing2d

public SoGrayscaleCorrelationProcessing2d()

Constructor.