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...

const std::string &	getErrorMessage () const
	Return the current error message if there is any. 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...

void	setErrorMessage (const std::string &newErrorMessage)
	Set the current error message. 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 src/terralib/rp/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 src/terralib/rp/Segmenter.h.

Constructor & Destructor Documentation

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

Definition at line 194 of file src/terralib/rp/Segmenter.cpp.

References m_instanceInitialized, and ~Segmenter().

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

default

Referenced by 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.

Definition at line 845 of file src/terralib/rp/Segmenter.cpp.

References te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rp::Segmenter::InputParameters::m_blocksOverlapPercent, m_inputParameters, te::rp::Segmenter::InputParameters::m_inputRasterPtr, and TERP_TRUE_OR_THROW.

Referenced by execute().

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

Definition at line 1570 of file src/terralib/rp/Segmenter.cpp.

References te::rst::Raster::getBand(), te::rst::Raster::getGrid(), te::rst::Band::getProperty(), te::rst::GrayIdxCInt, m_inputParameters, te::rp::Segmenter::InputParameters::m_inputRasterBands, te::rp::Segmenter::InputParameters::m_inputRasterPtr, te::rst::RasterFactory::make(), TERP_TRUE_OR_RETURN_FALSE, TERP_TRUE_OR_THROW, and te::dt::UCHAR_TYPE.

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.

Note: A return error string can be obtained via Algorithm::getErrorMessage()

Implements te::rp::Algorithm.

Definition at line 201 of file src/terralib/rp/Segmenter.cpp.

Referenced by te::qt::widgets::SegmenterWizardPage::apply(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_SUITE(), te::qt::widgets::SegmenterDialog::on_okPushButton_clicked(), te::idl::rp::RegionGrowingSegmenter(), Segmenter(), and SegmentImage().

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.

Definition at line 1082 of file src/terralib/rp/Segmenter.cpp.

References ABS, te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Raster::getValue(), MAX, MIN, and TERP_DEBUG_TRUE_OR_THROW.

Referenced by execute().

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.

Definition at line 1226 of file src/terralib/rp/Segmenter.cpp.

References ABS, te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Raster::getValue(), MAX, MIN, and TERP_DEBUG_TRUE_OR_THROW.

Referenced by execute().

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

inherited

Return the current error message if there is any.

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

Definition at line 44 of file rp/Algorithm.cpp.

References te::rp::Algorithm::m_errorMessage.

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 Algorithm::getErrorMessage()

Implements te::rp::Algorithm.

Definition at line 801 of file src/terralib/rp/Segmenter.cpp.

References te::rst::Raster::getAccessPolicy(), te::rst::Raster::getNumberOfBands(), te::rp::Segmenter::InputParameters::m_blocksOverlapPercent, m_inputParameters, te::rp::Segmenter::InputParameters::m_inputRasterBands, te::rp::Segmenter::InputParameters::m_inputRasterNoDataValues, te::rp::Segmenter::InputParameters::m_inputRasterPtr, m_instanceInitialized, te::common::RAccess, te::rp::Segmenter::InputParameters::reset(), and TERP_INSTANCE_TRUE_OR_RETURN_FALSE.

Referenced by te::qt::widgets::SegmenterWizardPage::apply(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_SUITE(), te::qt::widgets::SegmenterDialog::on_okPushButton_clicked(), te::idl::rp::RegionGrowingSegmenter(), Segmenter(), and SegmentImage().

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.

Definition at line 840 of file src/terralib/rp/Segmenter.cpp.

References m_instanceInitialized.

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

virtual

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

Reimplemented from te::rp::Algorithm.

Definition at line 793 of file src/terralib/rp/Segmenter.cpp.

References m_inputParameters, m_instanceInitialized, te::rp::Algorithm::reset(), and te::rp::Segmenter::InputParameters::reset().

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

staticprotected

Segmenter thread entry.

Parameters

paramsPtr A pointer to the segmenter thread parameters.

Definition at line 893 of file src/terralib/rp/Segmenter.cpp.

Referenced by execute().

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

protectedinherited

Set the current error message.

Parameters

newErrorMessage New error message;

Definition at line 49 of file rp/Algorithm.cpp.

References te::rp::Algorithm::m_errorMessage.

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.