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

	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::auto_ptr< te::rst::Raster > &outputRasterPtr) const
	Save resampled IHS data as RGB data to the output image. 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.

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.

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 54 of file IHSFusion.h.

Constructor & Destructor Documentation

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

Definition at line 141 of file IHSFusion.cpp.

References reset().

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

Definition at line 146 of file IHSFusion.cpp.

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.

Implements te::rp::Algorithm.

Definition at line 150 of file 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_TRUE_OR_RETURN_FALSE, and TERP_TRUE_OR_THROW.

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

References 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, and te::rp::IHSFusion::InputParameters::m_RGBMin.

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

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

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 te::rp::Module::getLastLogStr()

Implements te::rp::Algorithm.

Definition at line 241 of file IHSFusion.cpp.

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

Implements te::rp::Algorithm.

Definition at line 235 of file IHSFusion.cpp.

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

Referenced by IHSFusion(), initialize(), te::rp::IHSFusion::InputParameters::InputParameters(), te::rp::IHSFusion::InputParameters::operator=(), te::rp::IHSFusion::OutputParameters::operator=(), te::rp::IHSFusion::OutputParameters::OutputParameters(), te::rp::IHSFusion::InputParameters::~InputParameters(), and te::rp::IHSFusion::OutputParameters::~OutputParameters().

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::auto_ptr< te::rst::Raster > &	outputRasterPtr
	)		const

protected

Save resampled IHS data as RGB data to the output 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.

Definition at line 605 of file IHSFusion.cpp.

References te::rst::Raster::getBand(), te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rst::Grid::getExtent(), te::rst::Raster::getGrid(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rst::Grid::getSRID(), te::rp::IHSFusion::InputParameters::m_highResRasterPtr, 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, M_PI, te::rst::RasterFactory::make(), MAX, MIN, te::rst::Band::setValue(), and TERP_TRUE_OR_RETURN_FALSE.

Referenced by execute().

bool te::rp::IHSFusion::swapIntensity ( te::rp::Matrix< float > & intensityData )

protected

Swap the intensity data by the high resolution image data.

Parameters

intensityData Intensity channel data.

Returns: true if ok, false on errors.

Definition at line 537 of file IHSFusion.cpp.

References te::rst::Raster::getBand(), te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), getStatistics(), te::rst::Band::getValue(), te::rp::IHSFusion::InputParameters::m_highResRasterBand, te::rp::IHSFusion::InputParameters::m_highResRasterPtr, and m_inputParameters.

Referenced by execute().

Member Data Documentation

InputParameters te::rp::IHSFusion::m_inputParameters

protected

Input execution parameters.

Definition at line 150 of file IHSFusion.h.

Referenced by execute(), getRGBRange(), initialize(), loadIHSData(), reset(), saveIHSData(), and swapIntensity().

bool te::rp::IHSFusion::m_isInitialized

protected

Tells if this instance is initialized.

Definition at line 152 of file IHSFusion.h.

Referenced by execute(), initialize(), isInitialized(), and reset().

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

/home/castejon/castejon_files/develop/terralib5/git/src/terralib/rp/IHSFusion.h
/home/castejon/castejon_files/develop/terralib5/git/src/terralib/rp/IHSFusion.cpp

Classes

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation