Fusion of a low-resolution multi-band image with a high resolution image using the IHS method. More...

#include <IHSFusion.h>

Inheritance diagram for te::rp::IHSFusion:

Classes
class	InputParameters
	IHSFusion input parameters. More...

class	OutputParameters
	IHSFusion output parameters. 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...

	IHSFusion ()

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

	~IHSFusion ()

Protected Member Functions
bool	getRGBRange (double &rgbMin, double &rgbMax) const
	Get the minimum and maximum values from the RGB input image. More...

bool	getStatistics (const te::rp::Matrix< float > &matrix, float &mean, float &variance) const
	Get statistics from the given matrix. More...

bool	loadIHSData (const double &rgbMin, const double rgbMax, te::rp::Matrix< float > &intensityData, te::rp::Matrix< float > &hueData, te::rp::Matrix< float > &saturationData) const
	Load resampled IHS data from the input image. More...

bool	saveIHSData (const double &rgbMin, const double rgbMax, const te::rp::Matrix< float > &intensityData, const te::rp::Matrix< float > &hueData, const te::rp::Matrix< float > &saturationData, const std::string &rType, const std::map< std::string, std::string > &rInfo, std::unique_ptr< te::rst::Raster > &outputRasterPtr) const
	Save resampled IHS data as RGB data to the output image. More...

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

bool	swapIntensity (te::rp::Matrix< float > &intensityData)
	Swap the intensity data by the high resolution image data. More...

Protected Attributes
InputParameters	m_inputParameters
	Input execution parameters. More...

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

Detailed Description

Fusion of a low-resolution multi-band image with a high resolution image using the IHS method.

The IHS is one of the widespread image fusion methods in the remote sensing community and has been employed as a standard procedure in many commercial packages; IHS is the intrinsic method when the intensity channel is replaced by the high-resolution Pan image.

Note: This algorithm expects both images to be aligned over the same geographic region. No reprojection or crop operations are performed.; Reference: Te-Ming Tu, Shun-Chi Su, Hsuen-Chyun Shyu, Ping S. Huang, A new look at IHS-like image fusion methods, Information Fusion, Volume 2, Issue 3, September 2001, Pages 177-186, ISSN 1566-2535.; Reference: W.J. Carper, T.M. Lillesand, R.W. Kiefer, The use of intensity-hue-saturation transformations for merging SPOT panchromatic and multispectral image data Photogramm. Eng. Remote Sensing, 56 (1990), pp. 459–467.

Definition at line 56 of file IHSFusion.h.

Constructor & Destructor Documentation

te::rp::IHSFusion::IHSFusion ( )

Definition at line 141 of file src/terralib/rp/IHSFusion.cpp.

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

te::rp::IHSFusion::~IHSFusion ( )

default

Referenced by IHSFusion().

Member Function Documentation

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

References getRGBRange(), loadIHSData(), te::rp::IHSFusion::InputParameters::m_enableProgress, m_inputParameters, m_isInitialized, te::rp::IHSFusion::OutputParameters::m_outputRasterPtr, te::rp::IHSFusion::OutputParameters::m_rInfo, te::rp::IHSFusion::OutputParameters::m_rType, te::rp::Matrix< TemplateElementType >::reset(), saveIHSData(), swapIntensity(), TERP_INSTANCE_TRUE_OR_RETURN_FALSE, and TERP_TRUE_OR_THROW.

Referenced by BOOST_AUTO_TEST_SUITE(), te::qt::widgets::FusionWizard::executeIHS(), and IHSFusion().

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::IHSFusion::getRGBRange	(	double &	rgbMin,
		double &	rgbMax
	)		const

protected

Get the minimum and maximum values from the RGB input image.

Parameters

rgbMin	RGB minimum value.
rgbMax	RGB maximum value.

Returns: true if ok, false on errors.

Definition at line 303 of file src/terralib/rp/IHSFusion.cpp.

References col, te::rst::Raster::getBand(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rst::Band::getValue(), m_inputParameters, te::rp::IHSFusion::InputParameters::m_lowResRasterBlueBandIndex, te::rp::IHSFusion::InputParameters::m_lowResRasterGreenBandIndex, te::rp::IHSFusion::InputParameters::m_lowResRasterPtr, te::rp::IHSFusion::InputParameters::m_lowResRasterRedBandIndex, te::rst::BandProperty::m_noDataValue, te::rp::IHSFusion::InputParameters::m_RGBMax, te::rp::IHSFusion::InputParameters::m_RGBMin, and nCols.

Referenced by execute().

bool te::rp::IHSFusion::getStatistics	(	const te::rp::Matrix< float > &	matrix,
		float &	mean,
		float &	variance
	)		const

protected

Get statistics from the given matrix.

Parameters

matrix	Input matrix.
mean	Mean value.
variance	Variance value.

Returns: true if ok, false on errors.

Definition at line 494 of file src/terralib/rp/IHSFusion.cpp.

References col, te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), and nCols.

Referenced by swapIntensity().

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

Referenced by BOOST_AUTO_TEST_SUITE(), te::qt::widgets::FusionWizard::executeIHS(), and IHSFusion().

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

References m_isInitialized.

bool te::rp::IHSFusion::loadIHSData	(	const double &	rgbMin,
		const double	rgbMax,
		te::rp::Matrix< float > &	intensityData,
		te::rp::Matrix< float > &	hueData,
		te::rp::Matrix< float > &	saturationData
	)		const

protected

Load resampled IHS data from the input image.

Parameters

rgbMin	RGB minimum value.
rgbMax	RGB maximum value.
intensityData	Intensity channel data.
hueData	Hue channel data.
saturationData	Saturation channel data.

Returns: true if ok, false on errors.

Note: IHS data with the following channels ranges: I:[0,1] H:[0,2pi] (radians) S:[0,1].

Definition at line 361 of file src/terralib/rp/IHSFusion.cpp.

References te::rst::Raster::getBand(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rst::Interpolator::getValue(), te::rp::IHSFusion::InputParameters::m_highResRasterPtr, m_inputParameters, te::rp::IHSFusion::InputParameters::m_interpMethod, te::rp::IHSFusion::InputParameters::m_lowResRasterBlueBandIndex, te::rp::IHSFusion::InputParameters::m_lowResRasterGreenBandIndex, te::rp::IHSFusion::InputParameters::m_lowResRasterPtr, te::rp::IHSFusion::InputParameters::m_lowResRasterRedBandIndex, te::rst::BandProperty::m_noDataValue, M_PI, and te::rp::Matrix< TemplateElementType >::reset().

Referenced by execute().

void te::rp::IHSFusion::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 233 of file src/terralib/rp/IHSFusion.cpp.

References m_inputParameters, m_isInitialized, te::rp::Algorithm::reset(), and te::rp::IHSFusion::InputParameters::reset().

bool te::rp::IHSFusion::saveIHSData	(	const double &	rgbMin,
		const double	rgbMax,
		const te::rp::Matrix< float > &	intensityData,
		const te::rp::Matrix< float > &	hueData,
		const te::rp::Matrix< float > &	saturationData,
		const std::string &	rType,
		const std::map< std::string, std::string > &	rInfo,
		std::unique_ptr< te::rst::Raster > &	outputRasterPtr
	)		const