SoLocalAdaptiveThresholdProcessing Class Reference
[Binarization]

SoLocalAdaptiveThresholdProcessing engine More...

#include <ImageViz/Engines/ImageSegmentation/Binarization/SoLocalAdaptiveThresholdProcessing.h>

Inheritance diagram for SoLocalAdaptiveThresholdProcessing:

Public Types
enum	ComparisonCriterion { GREATER_OR_EQUAL = 0, LESS_OR_EQUAL = 1 }
enum	ThresholdMode { MULTIPLICATIVE = 0, ADDITIVE = 1 }
Public Member Functions
	SoLocalAdaptiveThresholdProcessing ()
Public Attributes
SoSFEnum	computeMode
SoSFVec3i32	kernelSize
SoSFImageDataAdapter	inImage
SoSFFloat	threshold
SoSFEnum	comparisonCriterion
SoSFEnum	thresholdMode
SoImageVizEngineOutput < SoSFImageDataAdapter, SoImageDataAdapter * >	outBinaryImage

Detailed Description

SoLocalAdaptiveThresholdProcessing engine

The SoLocalAdaptiveThresholdProcessing engine performs a binarization of a grayscale image based on the mean intensity of a sliding window centered around each voxel.

Each voxel value $V$ is compared to the mean intensity $\bar{I}$ of its local window. The corresponding voxel in the binary output depends on the threshold value, mode, and comparison criterion.

In additive mode with comparison criterion set to GREATER_OR_EQUAL, the output is set to 1 if $V \geq Threshold + \bar{I}$ .

In multiplicative mode with comparison criterion set to GREATER_OR_EQUAL, the output is set to 1 if $V \geq Threshold * \bar{I}$ .

For example to select voxels lower than 90% of their local mean, set threshold field to 0.9, comparisonCriterion field to LESS_OR_EQUAL and thresholdMode field to MULTIPLICATIVE.

FILE FORMAT/DEFAULT

computeMode	MODE_AUTO
kernelSize	30 30 30
inImage	NULL
threshold	1.0f
comparisonCriterion	GREATER_OR_EQUAL
thresholdMode	MULTIPLICATIVE

Library references: local_adaptive_threshold2d local_adaptive_threshold3d

Member Enumeration Documentation

enum SoLocalAdaptiveThresholdProcessing::ComparisonCriterion

Enumerator:

GREATER_OR_EQUAL	All voxels whose value is greater than or equal to the local threshold value, are set to 1 otherwise they are set to 0.
LESS_OR_EQUAL	All voxels whose value is less than or equal to the local threshold value, are set to 1 otherwise they are set to 0.

enum SoLocalAdaptiveThresholdProcessing::ThresholdMode

Enumerator:

MULTIPLICATIVE	The local threshold is equal to $\bar{I}(x) * threshold$ , where value is an input parameter and $\bar{I}(x)$ is the mean of a window centered on x.
ADDITIVE	The local threshold is equal to $\bar{I}(x) + threshold$ , where value is an input parameter and $\bar{I}(x)$ is the mean of a window centered on x.