SoLocalStatisticsProcessing Class Reference
[Texture Filters]

SoLocalStatisticsProcessing engine More...

#include <ImageViz/Engines/ImageFiltering/TextureFilters/SoLocalStatisticsProcessing.h>

Inheritance diagram for SoLocalStatisticsProcessing:

Public Types
enum	StatisticalOperator { MEAN = 0, VARIANCE = 1, SKEWNESS = 2, KURTOSIS = 3, CONTRAST = 4, VARIATION = 5, ENERGY = 6, ENTROPY = 7 }
enum	KernelShape { CUBE = 0, BALL = 1 }
Public Member Functions
	SoLocalStatisticsProcessing ()
Public Attributes
SoSFEnum	computeMode
SoSFEnum	statisticalOperator
SoSFImageDataAdapter	inImage
SoSFInt32	kernelSize
SoSFEnum	kernelShape
SoImageVizEngineOutput < SoSFImageDataAdapter, SoImageDataAdapter * >	outImage

Detailed Description

SoLocalStatisticsProcessing engine

SoLocalStatisticsProcessing image filter computes statistics on a sliding window. The SoLocalStatisticsProcessing filter computes for each voxel of an image the value of a selected statistical operator on a predefined neighborhood. It creates a result image where output pixel values are only function of the corresponding pixel values in the input image and its neighborhood of a given size. These output values are extracted from local histograms which are arrays representing the number of pixels per value in the neighborhood. In the equations of each statistical operator description, $p(n)$ corresponds to the probability to have a pixel with value $n$ (i.e., the number of pixels of value $n$ divided by the total number of pixels in the neighborhood).

Available statistical operators are:

MEAN
VARIANCE
SKEWNESS
KURTOSIS
VARIATION
CONTRAST
ENERGY
ENTROPY

FILE FORMAT/DEFAULT

computeMode	MODE_AUTO
statisticalOperator	MEAN
inImage	NULL
kernelSize	3
kernelShape	BALL

Library references: lcontrast lenergy lentropy lkurtosis lmean lskewness lvariance lvariation lcontrast3d lenergy3d lentropy3d lkurtosis3d lmean3d lskewness3d lvariance3d lvariation3d

Member Enumeration Documentation

enum SoLocalStatisticsProcessing::KernelShape

Enumerator:

CUBE	The shape is a square in 2D mode or a cube in 3D mode.
BALL	The shape is a disk in 2D or a sphere in 3D mode.

enum SoLocalStatisticsProcessing::StatisticalOperator

Enumerator:

MEAN	The MEAN type gives to pixels the mean value in its neighbourhood: $mean=m=\sum_{n}n\cdot p(n)$ .
VARIANCE	The VARIANCE type gives to pixels the variance value in its neighbourhood: $variance=\sigma^2=\sum_{n}(n-m)^2\cdot p(n)$ .
SKEWNESS	The SKEWNESS type gives to pixels the skewness value in its neighbourhood: $skewness=\frac{\sum\limits_{n}(n-m)^3\cdot p(n)}{\sigma^3}$ .
KURTOSIS	The KURTOSIS type gives to pixels the kurtosis value in its neighbourhood: $kurtosis=\frac{\sum\limits_{n}(n-m)^4\cdot p(n)}{\sigma^4}-3$ .
CONTRAST	The CONTRAST type gives to pixels the contrast value in its neighbourhood: $contrast=\frac{max(n)-min(n)}{max(n)+min(n)}$ .
VARIATION	The VARIATION type gives to pixels the variation value in its neighbourhood: $variation=\frac{m}{\sigma}$ .
ENERGY	The ENERGY type gives to pixels the energy value in its neighbourhood in the reduced image: $energy=\sum_{n}p(n)^2$ .
ENTROPY	The ENTROPY type gives to pixels the entropy of its neighbourhood in the reduced image: $entropy=-\sum_{n}p(n)\cdot\log p(n)$ . See also: SoCrossCorrelationProcessing2d

Constructor & Destructor Documentation

SoLocalStatisticsProcessing::SoLocalStatisticsProcessing ( )

Constructor.

Member Data Documentation

SoSFEnum SoLocalStatisticsProcessing::computeMode

Select the compute Mode (2D or 3D or AUTO) Use enum ComputeMode.

Default is MODE_AUTO

SoSFImageDataAdapter SoLocalStatisticsProcessing::inImage

The input image.

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

SoSFEnum SoLocalStatisticsProcessing::kernelShape

Shape of the neighborhood.

Use enum KernelShape. Default is BALL

SoSFInt32 SoLocalStatisticsProcessing::kernelSize

Specifies the size of the kernel.

The value of kernelSize is actually the 'half' kernel size. For example, kernelSize = 1 applies a 3x3(x3) pixel kernel in 2D(3D) when kernelShape is CUBE. Default value is 3.

SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter*> SoLocalStatisticsProcessing::outImage

The output image.

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

SoSFEnum SoLocalStatisticsProcessing::statisticalOperator

Select the first order measure to compute.

Use enum StatisticalOperator. Default is MEAN

The documentation for this class was generated from the following file:

ImageViz/Engines/ImageFiltering/TextureFilters/SoLocalStatisticsProcessing.h

SoLocalStatisticsProcessing Class Reference [Texture Filters]

Public Types