Loading [MathJax]/jax/output/CommonHTML/jax.js
ImageDev

TextureClassificationApply

Classifies all pixels of an image using a trained texture model.

Access to parameter description

For an introduction: For all the pixels of the input image, the algorithm extracts the texture features selected in the classification model at the training step, and computes the distance to each classes of the model.

The pixel is classified as belonging to the closest class and the corresponding label is assigned to it in the output label image.
The distances are stored in an uncertainty output image in accordance with a metric defined by the outputMapType parameter.

See also

Function Syntax

This function returns a TextureClassificationApplyOutput structure containing outputLabelImage and outputMapImage. 
// Output structure of the textureClassificationApply function.
struct TextureClassificationApplyOutput
{
    /// The output label image representing the texture classification result. Its dimensions and type are forced to the same values as the training input.
    std::shared_ptr< iolink::ImageView > outputLabelImage;
    /// The output map image. Its dimensions are forced to the same values as the training image. In CLASS_DISTANCE mode, its number of channels is equal to the number of classes defined in the training image. Its data type is forced to floating point.
    std::shared_ptr< iolink::ImageView > outputMapImage;
};

// Function prototype
TextureClassificationApplyOutput
textureClassificationApply( std::shared_ptr< iolink::ImageView > inputImage,
                            TextureClassificationModel::Ptr inputModel,
                            TextureClassificationApply::OutputMapType outputMapType,
                            std::shared_ptr< iolink::ImageView > outputLabelImage = NULL,
                            std::shared_ptr< iolink::ImageView > outputMapImage = NULL );

Class Syntax

Parameters

Parameter Name Description Type Supported Values Default Value
input
inputImage
The input grayscale image. Image Grayscale nullptr
input
inputModel
The input texture classification model, previously trained. TextureClassificationModel nullptr
input
outputMapType
The type of uncertainty map image to compute.
CLOSEST_DISTANCE The uncertainty map represents the Mahalanobis distance to the class selected by the classification. The closer to 0 this metric is, the more confident the classification.
RELATIVE_DISTANCE The uncertainty map represents the Mahalanobis distance to the class selected by the classification (d1) weighted by the gap with the second closest distance (d2). The smaller this metric is, the more confident and less ambiguous the classification. MapValue=log(d1d2−d1)
CLASS_DISTANCE The uncertainty map is a multichannel image where each channel represents the distance to the corresponding class.
NONE No uncertainty map is computed.
Enumeration CLOSEST_DISTANCE
output
outputLabelImage
The output label image representing the texture classification result. Its dimensions and type are forced to the same values as the training input. Image nullptr
output
outputMapImage
The output map image. Its dimensions are forced to the same values as the training image. In CLASS_DISTANCE mode, its number of channels is equal to the number of classes defined in the training image. Its data type is forced to floating point. Image nullptr

Object Examples

auto classification_input = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "classification_input.vip" );
TextureClassificationModel::Ptr modelToApply= TextureClassificationModel::read( std::string( IMAGEDEVDATA_OBJECTS_FOLDER ) + "modelToApply.vip" );

TextureClassificationApply textureClassificationApplyAlgo;
textureClassificationApplyAlgo.setInputImage( classification_input );
textureClassificationApplyAlgo.setInputModel( modelToApply );
textureClassificationApplyAlgo.setOutputMapType( TextureClassificationApply::OutputMapType::CLOSEST_DISTANCE );
textureClassificationApplyAlgo.execute();

std::cout << "outputLabelImage:" << textureClassificationApplyAlgo.outputLabelImage()->toString();
std::cout << "outputMapImage:" << textureClassificationApplyAlgo.outputMapImage()->toString();

Function Examples

auto classification_input = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "classification_input.vip" );
TextureClassificationModel::Ptr modelToApply= TextureClassificationModel::read( std::string( IMAGEDEVDATA_OBJECTS_FOLDER ) + "modelToApply.vip" );

auto result = textureClassificationApply( classification_input, modelToApply, TextureClassificationApply::OutputMapType::CLOSEST_DISTANCE );

std::cout << "outputLabelImage:" << result.outputLabelImage->toString();
std::cout << "outputMapImage:" << result.outputMapImage->toString();