#include <Contrast.h>

Inheritance diagram for te::rp::Contrast:

Classes
class	InputParameters
	Contrast input parameters. More...

class	OutputParameters
	Contrast output parameters. More...

Public Member Functions
	Contrast ()

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

	~Contrast ()

Static Public Member Functions
static bool	getGainAndOffset (const InputParameters::ContrastType &type, const double &inRangeMin, const double &inRangeMax, const double &outRangeMin, const double &outRangeMax, double &gain, double &offset1, double &offset2)
	Returns gain and offset values for contrast types (when applicable). More...

Protected Types
typedef void(Contrast::*	RemapFuncPtrT) (const double &inValue, double &outValue)
	Type definition for a remapping function pointer. More...

Protected Member Functions
void	DecorrelationEnhancementRemap (const double &inValue, double &outValue)
	Remap on gray level using two offsets and gain. More...

bool	execDecorrelationEnhancement ()
	Execute the decorrelation enhancement contrast following the internal parameters. More...

bool	execHistogramEqualizationContrast ()
	Execute the histogram equalization contrast following the internal parameters. More...

bool	execLinearContrast ()
	Execute a linear contrast following the internal parameters. More...

bool	execLogContrast ()
	Execute a log contrast following the internal parameters. More...

bool	execSetMeanAndStdContrast ()
	Execute the histogram equalization contrast following the internal parameters. More...

bool	execSquareContrast ()
	Execute a square contrast following the internal parameters. More...

bool	execSquareRootContrast ()
	Execute a square root contrast following the internal parameters. More...

void	histogramEqualizationRemap (const double &inValue, double &outValue)
	Remap on gray level using two offsets and gain. More...

void	logRemap (const double &inValue, double &outValue)
	Remap on gray level using a log. More...

void	offSetGainRemap (const double &inValue, double &outValue)
	Remap on gray level using an offset and gain. More...

bool	remapBandLevels (const te::rst::Band &inRasterBand, te::rst::Band &outRasterBand, RemapFuncPtrT remapFuncPtr, const bool enableProgress)
	Band gray levels remap using a remap function. More...

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

void	squareRemap (const double &inValue, double &outValue)
	Remap on gray level using a square. More...

void	squareRootRemap (const double &inValue, double &outValue)
	Remap on gray level using a square root. More...

Protected Attributes
double	m_decorrelationEnhancementRemap_gain

double	m_decorrelationEnhancementRemap_offset1

double	m_decorrelationEnhancementRemap_offset2

std::map< double, double >	m_histogramEqualizationRemap_cdf

double	m_histogramEqualizationRemap_cDFMin

double	m_histogramEqualizationRemap_gain

Contrast::InputParameters	m_inputParameters
	Contrast input execution parameters. More...

bool	m_isInitialized
	Tells if this instance is initialized. More...

double	m_logRemap_gain

double	m_logRemap_offset

double	m_offSetGainRemap_gain

double	m_offSetGainRemap_offset1

double	m_offSetGainRemap_offset2

Contrast::OutputParameters *	m_outputParametersPtr
	Contrast input execution parameters. More...

double	m_squareRemap_gain

double	m_squareRootRemap_gain

Detailed Description

Contrast enhancement.

Apply contrast enhencement on the selected bands.

Definition at line 57 of file Contrast.h.

Member Typedef Documentation

typedef void(Contrast::* te::rp::Contrast::RemapFuncPtrT) (const double &inValue, double &outValue)

protected

Type definition for a remapping function pointer.

Definition at line 254 of file Contrast.h.

Constructor & Destructor Documentation

te::rp::Contrast::Contrast ( )

Definition at line 172 of file src/terralib/rp/Contrast.cpp.

References te::rp::Contrast::InputParameters::reset(), and ~Contrast().

te::rp::Contrast::~Contrast ( )

default

Referenced by Contrast().

Member Function Documentation

void te::rp::Contrast::DecorrelationEnhancementRemap	(	const double &	inValue,
		double &	outValue
	)

inlineprotected

Remap on gray level using two offsets and gain.

Parameters

inValue	Input gray level.
outValue	Output gray level.

Definition at line 391 of file Contrast.h.

Referenced by execDecorrelationEnhancement().

bool te::rp::Contrast::execDecorrelationEnhancement ( )

protected

Execute the decorrelation enhancement contrast following the internal parameters.

Returns: true if OK, false on errors.

Definition at line 931 of file src/terralib/rp/Contrast.cpp.

References DecorrelationEnhancementRemap(), te::rp::DirectPrincipalComponents(), te::dt::DOUBLE_TYPE, te::rst::Raster::getBand(), te::rst::Raster::getGrid(), te::rp::GetMeanValue(), te::rst::Band::getProperty(), te::rp::GetStdDevValue(), te::sa::Grid, te::rp::InversePrincipalComponents(), m_decorrelationEnhancementRemap_gain, m_decorrelationEnhancementRemap_offset1, m_decorrelationEnhancementRemap_offset2, te::rp::Contrast::InputParameters::m_enableProgress, m_inputParameters, te::rp::Contrast::InputParameters::m_inRasterBands, te::rp::Contrast::InputParameters::m_inRasterPtr, m_outputParametersPtr, te::rp::Contrast::OutputParameters::m_outRasterBands, te::rp::Contrast::OutputParameters::m_outRasterPtr, remapBandLevels(), TERP_LOG_AND_RETURN_FALSE, TERP_TRUE_OR_RETURN_FALSE, and te::common::Exception::what().

Referenced by execute().

bool te::rp::Contrast::execHistogramEqualizationContrast ( )

protected

Execute the histogram equalization contrast following the internal parameters.

Returns: true if OK, false on errors.

Definition at line 571 of file src/terralib/rp/Contrast.cpp.

References b, te::dt::DOUBLE_TYPE, te::dt::FLOAT_TYPE, te::rst::Raster::getBand(), te::rp::GetDataTypeRange(), te::common::Singleton< RasterSummaryManager >::getInstance(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rst::BandProperty::getType(), histogramEqualizationRemap(), te::rp::Contrast::InputParameters::m_enableProgress, te::rp::Contrast::InputParameters::m_hECMaxInput, m_histogramEqualizationRemap_cdf, m_histogramEqualizationRemap_cDFMin, m_histogramEqualizationRemap_gain, m_inputParameters, te::rp::Contrast::InputParameters::m_inRasterBands, te::rp::Contrast::InputParameters::m_inRasterPtr, m_outputParametersPtr, te::rp::Contrast::InputParameters::m_outRangeMax, te::rp::Contrast::InputParameters::m_outRangeMin, te::rp::Contrast::OutputParameters::m_outRasterBands, te::rp::Contrast::OutputParameters::m_outRasterPtr, remapBandLevels(), and te::rst::SUMMARY_R_HISTOGRAM.

Referenced by execute().

bool te::rp::Contrast::execLinearContrast ( )

protected

Execute a linear contrast following the internal parameters.

Returns: true if OK, false on errors.

Definition at line 510 of file src/terralib/rp/Contrast.cpp.

Referenced by execute().

bool te::rp::Contrast::execLogContrast ( )

protected

Execute a log contrast following the internal parameters.

Returns: true if OK, false on errors.

Definition at line 800 of file src/terralib/rp/Contrast.cpp.

Referenced by execute().

bool te::rp::Contrast::execSetMeanAndStdContrast ( )

protected

Execute the histogram equalization contrast following the internal parameters.

Returns: true if OK, false on errors.

Definition at line 860 of file src/terralib/rp/Contrast.cpp.

References b, te::rst::ConstBandIterator< T >::begin(), te::rst::ConstBandIterator< T >::end(), te::rst::Raster::getBand(), te::rp::GetDataTypeRange(), te::common::Singleton< RasterSummaryManager >::getInstance(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rst::Band::getRaster(), te::rst::BandProperty::getType(), te::rst::Band::getValue(), te::rp::Contrast::InputParameters::m_enableProgress, m_inputParameters, te::rp::Contrast::InputParameters::m_inRasterBands, te::rp::Contrast::InputParameters::m_inRasterPtr, m_outputParametersPtr, te::rp::Contrast::InputParameters::m_outRangeMax, te::rp::Contrast::InputParameters::m_outRangeMin, te::rp::Contrast::OutputParameters::m_outRasterBands, te::rp::Contrast::OutputParameters::m_outRasterPtr, te::rp::Contrast::InputParameters::m_sMASCMeanInput, te::rp::Contrast::InputParameters::m_sMASCStdInput, te::rst::Band::setValue(), te::rst::SUMMARY_MEAN, and te::rst::SUMMARY_STD.

Referenced by execute().

bool te::rp::Contrast::execSquareContrast ( )

protected

Execute a square contrast following the internal parameters.

Returns: true if OK, false on errors.

Definition at line 680 of file src/terralib/rp/Contrast.cpp.

Referenced by execute().

bool te::rp::Contrast::execSquareRootContrast ( )

protected

Execute a square root contrast following the internal parameters.

Returns: true if OK, false on errors.

Definition at line 740 of file src/terralib/rp/Contrast.cpp.

Referenced by execute().

bool te::rp::Contrast::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 179 of file src/terralib/rp/Contrast.cpp.

Referenced by te::qt::widgets::ContrastDialogForm::applyPreview(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_SUITE(), Contrast(), te::qt::widgets::ContrastDialogForm::execute(), te::qt::widgets::ContrastDialog::on_okPushButton_clicked(), and te::rp::RasterSlicing().

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::Contrast::getGainAndOffset	(	const InputParameters::ContrastType &	type,
		const double &	inRangeMin,
		const double &	inRangeMax,
		const double &	outRangeMin,
		const double &	outRangeMax,
		double &	gain,
		double &	offset1,
		double &	offset2
	)

static

Returns gain and offset values for contrast types (when applicable).

Parameters

inRangeMin	Input values range minimum value.
inRangeMax	Input values range maximum value.
outRangeMin	Output values range minimum value.
outRangeMax	Output values range maximum value.
gain	Calculated gain.
offset1	Calculated offset 1.
offset2	Calculated offset 2.

Returns: true if OK, false on errors.

Definition at line 424 of file src/terralib/rp/Contrast.cpp.

References te::rp::Contrast::InputParameters::LinearContrastT, te::rp::Contrast::InputParameters::LogContrastT, te::rp::Contrast::InputParameters::SquareContrastT, te::rp::Contrast::InputParameters::SquareRootContrastT, TERP_LOG_AND_RETURN_FALSE, and TERP_TRUE_OR_RETURN_FALSE.

Referenced by te::mnt::ImageGenerationDialog::drawPreview(), execLinearContrast(), execLogContrast(), execSquareContrast(), execSquareRootContrast(), te::qt::widgets::MixtureModelWizard::execute(), te::qt::widgets::RasterSymbolizerWidget::onApplyToolButtonClicked(), te::mnt::SlopeDialog::onOkPushButtonClicked(), te::mnt::MNTGenerationDialog::onOkPushButtonClicked(), and te::mnt::ImageGenerationDialog::onOkPushButtonClicked().

void te::rp::Contrast::histogramEqualizationRemap	(	const double &	inValue,
		double &	outValue
	)

inlineprotected

Remap on gray level using two offsets and gain.

Parameters

inValue	Input gray level.
outValue	Output gray level.

Definition at line 403 of file Contrast.h.

Referenced by execHistogramEqualizationContrast().

bool te::rp::Contrast::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 302 of file src/terralib/rp/Contrast.cpp.

Referenced by te::qt::widgets::ContrastDialogForm::applyPreview(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_SUITE(), Contrast(), te::qt::widgets::ContrastDialogForm::execute(), te::qt::widgets::ContrastDialog::on_okPushButton_clicked(), and te::rp::RasterSlicing().

bool te::rp::Contrast::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 419 of file src/terralib/rp/Contrast.cpp.

References m_isInitialized.

void te::rp::Contrast::logRemap	(	const double &	inValue,
		double &	outValue
	)

inlineprotected

Remap on gray level using a log.

Parameters

inValue	Input gray level.
outValue	Output gray level.

Note: outValue = m_logRemap_gain * std::log10( inValue + m_logRemap_offset + 1.0 );

Definition at line 381 of file Contrast.h.

Referenced by execLogContrast().

void te::rp::Contrast::offSetGainRemap	(	const double &	inValue,
		double &	outValue
	)

inlineprotected

Remap on gray level using an offset and gain.

Parameters

inValue	Input gray level.
outValue	Output gray level.

Note: outValue = ( ( inValue + m_offSetGainRemap_offset1 ) * m_offSetGainRemap_gain ) + m_offSetGainRemap_offset2

Definition at line 347 of file Contrast.h.

Referenced by execLinearContrast().

bool te::rp::Contrast::remapBandLevels	(	const te::rst::Band &	inRasterBand,
		te::rst::Band &	outRasterBand,
		RemapFuncPtrT	remapFuncPtr,
		const bool	enableProgress
	)

protected

Band gray levels remap using a remap function.

Parameters

inRasterBand	Input raster band.
outRasterBand	Output raster band.
remapFuncPtr	The remap function pointer used.
enableProgress	Enable the use of a progress interface.