Raster segmentation. More...

#include <Segmenter.h>

Inheritance diagram for te::rp::Segmenter:

Classes
class	InputParameters
	Segmenter Input Parameters. More...

class	OutputParameters
	Segmenter Output Parameters. More...

class	SegmenterThreadEntryParams
	The parameters passed to the Segmenter::segmenterthreadEntry method. More...

Public Member Functions
bool	execute (AlgorithmOutputParameters &outputParams) throw ( te::rp::Exception )
	Executes the algorithm using the supplied parameters. More...

bool	initialize (const AlgorithmInputParameters &inputParams) throw ( te::rp::Exception )
	Initialize the algorithm instance making it ready for execution. More...

bool	isInitialized () const
	Returns true if the algorithm instance is initialized and ready for execution. More...

void	reset () throw ( te::rp::Exception )
	Clear all internal allocated objects and reset the algorithm to its initial state. More...

	Segmenter ()

	~Segmenter ()

Protected Types
typedef te::rp::Matrix< SegmenterSegmentsBlock >	SegmentsBlocksMatrixT

Protected Member Functions
bool	calcBestBlockSize (const unsigned int minExapandedBlockPixels, const unsigned int maxExapandedBlockPixels, unsigned int &blocksHOverlapSize, unsigned int &blocksVOverlapSize, unsigned int &nonExpandedBlockWidth, unsigned int &nonExpandedBlockHeight, unsigned int &expandedBlockWidth, unsigned int &expandedBlockHeight) const
	Calc the best sub-image block size for each thread to process. More...

bool	createCutOffLinesTiff (const std::vector< std::vector< unsigned int > > &imageHorizontalProfiles, const std::vector< unsigned int > &imageHorizontalProfilesCenterLines, const std::vector< std::vector< unsigned int > > &imageVerticalProfiles, const std::vector< unsigned int > &imageVerticalProfilesCenterLines, const std::string &filename)

bool	genImageHCutOffProfile (const unsigned int profileCenter, const te::rst::Raster &inRaster, const std::vector< unsigned int > &inRasterBands, const unsigned int pixelNeighborhoodSize, const unsigned int tileNeighborhoodSize, const unsigned int profileAntiSmoothingFactor, std::vector< unsigned int > &profile) const
	Generate the horizontal cutOff prifles for the entire image.. More...

bool	genImageVCutOffProfile (const unsigned int profileCenter, const te::rst::Raster &inRaster, const std::vector< unsigned int > &inRasterBands, const unsigned int pixelNeighborhoodSize, const unsigned int tileNeighborhoodSize, const unsigned int profileAntiSmoothingFactor, std::vector< unsigned int > &profile) const
	Generate the vertical cutOff prifles for the entire image.. More...

bool	updateBlockCutOffProfiles (const std::vector< std::vector< unsigned int > > &imageHorizontalProfiles, const std::vector< std::vector< unsigned int > > &imageVerticalProfiles, SegmenterSegmentsBlock &segmentsBlock) const
	Update the block cutOff profiles using the full image profiles. More...

Static Protected Member Functions
static void	segmenterThreadEntry (SegmenterThreadEntryParams *paramsPtr)
	Segmenter thread entry. More...

Protected Attributes
Segmenter::InputParameters	m_inputParameters
	Segmenter execution parameters. More...

bool	m_instanceInitialized

Detailed Description

Raster segmentation.

Raster segmentation following the choosed segmentation strategy.

Note: The created label image will be written to the raster instance pointed by m_outRasterPtr (in this case the output band must also be passed by m_outRasterBand ); or written to a new raster instance created inside the given data source pointed by m_outDataSourcePtr (in this case the data set name must be supplied - m_outDataSetName ).

See also: te::rp::Segmenter::Parameters For detailed parameters description.; te::rp::SegmenterStrategy For detailed parameters description.

Definition at line 73 of file Segmenter.h.

Member Typedef Documentation

typedef te::rp::Matrix< SegmenterSegmentsBlock > te::rp::Segmenter::SegmentsBlocksMatrixT

protected

Segments blocks matrix type definition

Definition at line 194 of file Segmenter.h.

Constructor & Destructor Documentation

te::rp::Segmenter::Segmenter ( )

te::rp::Segmenter::~Segmenter ( )

Member Function Documentation

bool te::rp::Segmenter::calcBestBlockSize	(	const unsigned int	minExapandedBlockPixels,
		const unsigned int	maxExapandedBlockPixels,
		unsigned int &	blocksHOverlapSize,
		unsigned int &	blocksVOverlapSize,
		unsigned int &	nonExpandedBlockWidth,
		unsigned int &	nonExpandedBlockHeight,
		unsigned int &	expandedBlockWidth,
		unsigned int &	expandedBlockHeight
	)		const

protected

Calc the best sub-image block size for each thread to process.

Parameters

minBlockPixels	The minimun allowed pixels number for each block (expanded block).
maxBlockPixels	The maximum allowed pixels number for each block (expanded block).
blocksHOverlapSize	The blocks horizontal overlap size (number of columns).
blocksVOverlapSize	The blocks vertical overlap size (number of rows).
nonExpandedBlockWidth	The calculated non-expanded block width (non-expanded block).
nonExpandedBlockHeight	The calculated non-expanded block height (non-expanded block).
expandedBlockWidth	The calculated expanded block width (non-expanded block).
expandedBlockHeight	The calculated expanded block height (non-expanded block).

Returns: true if OK, false on errors.

bool te::rp::Segmenter::createCutOffLinesTiff	(	const std::vector< std::vector< unsigned int > > &	imageHorizontalProfiles,
		const std::vector< unsigned int > &	imageHorizontalProfilesCenterLines,
		const std::vector< std::vector< unsigned int > > &	imageVerticalProfiles,
		const std::vector< unsigned int > &	imageVerticalProfilesCenterLines,
		const std::string &	filename
	)

protected

bool te::rp::Segmenter::execute	(	AlgorithmOutputParameters &	outputParams	)
throw	(	te::rp::Exception
	)

virtual

Executes the algorithm using the supplied parameters.

Parameters

outputParams Output parameters.

Returns: true if OK, false on errors.

Implements te::rp::Algorithm.

bool te::rp::Segmenter::genImageHCutOffProfile	(	const unsigned int	profileCenter,
		const te::rst::Raster &	inRaster,
		const std::vector< unsigned int > &	inRasterBands,
		const unsigned int	pixelNeighborhoodSize,
		const unsigned int	tileNeighborhoodSize,
		const unsigned int	profileAntiSmoothingFactor,
		std::vector< unsigned int > &	profile
	)		const

protected

Generate the horizontal cutOff prifles for the entire image..

Parameters

profileCenter	The profile center line.
inRaster	The input raster.
inRasterBands	The input raster bands.
pixelNeighborhoodSize	The pixel neighborhood size over the line transverse to each tile line.
tileNeighborhoodSize	The buffer size around each tile.
profileAntiSmoothingFactor	A positive profile anti-smoothing factor.
profile	The generated profile (each element is a inRaster line index ).

Returns: true if OK, false on errors.

bool te::rp::Segmenter::genImageVCutOffProfile	(	const unsigned int	profileCenter,
		const te::rst::Raster &	inRaster,
		const std::vector< unsigned int > &	inRasterBands,
		const unsigned int	pixelNeighborhoodSize,
		const unsigned int	tileNeighborhoodSize,
		const unsigned int	profileAntiSmoothingFactor,
		std::vector< unsigned int > &	profile
	)		const

protected

Generate the vertical cutOff prifles for the entire image..

Parameters

profileCenter	The profile center column.
inRaster	The input raster.
inRasterBands	The input raster bands.
pixelNeighborhoodSize	The pixel neighborhood size over the line transverse to each tile line.
tileNeighborhoodSize	The buffer size around each tile.
profileAntiSmoothingFactor	A positive profile anti-smoothing factor.
profile	The generated profile (each element is a inRaster column index )

Returns: true if OK, false on errors.

bool te::rp::Segmenter::initialize	(	const AlgorithmInputParameters &	inputParams	)
throw	(	te::rp::Exception
	)

virtual

Initialize the algorithm instance making it ready for execution.

Parameters

inputParams Input parameters.

Returns: true if OK, false on errors.

Note: A return error string can be obtained via te::rp::Module::getLastLogStr()

Implements te::rp::Algorithm.

bool te::rp::Segmenter::isInitialized ( ) const

virtual

Returns true if the algorithm instance is initialized and ready for execution.

Returns: true if the algorithm instance is initialized and ready for execution.

Implements te::rp::Algorithm.

void te::rp::Segmenter::reset	(		)
throw	(	te::rp::Exception
	)

virtual

Clear all internal allocated objects and reset the algorithm to its initial state.

Implements te::rp::Algorithm.

static void te::rp::Segmenter::segmenterThreadEntry ( SegmenterThreadEntryParams * paramsPtr )

staticprotected

Segmenter thread entry.

Parameters

paramsPtr A pointer to the segmenter thread parameters.

bool te::rp::Segmenter::updateBlockCutOffProfiles	(	const std::vector< std::vector< unsigned int > > &	imageHorizontalProfiles,
		const std::vector< std::vector< unsigned int > > &	imageVerticalProfiles,
		SegmenterSegmentsBlock &	segmentsBlock
	)		const

protected

Update the block cutOff profiles using the full image profiles.

Parameters

imageVerticalProfiles	The generated horizontal profiles (empty profiles also will be accepted).
horizontalProfiles	The generated vertical profiles (empty profiles also will be accepted).
segmentsBlock	The block to update.

Returns: true if OK, false on errors.

Member Data Documentation

Segmenter::InputParameters te::rp::Segmenter::m_inputParameters

protected

Segmenter execution parameters.

Definition at line 257 of file Segmenter.h.

bool te::rp::Segmenter::m_instanceInitialized

protected

Definition at line 255 of file Segmenter.h.

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

/home/castejon/castejon_files/develop/terralib5/git_master/terralib5/src/terralib/rp/Segmenter.h

Classes

Public Member Functions

Protected Types

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation