ImageDev

RegionalExtrema2d

Computes the regional extrema in a grayscale 2D image and marks them in a binary image.

Access to parameter description

For an introduction: This algorithm computes the regional or relative extrema in a 2D image and creates a binary image containing these extrema.

Function Syntax

This function returns outputBinaryImage. 
// Function prototype
std::shared_ptr< iolink::ImageView >
regionalExtrema2d( std::shared_ptr< iolink::ImageView > inputImage,
                   RegionalExtrema2d::ExtremaType extremaType,
                   RegionalExtrema2d::Neighborhood neighborhood,
                   std::shared_ptr< iolink::ImageView > outputBinaryImage = NULL );

Class Syntax

Parameters

Parameter Name Description Type Supported Values Default Value
input
inputImage
The input grayscale image. Image Grayscale nullptr
input
extremaType
The type of extrema to detect.
MAXIMA The regional maxima are extracted from the input image.
MINIMA The regional minima are extracted from the input image.
Enumeration MAXIMA
input
neighborhood
The 2D neighborhood configuration.
CONNECTIVITY_4 The structuring element is a cross.
CONNECTIVITY_8 The structuring element is a square.
Enumeration CONNECTIVITY_8
output
outputBinaryImage
The output binary. Its dimensions is forced to the same values as the input. Image nullptr

Object Examples

std::shared_ptr< iolink::ImageView > polystyrene = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "polystyrene.tif" );

RegionalExtrema2d regionalExtrema2dAlgo;
regionalExtrema2dAlgo.setInputImage( polystyrene );
regionalExtrema2dAlgo.setExtremaType( RegionalExtrema2d::ExtremaType::MAXIMA );
regionalExtrema2dAlgo.setNeighborhood( RegionalExtrema2d::Neighborhood::CONNECTIVITY_8 );
regionalExtrema2dAlgo.execute();

std::cout << "outputBinaryImage:" << regionalExtrema2dAlgo.outputBinaryImage()->toString();

Function Examples

std::shared_ptr< iolink::ImageView > polystyrene = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "polystyrene.tif" );

auto result = regionalExtrema2d( polystyrene, RegionalExtrema2d::ExtremaType::MAXIMA, RegionalExtrema2d::Neighborhood::CONNECTIVITY_8 );

std::cout << "outputBinaryImage:" << result->toString();