Raster region growing segmenter strategy. More...

#include <SegmenterRegionGrowingBaatzStrategy.h>

Inheritance diagram for te::rp::SegmenterRegionGrowingBaatzStrategy:

Classes
class	Parameters
	Segmenter Parameters. More...

Public Types
enum	BlocksMergingMethod { NoMerging = 0, GradientMerging = 1 }
	Blocks merging method. More...

Public Member Functions
bool	execute (SegmenterIdsManager &segmenterIdsManager, const te::rp::SegmenterSegmentsBlock &block2ProcessInfo, const te::rst::Raster &inputRaster, const std::vector< unsigned int > &inputRasterBands, const std::vector< std::complex< double > > &inputRasterNoDataValues, const std::vector< std::complex< double > > &inputRasterBandMinValues, const std::vector< std::complex< double > > &inputRasterBandMaxValues, te::rst::Raster &outputRaster, const unsigned int outputRasterBand, const bool enableProgressInterface) throw ( te::rp::Exception )
	Executes the segmentation strategy over region delimited by the given block. More...

BlocksMergingMethod	getBlocksMergingMethod () const
	Return the strategy blocks merging method. More...

const std::string &	getErrorMessage () const
	Return the current error message if there is any. More...

double	getMemUsageEstimation (const unsigned int bandsToProcess, const unsigned int pixelsNumber) const
	Returns a memory estimation (bytes). More...

unsigned int	getOptimalBlocksOverlapSize () const
	Returns a optimal blocks overlap size (number of border pixels overlapped between blocks, under one direction). More...

bool	initialize (SegmenterStrategyParameters const *const strategyParams) throw ( te::rp::Exception )
	Initialize the segmentation strategy. More...

void	reset ()
	Clear all internal allocated resources and go back to the initial not-initialized state. More...

	SegmenterRegionGrowingBaatzStrategy ()

bool	shouldComputeMinMaxValues () const
	Returns if the min and max pixel values should be computed. More...

	~SegmenterRegionGrowingBaatzStrategy ()

Protected Types
typedef Matrix< SegmenterSegmentsBlock::SegmentIdDataType >	SegmentsIdsMatrixT
	Internal segments ids matrix type definition. More...

Protected Member Functions
bool	initializeSegments (SegmenterIdsManager &segmenterIdsManager, const te::rp::SegmenterSegmentsBlock &block2ProcessInfo, const te::rst::Raster &inputRaster, const std::vector< unsigned int > &inputRasterBands, const std::vector< std::complex< double > > &inputRasterNoDataValues, const std::vector< std::complex< double > > &inputRasterBandMinValues, const std::vector< std::complex< double > > &inputRasterBandMaxValues, SegmenterRegionGrowingSegment< rg::BaatzFeatureType > **actSegsListHeadPtr)
	Initialize the segment objects container and the segment IDs container. More...

void	setErrorMessage (const std::string &newErrorMessage)
	Set the current error message. More...

Protected Attributes
bool	m_isInitialized
	true if this instance is initialized. More...

SegmenterRegionGrowingBaatzStrategy::Parameters	m_parameters
	Internal execution parameters. More...

SegmentsIdsMatrixT	m_segmentsIdsMatrix
	A internal segments IDs matrix that can be reused on each strategy execution. More...

SegmenterRegionGrowingSegmentsPool< rg::BaatzFeatureType >	m_segmentsPool
	A pool of segments that can be reused on each strategy execution. More...

Detailed Description

Raster region growing segmenter strategy.

Definition at line 52 of file SegmenterRegionGrowingBaatzStrategy.h.

Member Typedef Documentation

◆ SegmentsIdsMatrixT

typedef Matrix< SegmenterSegmentsBlock::SegmentIdDataType > te::rp::SegmenterRegionGrowingBaatzStrategy::SegmentsIdsMatrixT

protected

Internal segments ids matrix type definition.

Definition at line 131 of file SegmenterRegionGrowingBaatzStrategy.h.

Member Enumeration Documentation

◆ BlocksMergingMethod

enum te::rp::SegmenterStrategy::BlocksMergingMethod

inherited

Blocks merging method.

Enumerator
NoMerging	No merging.
GradientMerging	Gradient Merging.

Definition at line 52 of file SegmenterStrategy.h.

Constructor & Destructor Documentation

◆ ~SegmenterRegionGrowingBaatzStrategy()

te::rp::SegmenterRegionGrowingBaatzStrategy::~SegmenterRegionGrowingBaatzStrategy ( )

◆ SegmenterRegionGrowingBaatzStrategy()

te::rp::SegmenterRegionGrowingBaatzStrategy::SegmenterRegionGrowingBaatzStrategy ( )

Member Function Documentation

◆ execute()

bool te::rp::SegmenterRegionGrowingBaatzStrategy::execute	(	SegmenterIdsManager &	segmenterIdsManager,
		const te::rp::SegmenterSegmentsBlock &	block2ProcessInfo,
		const te::rst::Raster &	inputRaster,
		const std::vector< unsigned int > &	inputRasterBands,
		const std::vector< std::complex< double > > &	inputRasterNoDataValues,
		const std::vector< std::complex< double > > &	inputRasterBandMinValues,
		const std::vector< std::complex< double > > &	inputRasterBandMaxValues,
		te::rst::Raster &	outputRaster,
		const unsigned int	outputRasterBand,
		const bool	enableProgressInterface
	)
throw	(	te::rp::Exception
	)

virtual

Executes the segmentation strategy over region delimited by the given block.

Parameters

segmenterIdsManager	The segments IDs manager to be used when acquiring/releaseing unique segment IDs.
block2ProcessInfo	The information about the block of raster that must be processed.
inputRaster	Input raster.
inputRasterBands	Input raster bands.
inputRasterNoDataValues	A vector of values to be used as input raster no-data values.
inputRasterBandMinValues	The minimum value present on each band.
inputRasterBandMinValues	The maximum value present on each band.
outputRaster	Output raster.
outputRasterBand	Output raster band.
enableProgressInterface	Enable the internal strategy to update the progress interface.

Returns: true if OK, false on errors.

Note: The used gaind/ofset calcule: new_value = ( old_value + offset ) * gain

Implements te::rp::SegmenterStrategy.

◆ getBlocksMergingMethod()

BlocksMergingMethod te::rp::SegmenterRegionGrowingBaatzStrategy::getBlocksMergingMethod ( ) const

virtual

Return the strategy blocks merging method.

Returns: The blocks merging method.

Implements te::rp::SegmenterStrategy.

◆ getErrorMessage()

const std::string& te::rp::SegmenterStrategy::getErrorMessage ( ) const

inherited

Return the current error message if there is any.

Returns: Return the current error message if there is any.

◆ getMemUsageEstimation()

double te::rp::SegmenterRegionGrowingBaatzStrategy::getMemUsageEstimation	(	const unsigned int	bandsToProcess,
		const unsigned int	pixelsNumber
	)		const

virtual

Returns a memory estimation (bytes).

This parameter is used by the segmenter to guess the sub-image blocks size.

Parameters

bandsToProcess	The number of input raster bands that will be processed at the strategy execution time.
pixelsNumber	The number of pixels.

Returns: A positive memory use estimation.

Implements te::rp::SegmenterStrategy.

◆ getOptimalBlocksOverlapSize()

unsigned int te::rp::SegmenterRegionGrowingBaatzStrategy::getOptimalBlocksOverlapSize ( ) const

virtual

Returns a optimal blocks overlap size (number of border pixels overlapped between blocks, under one direction).

Note: This value will be used in the case where the image is splitted into blocks for segmentation.

Returns: The blocks overlap size.

Implements te::rp::SegmenterStrategy.

◆ initialize()

bool te::rp::SegmenterRegionGrowingBaatzStrategy::initialize	(	SegmenterStrategyParameters const *const	strategyParams	)
throw	(	te::rp::Exception
	)

virtual

Initialize the segmentation strategy.

Parameters

strategyParams A pointer to the user given specific segmentation strategy parameters ou NULL if no parameters are present.

Returns: true if OK, false on errors.

Implements te::rp::SegmenterStrategy.

◆ initializeSegments()

bool te::rp::SegmenterRegionGrowingBaatzStrategy::initializeSegments	(	SegmenterIdsManager &	segmenterIdsManager,
		const te::rp::SegmenterSegmentsBlock &	block2ProcessInfo,
		const te::rst::Raster &	inputRaster,
		const std::vector< unsigned int > &	inputRasterBands,
		const std::vector< std::complex< double > > &	inputRasterNoDataValues,
		const std::vector< std::complex< double > > &	inputRasterBandMinValues,
		const std::vector< std::complex< double > > &	inputRasterBandMaxValues,
		SegmenterRegionGrowingSegment< rg::BaatzFeatureType > **	actSegsListHeadPtr
	)

protected

Initialize the segment objects container and the segment IDs container.

Parameters

segmenterIdsManager	A segments ids manager to acquire unique segments ids.
block2ProcessInfo	Info about the block to process.
inputRaster	The input raster.
inputRasterBands	Input raster bands to use.
inputRasterNoDataValues	A vector of values to be used as input raster no-data values.
inputRasterBandMinValues	The minimum value present on each band.
inputRasterBandMinValues	The maximum value present on each band.
actSegsListHeadPtr	A pointer the the active segments list head or a null points if no segments were initialized (entire image with no data, i.e.).

Returns: true if OK, false on errors.

◆ reset()

void te::rp::SegmenterRegionGrowingBaatzStrategy::reset ( )

virtual

Clear all internal allocated resources and go back to the initial not-initialized state.

Reimplemented from te::rp::SegmenterStrategy.

◆ setErrorMessage()

void te::rp::SegmenterStrategy::setErrorMessage ( const std::string & newErrorMessage )

protectedinherited

Set the current error message.

Parameters

newErrorMessage New error message;

◆ shouldComputeMinMaxValues()

bool te::rp::SegmenterRegionGrowingBaatzStrategy::shouldComputeMinMaxValues ( ) const

virtual

Returns if the min and max pixel values should be computed.

Returns: True if min and max values should be computed. False otherwise.

Implements te::rp::SegmenterStrategy.

Member Data Documentation

◆ m_isInitialized

bool te::rp::SegmenterRegionGrowingBaatzStrategy::m_isInitialized

protected

true if this instance is initialized.

Definition at line 136 of file SegmenterRegionGrowingBaatzStrategy.h.

◆ m_parameters

SegmenterRegionGrowingBaatzStrategy::Parameters te::rp::SegmenterRegionGrowingBaatzStrategy::m_parameters

protected

Internal execution parameters.

Definition at line 141 of file SegmenterRegionGrowingBaatzStrategy.h.

◆ m_segmentsIdsMatrix

SegmentsIdsMatrixT te::rp::SegmenterRegionGrowingBaatzStrategy::m_segmentsIdsMatrix

protected

A internal segments IDs matrix that can be reused on each strategy execution.

Definition at line 147 of file SegmenterRegionGrowingBaatzStrategy.h.

◆ m_segmentsPool

SegmenterRegionGrowingSegmentsPool< rg::BaatzFeatureType > te::rp::SegmenterRegionGrowingBaatzStrategy::m_segmentsPool

protected

A pool of segments that can be reused on each strategy execution.

Definition at line 144 of file SegmenterRegionGrowingBaatzStrategy.h.

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

/home/castejon/castejon_files/develop/terralib5/git_release/src/terralib/rp/SegmenterRegionGrowingBaatzStrategy.h

Classes

Public Types

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ SegmentsIdsMatrixT

Member Enumeration Documentation

◆ BlocksMergingMethod

Constructor & Destructor Documentation

◆ ~SegmenterRegionGrowingBaatzStrategy()

◆ SegmenterRegionGrowingBaatzStrategy()

Member Function Documentation

◆ execute()

◆ getBlocksMergingMethod()

◆ getErrorMessage()

◆ getMemUsageEstimation()

◆ getOptimalBlocksOverlapSize()

◆ initialize()

◆ initializeSegments()

◆ reset()

◆ setErrorMessage()

◆ shouldComputeMinMaxValues()

Member Data Documentation

◆ m_isInitialized

◆ m_parameters

◆ m_segmentsIdsMatrix

◆ m_segmentsPool