com.openinventor.imageviz.engines.edgedetection.edgemarking

Class SoTensorVotingProcessing2d

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.edgedetection.edgemarking.SoTensorVotingProcessing2d

All Implemented Interfaces:

SafeDisposable

public class SoTensorVotingProcessing2d
extends SoImageVizEngine

SoTensorVotingProcessing2d engine. The SoTensorVotingProcessing2d engine strengthens an image local features according to their consistency with a model of smooth curves.

The computation will use a feature score image and an orientation vector image.

The voting field used assumes that the best connection between two points with one orientation imposes a circular arc that decays with the radius according to a Gaussian function. The voting field size is defined by the parameter "scale".

This voting field can be illustrated on the unit sphere: The method is referenced by Franken and van Almsick publication
E.Franken, M.van Almsick, P.Rongen, L.Florack, B.ter Haar Romeny,
"An efficient method for tensor voting using steerable filters."
Computer Vision - ECCV 2006. Springer, pp. 228-240, 2006.

Different outputs can be computed by this filter and are selected with the "outputSelection" parameter. Only the outputs necessary to the application can be selected in order to minimize memory and computation time usage.

This filter can provide an output spectral image where each channel represents a tensor component set in the following order , , .

The saliency, ballness and orientation vector images can be extracted from this tensor image following:

• Orientation:
• Saliency:
• Ballness:

The saliency can be interpreted as a measure for the orientation certainty or a measure of anisotropy of the ellipse in orientation given in outVectorImage.

The ballness can be interpreted as a measure for the orientation uncertainty or a measure of isotropy.

The orientation vector image defines the main orientation of the output tensor.

File format/default:

TensorVotingProcessing2d {

inFeatureImage	NULL
inVectorImage	NULL
scale	5.0
outputSelection	SALIENCY

}

Library references: TensorVoting2D

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoTensorVotingProcessing2d.OutputSelections This enum defines each computable outputs.

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
SoSFImageDataAdapter	inFeatureImage Input feature image.
SoSFImageDataAdapter	inVectorImage Input orientation vector image.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outBallnessImage Output ballness image.
SoSFBitMask<SoTensorVotingProcessing2d.OutputSelections>	outputSelection Enable the computation of selected outputs.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outSaliencyImage Output saliency image.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outTensorImage Output tensor image.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outVectorImage Output orientation vector image.
SoSFDouble	scale This parameter acts on the gap length filled by the tensor voting algorithm.

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

inFeatureImage

public final SoSFImageDataAdapter inFeatureImage

Input feature image. Image must have only one spectral canal. Default value is NULL. Supported types include: grayscale image.

inVectorImage

public final SoSFImageDataAdapter inVectorImage

Input orientation vector image. Image must have the same size as the input and 2 spectral canals. Each vector is used to define an orientation and its norm is ignored. Default value is NULL. Supported types include: color image.

scale

public final SoSFDouble scale

This parameter acts on the gap length filled by the tensor voting algorithm. It is expressed in pixels. Default value is 5.0.

outputSelection

public final SoSFBitMask<SoTensorVotingProcessing2d.OutputSelections> outputSelection

Enable the computation of selected outputs. . Default is SALIENCY

outTensorImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outTensorImage

Output tensor image. The size (except spectral serie), calibration and interpretation of the output image are forced to the same values as the feature input. Type is forced to float. Default value is NULL. Supported types include: color image.

outVectorImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outVectorImage

Output orientation vector image. The size (except spectral serie), calibration and interpretation of the output image are forced to the same values as the feature input. The size of the spectral serie component is forced to 2. Each vector defines the main orientation of the output tensor and its norm is equal to the saliency. Type is forced to float. Default value is NULL. Supported types include: color image.

outSaliencyImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outSaliencyImage

Output saliency image. The size, calibration and interpretation of the output image are forced to the same values as the feature input. Type is forced to float. Default value is NULL. Supported types include: grayscale image.

outBallnessImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outBallnessImage

Output ballness image. The size, calibration and interpretation of the output image are forced to the same values as the feature input. Type is forced to float. Default value is NULL. Supported types include: grayscale image.

Constructor Detail

SoTensorVotingProcessing2d

public SoTensorVotingProcessing2d()

Constructor.