com.openinventor.imageviz.engines.imagesegmentation.classification

Class SoSupervisedTextureClassificationProcessing3d

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.imagesegmentation.classification.SoSupervisedTextureClassificationProcessing3d

All Implemented Interfaces:

SafeDisposable

public class SoSupervisedTextureClassificationProcessing3d
extends SoImageVizEngine

SoSupervisedTextureClassificationProcessing3d engine. The SoSupervisedTextureClassificationProcessing3d engine realizes a segmentation based on a texture model automatically built from a training input image.

It chains automatically the 3 steps of the texture classification workflow: model creation, texture model learning and model application.

For an introduction see the Texture classification section

File format/default:

SupervisedTextureClassificationProcessing3d {

inImage	NULL
inTrainingImage	NULL
featureGroup	FIRST_ORDER_STATISTICS | HISTOGRAM_STATISTICS | INTENSITY
radiusRange	2 8
radiusStep	6
coocRadius	6
coocTextonShape	SPHERE
coocTextonSize	2
minSeparationPercentage	3.0
outMapType	CLOSEST_DISTANCE

}

Library references: SupervisedTextureClassification3D

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoSupervisedTextureClassificationProcessing3d.CoocTextonShapes This enum defines all type of measures used for texture classification.
static class	SoSupervisedTextureClassificationProcessing3d.FeatureGroups This enum defines all type of measures used for texture classification.
static class	SoSupervisedTextureClassificationProcessing3d.OutMapTypes

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
SoSFUInt32	coocRadius Radius of the circular neighborhood used by the cooccurrence features.
SoSFEnum<SoSupervisedTextureClassificationProcessing3d.CoocTextonShapes>	coocTextonShape The shape of the co-occurrence texton, i.e., the pattern defined by the set of co-occurrence vectors.
SoSFUInt32	coocTextonSize The size of the texton shape for co-occurrence features.
SoSFBitMask<SoSupervisedTextureClassificationProcessing3d.FeatureGroups>	featureGroup The groups of textural features to compute.
SoSFImageDataAdapter	inImage The input grayscale image to segment.
SoSFImageDataAdapter	inTrainingImage The input label training image (16 or 32 bits).
SoSFDouble	minSeparationPercentage This parameter controls the rejection criteria of the feature selection algorithm (FS).
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outLabelImage The output label image representing the texture classification result.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter>	outMapImage Output map image.
SoSFEnum<SoSupervisedTextureClassificationProcessing3d.OutMapTypes>	outMapType The Output map image type.
SoSFVec2i32	radiusRange The minimum and maximum radius of the circular neighborhoods used for computing textural features.
SoSFUInt32	radiusStep The step used to define the set of radius between minimum and maximum.

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

inImage

public final SoSFImageDataAdapter inImage

The input grayscale image to segment. Default value is NULL. Supported types include: grayscale image.

inTrainingImage

public final SoSFImageDataAdapter inTrainingImage

The input label training image (16 or 32 bits). Each label represents a class sample for the learning step. Default value is NULL. Supported types include: label image.

featureGroup

public final SoSFBitMask<SoSupervisedTextureClassificationProcessing3d.FeatureGroups> featureGroup

The groups of textural features to compute. . Default is FIRST_ORDER_STATISTICS | HISTOGRAM_STATISTICS | INTENSITY

radiusRange

public final SoSFVec2i32 radiusRange

The minimum and maximum radius of the circular neighborhoods used for computing textural features. Default value is SbVec2i32(2,8).

radiusStep

public final SoSFUInt32 radiusStep

The step used to define the set of radius between minimum and maximum. The maximum radius is systematically added to the radius list. Default value is 6.

coocRadius

public final SoSFUInt32 coocRadius

Radius of the circular neighborhood used by the cooccurrence features. Default value is 6.

coocTextonShape

public final SoSFEnum<SoSupervisedTextureClassificationProcessing3d.CoocTextonShapes> coocTextonShape

The shape of the co-occurrence texton, i.e., the pattern defined by the set of co-occurrence vectors. This shape represents the distribution of points around the target point for computing the co-occurrence matrix. The shape, associated to the texton size, defines the set of vectors that are used for computing co-occurrence features. For instance, in 2D, a Cube shape of size 3 defines the co-occurrence vectors (-3, -3) , (0, -3), (3, -3), (-3, 0) , (3, 0), (-3, 3) , (0, 3) and (3, 3). This parameter is ignored if none of the co-occurrence measure types is selected. . Default is SPHERE

coocTextonSize

public final SoSFUInt32 coocTextonSize

The size of the texton shape for co-occurrence features. This size is constrained by the radius parameter. The constraint depends on the texton shape. For instance, with a square texton, the texton size cannot exceed the rounded value of . This parameter is ignored if none of the co-occurrence measure types is selected. Default value is 2.

minSeparationPercentage

public final SoSFDouble minSeparationPercentage

This parameter controls the rejection criteria of the feature selection algorithm (FS). A measure is rejected if its contribution does not increase enough the separation power of the classification model. This ratio indicates the minimal relative growth required to keep a measure. Please refer to Feature Selection section for more information about this parameter. The value must be greater than or equal to 0.0. Default value is 3.0.

outLabelImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outLabelImage

The output label image representing the texture classification result. Default value is NULL. Supported types include: label image.

outMapType

public final SoSFEnum<SoSupervisedTextureClassificationProcessing3d.OutMapTypes> outMapType

The Output map image type. Default is CLOSEST_DISTANCE. . Default is CLOSEST_DISTANCE

outMapImage

public final SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter> outMapImage

Output map image. The type of the image will be float. Default value is NULL. Supported types include: grayscale binary label color image.

Constructor Detail

SoSupervisedTextureClassificationProcessing3d

public SoSupervisedTextureClassificationProcessing3d()

Constructor.