Raster processing auxiliary functions. More...

Functions
void	te::rp::Convert2DoublesVector (void inputVector, const int inputVectorDataType, unsigned int inputVectorSize, double outputVector)
	Convert vector elements. More...

void	te::rp::ConvertDoublesVector (double inputVector, unsigned int inputVectorSize, const int outputVectorDataType, void outputVector)
	Convert a doubles vector. More...

bool	te::rp::ConvertIHS2RGB (const te::rst::Raster &inputIHSRaster, const unsigned int intensityBandIdx, const unsigned int hueBandIdx, const unsigned int saturationBandIdx, const double rgbRangeMin, const double rgbRangeMax, te::rst::Raster &outputRGBRaster)
	IHS to RGB conversion. More...

bool	te::rp::ConvertRGB2IHS (const te::rst::Raster &inputRGBRaster, const unsigned int redBandIdx, const unsigned int greenBandIdx, const unsigned int blueBandIdx, const double rgbRangeMin, const double rgbRangeMax, te::rst::Raster &outputIHSRaster)
	RGB to IHS conversion. More...

bool TERPEXPORT	te::rp::Copy2DiskRaster (const te::rst::Raster &inputRaster, const std::string &fileName)
	Create a new raster into a GDAL datasource. More...

bool	te::rp::CreateNewGdalRaster (const te::rst::Grid &rasterGrid, std::vector< te::rst::BandProperty * > bandsProperties, const std::string &fileName, RasterHandler &outRasterHandler)
	Create a new raster into a GDAL datasource. More...

bool	te::rp::CreateNewMemRaster (const te::rst::Grid &rasterGrid, std::vector< te::rst::BandProperty * > bandsProperties, RasterHandler &outRasterHandler)
	Create a new raster into a new memory datasource. More...

bool	te::rp::CreateNewRaster (const te::rst::Grid &rasterGrid, const std::vector< te::rst::BandProperty * > &bandsProperties, const std::string &outDataSetName, const std::string &dataSourceType, RasterHandler &outRasterHandler)
	Create a new raster into the givem data source. More...

bool	te::rp::CreateNewRaster (const te::rst::Grid &rasterGrid, const std::vector< te::rst::BandProperty * > &bandsProperties, const std::string &outDataSetName, te::da::DataSource &outDataSource, RasterHandler &outRasterHandler)
	Create a new raster into the givem data source. More...

template<typename MatrixElementT >
bool	te::rp::CreateRasterFileFromMatrix (const te::rp::Matrix< MatrixElementT > &matrix, const bool normalize, const std::string &fileName)
	Create a tiff file from a matrix. More...

bool	te::rp::DirectPrincipalComponents (const te::rst::Raster &inputRaster, const std::vector< unsigned int > &inputRasterBands, boost::numeric::ublas::matrix< double > &pcaMatrix, te::rst::Raster &pcaRaster, const unsigned int maxThreads)
	Generate all principal components from the given input raster. More...

std::vector< std::string >	te::rp::GetBandNames ()
	Returns a vector os with band's names. More...

bool	te::rp::GetCovarianceValue (const te::rst::Band &band1, const te::rst::Band &band2, const unsigned int maxThreads, double const const mean1ValuePtr, double const const mean2ValuePtr, double &covarianceValue)
	Get the covariance of band pixel values. More...

void TERPEXPORT	te::rp::GetDataTypeRange (const int dataType, double &min, double &max)
	Returns the real data type range (all values that can be represented by the given data type). More...

std::pair< double, double >	te::rp::GetDigitalNumberBandInfo (std::string bandName)
	Returns the maximun and minimum digital numbers of a given sensor/band. More...

double	te::rp::GetDigitalNumberBandMax (std::string bandName)
	Returns the maximum digital number of a given sensor/band. More...

std::vector< te::gm::Point * >	te::rp::GetRandomPointsInRaster (const te::rst::Raster &inputRaster, unsigned int numberOfPoints=1000)
	Creates a vector of random positions (points) inside the raster. More...

std::pair< double, double >	te::rp::GetSpectralBandInfo (std::string bandName)
	Returns the maximun and minimum reflectance values of a given sensor/band. More...

double	te::rp::GetSpectralBandMax (std::string bandName)
	Returns the maximum reflectance value of a given sensor/band. More...

double	te::rp::GetSpectralBandMin (std::string bandName)
	Returns the minimum reflectance value of a given sensor/band. More...

bool	te::rp::InversePrincipalComponents (const te::rst::Raster &pcaRaster, const boost::numeric::ublas::matrix< double > &pcaMatrix, te::rst::Raster &outputRaster, const unsigned int maxThreads)
	Regenerate the original raster from its principal components. More...

bool	te::rp::NormalizeRaster (te::rst::Raster &inputRaster, double nmin=0.0, double nmax=255.0)
	Normalizes one raster in a given interval. More...

bool	te::rp::RemapValues (const te::rst::Raster &inputRaster, const std::vector< unsigned int > &inputRasterBands, const boost::numeric::ublas::matrix< double > &remapMatrix, te::rst::Raster &outputRaster, const unsigned int maxThreads)
	Remap pixel values using a remap function matrix. More...

Detailed Description

Raster processing auxiliary functions.

Function Documentation

void TERPEXPORT te::rp::Convert2DoublesVector	(	void *	inputVector,
		const int	inputVectorDataType,
		unsigned int	inputVectorSize,
		double *	outputVector
	)

Convert vector elements.

Parameters

inputVector	Input vector.
inputVectorDataType	Input vector data type.
inputVectorSize	The numer of input vector elements.
outputVector	A pré-allocated output vector.

Note: The types are listed in terralib/datatype/DataTypes.h

Definition at line 332 of file Functions.cpp.

References te::dt::BIT_TYPE, te::dt::CDOUBLE_TYPE, te::dt::CFLOAT_TYPE, te::dt::CHAR_TYPE, te::dt::CINT16_TYPE, te::dt::CINT32_TYPE, te::dt::DOUBLE_TYPE, te::dt::FLOAT_TYPE, te::dt::INT16_TYPE, te::dt::INT32_TYPE, te::dt::INT64_TYPE, te::dt::UCHAR_TYPE, te::dt::UINT16_TYPE, te::dt::UINT32_TYPE, and te::dt::UINT64_TYPE.

Referenced by te::rp::GetCovarianceValueThread(), te::rp::GetMeanValueThread(), te::rp::GetStdDevValueThread(), te::rp::Contrast::remapBandLevels(), and te::rp::RemapValuesThread().

void TERPEXPORT te::rp::ConvertDoublesVector	(	double *	inputVector,
		unsigned int	inputVectorSize,
		const int	outputVectorDataType,
		void *	outputVector
	)

Convert a doubles vector.

Parameters

inputVector	Input vector.
inputVectorSize	The numer of input vector elements.
inputVectorDataType	Input vector data type.
outputVector	A pré-allocated output vector.

Note: The types are listed in terralib/datatype/DataTypes.h

Definition at line 444 of file Functions.cpp.

References te::dt::BIT_TYPE, te::dt::CDOUBLE_TYPE, te::dt::CFLOAT_TYPE, te::dt::CHAR_TYPE, te::dt::CINT16_TYPE, te::dt::CINT32_TYPE, te::dt::DOUBLE_TYPE, te::dt::FLOAT_TYPE, te::dt::INT16_TYPE, te::dt::INT32_TYPE, te::dt::INT64_TYPE, te::dt::UCHAR_TYPE, te::dt::UINT16_TYPE, te::dt::UINT32_TYPE, and te::dt::UINT64_TYPE.

Referenced by te::rp::Contrast::remapBandLevels(), and te::rp::RemapValuesThread().

TERPEXPORT bool te::rp::ConvertIHS2RGB	(	const te::rst::Raster &	inputIHSRaster,
		const unsigned int	intensityBandIdx,
		const unsigned int	hueBandIdx,
		const unsigned int	saturationBandIdx,
		const double	rgbRangeMin,
		const double	rgbRangeMax,
		te::rst::Raster &	outputRGBRaster
	)

IHS to RGB conversion.

Parameters

inputIHSRaster	The input raster.
intensityBandIdx	The intensity band index.
hueBandIdx	The hue band index.
saturationBandIdx	The saturation band index.
rgbRangeMin	The minimum RGB value.
rgbRangeMax	The maximum RGB value.
outputRGBRaster	An output pré-initiated raster (with the same dimensions of inputIHSRaster) where the RGB data will be written.

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 893 of file Functions.cpp.

References te::rst::Raster::getAccessPolicy(), te::rst::Raster::getBand(), te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rst::Band::getValue(), te::rst::BandProperty::m_noDataValue, M_PI, MAX, MIN, te::common::RAccess, te::rst::Band::setValue(), and te::common::WAccess.

Referenced by te::qt::widgets::ColorTransformWizard::executeIHS2RGB().

TERPEXPORT bool te::rp::ConvertRGB2IHS	(	const te::rst::Raster &	inputRGBRaster,
		const unsigned int	redBandIdx,
		const unsigned int	greenBandIdx,
		const unsigned int	blueBandIdx,
		const double	rgbRangeMin,
		const double	rgbRangeMax,
		te::rst::Raster &	outputIHSRaster
	)

RGB to IHS conversion.

Parameters

inputRGBRaster	The input raster.
redBandIdx	The red band index.
greenBandIdx	The red band index.
blueBandIdx	The red band index.
rgbRangeMin	The minimum RGB value.
rgbRangeMax	The maximum RGB value.
outputIHSRaster	An output pré-initiated raster (with the same dimensions of inputRGBRaster) where the IHS data will be written.

Returns: true if OK, false on errors.

Note: The outputIHSRaster mas have a float or double data type.; IHS data with the following channels ranges: I:[0,1] H:[0,2pi] (radians) S:[0,1].

Definition at line 765 of file Functions.cpp.

References te::rst::Raster::getAccessPolicy(), te::rst::Raster::getBand(), te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rst::Band::getValue(), te::rst::BandProperty::m_noDataValue, M_PI, te::common::RAccess, te::rst::Raster::setValue(), and te::common::WAccess.

Referenced by te::qt::widgets::ColorTransformWizard::executeRGB2IHS().

bool TERPEXPORT te::rp::Copy2DiskRaster	(	const te::rst::Raster &	inputRaster,
		const std::string &	fileName
	)

Create a new raster into a GDAL datasource.

Parameters

rasterGrid	The template grid used to create the output raster.
bandsProperties	The template band properties used to create the output raster.
fileName	The output tif file name.
outRasterHandler	The created raster handler.

Returns: true if OK, false on errors.

Note: All bandsProperties pointed objects will be acquired by this function and must not be deleted.

Definition at line 282 of file Functions.cpp.

References te::rp::CreateNewGdalRaster(), te::rst::Raster::getAccessPolicy(), te::rst::Raster::getBand(), te::rst::Raster::getGrid(), te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rp::RasterHandler::getRasterPtr(), te::rst::Band::getValue(), te::common::RAccess, and te::rst::Band::setValue().

bool TERPEXPORT te::rp::CreateNewGdalRaster	(	const te::rst::Grid &	rasterGrid,
		std::vector< te::rst::BandProperty * >	bandsProperties,
		const std::string &	fileName,
		RasterHandler &	outRasterHandler
	)

Create a new raster into a GDAL datasource.

Parameters

rasterGrid	The template grid used to create the output raster.
bandsProperties	The template band properties used to create the output raster.
fileName	The output tif file name.
outRasterHandler	The created raster handler.

Returns: true if OK, false on errors.

Note: All bandsProperties pointed objects will be acquired by this function and must not be deleted.

Definition at line 236 of file Functions.cpp.

References te::rp::CreateNewRaster(), te::da::DataSourceFactory::make(), te::rp::RasterHandler::release(), and te::rp::RasterHandler::reset().

Referenced by te::rp::Copy2DiskRaster().

bool TERPEXPORT te::rp::CreateNewMemRaster	(	const te::rst::Grid &	rasterGrid,
		std::vector< te::rst::BandProperty * >	bandsProperties,
		RasterHandler &	outRasterHandler
	)

Create a new raster into a new memory datasource.

Parameters

rasterGrid	The template grid used to create the output raster.
bandsProperties	The template band properties used to create the output raster.
outRasterHandler	The created raster handler.

Returns: true if OK, false on errors.

Note: All bandsProperties pointed objects will be acquired by this function and must not be deleted.

Definition at line 225 of file Functions.cpp.

References te::rp::CreateNewRaster().

bool TERPEXPORT te::rp::CreateNewRaster	(	const te::rst::Grid &	rasterGrid,
		const std::vector< te::rst::BandProperty * > &	bandsProperties,
		const std::string &	outDataSetName,
		const std::string &	dataSourceType,
		RasterHandler &	outRasterHandler
	)

Create a new raster into the givem data source.

Parameters

rasterGrid	The template grid used to create the output raster.
bandsProperties	The template band properties used to create the output raster.
outDataSetName	The data set name to give to the created data set.
dataSourceType	The data source type string (i.e. GDAL, MEM.).
outRasterHandler	The created raster handler.

Returns: true if OK, false on errors.

Note: All bandsProperties pointed objects will be acquired by this function and must not be deleted.

Definition at line 120 of file Functions.cpp.

References te::da::DataSourceFactory::make(), te::rp::RasterHandler::release(), and te::rp::RasterHandler::reset().

Referenced by te::rp::CreateNewGdalRaster(), te::rp::CreateNewMemRaster(), and te::rp::SequenceMosaic::createRasterDataSet().

bool TERPEXPORT te::rp::CreateNewRaster	(	const te::rst::Grid &	rasterGrid,
		const std::vector< te::rst::BandProperty * > &	bandsProperties,
		const std::string &	outDataSetName,
		te::da::DataSource &	outDataSource,
		RasterHandler &	outRasterHandler
	)

Create a new raster into the givem data source.

Parameters

rasterGrid	The template grid used to create the output raster.
bandsProperties	The template band properties used to create the output raster.
outDataSetName	The data set name to give to the created data set.
outDataSource	The data source to use when creating the output data set.
outRasterHandler	The created raster handler.

Returns: true if OK, false on errors.

Note: All bandsProperties pointed objects will be acquired by this function and must not be deleted.

Definition at line 156 of file Functions.cpp.

References te::common::FORWARDONLY, te::da::DataSource::getTransactor(), te::rp::RasterHandler::reset(), and te::common::RWAccess.

template<typename MatrixElementT >

bool te::rp::CreateRasterFileFromMatrix	(	const te::rp::Matrix< MatrixElementT > &	matrix,
		const bool	normalize,
		const std::string &	fileName
	)

Create a tiff file from a matrix.

Parameters

matrix	The matrix.
normalize	Enable/disable pixel normalization (8bit);
tifFileName	Tif file name.
return	true if OK, false on errors.

Definition at line 185 of file Functions.h.

References te::dt::DOUBLE_TYPE, te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rst::GrayIdxCInt, te::rst::RasterFactory::make(), TERP_TRUE_OR_RETURN_FALSE, and te::dt::UCHAR_TYPE.

TERPEXPORT bool te::rp::DirectPrincipalComponents	(	const te::rst::Raster &	inputRaster,
		const std::vector< unsigned int > &	inputRasterBands,
		boost::numeric::ublas::matrix< double > &	pcaMatrix,
		te::rst::Raster &	pcaRaster,
		const unsigned int	maxThreads
	)

Generate all principal components from the given input raster.

Parameters

inputRaster	Input raster.
inputRasterBands	Input raster bands.
pcaMatrix	The matrix generated over the principal components process.
pcaRaster	The pré-initiated output PCA raster (with the same dimensions of inputRaster).
maxThreads	The maximum number of threads to use (0-auto, 1-single thread used).

Returns: true if OK, false on errors.

Note: Optimized for rasters where the used bands have the same blocking scheme.

Definition at line 1524 of file Functions.cpp.

References te::common::EigenVectors(), te::rst::Raster::getAccessPolicy(), te::rst::Raster::getBand(), te::rp::GetCovarianceValue(), te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::common::RAccess, te::rp::RemapValues(), and te::common::WAccess.

Referenced by te::rp::PCAFusion::execute().

TERPEXPORT std::vector< std::string > te::rp::GetBandNames ( )

Returns a vector os with band's names.

Definition at line 557 of file Functions.cpp.

Referenced by te::qt::widgets::MixtureModelWizardPage::listBands(), and te::qt::widgets::MixtureModelDialog::MixtureModelDialog().

TERPEXPORT bool te::rp::GetCovarianceValue	(	const te::rst::Band &	band1,
		const te::rst::Band &	band2,
		const unsigned int	maxThreads,
		double const *const	mean1ValuePtr,
		double const *const	mean2ValuePtr,
		double &	covarianceValue
	)

Get the covariance of band pixel values.

Parameters

band1	The input band 1.
band2	The input band 2.
maxThreads	The maximum number of threads to use (0-auto, 1-single thread used).
mean1ValuePtr	A pointer to a pre-calculated band1 mean value or zero if it does not exist.
mean2ValuePtr	A pointer to a pre-calculated band2 mean value or zero if it does not exist.
covarianceValue	The calculated covariance value.

Returns: true if OK, false on errors.

Note: Optimized for rasters where the used bands have the same blocking scheme.

Definition at line 1377 of file Functions.cpp.

Referenced by te::rp::DirectPrincipalComponents().

void TERPEXPORT te::rp::GetDataTypeRange	(	const int	dataType,
		double &	min,
		double &	max
	)

inline

Returns the real data type range (all values that can be represented by the given data type).

Parameters

dataType	The data type.
min	The minimum value.
max	The maximum value.

Note: The types are listed in terralib/datatype/DataTypes.h

Definition at line 146 of file Functions.h.

References te::rst::GetDataTypeRanges().

Referenced by te::rp::Filter::DilationFilter(), te::rp::Filter::ErosionFilter(), te::rp::Contrast::execHistogramEqualizationContrast(), te::rp::Contrast::execLinearContrast(), te::rp::Contrast::execSetMeanAndStdContrast(), te::rp::ArithmeticOperations::execute(), te::rp::Filter::MeanFilter(), te::rp::Filter::MedianFilter(), te::rp::Filter::ModeFilter(), te::rp::Contrast::remapBandLevels(), te::rp::Filter::RobertsFilter(), te::rp::Filter::SobelFilter(), te::rp::PCAFusion::swapBandByHighResRaster(), and te::rp::Filter::UserDefinedFilter().

TERPEXPORT std::pair< double, double > te::rp::GetDigitalNumberBandInfo ( std::string bandName )

Returns the maximun and minimum digital numbers of a given sensor/band.

Definition at line 652 of file Functions.cpp.

Referenced by te::rp::GetDigitalNumberBandMax().

TERPEXPORT double te::rp::GetDigitalNumberBandMax ( std::string bandName )

Returns the maximum digital number of a given sensor/band.

Definition at line 697 of file Functions.cpp.

References te::rp::GetDigitalNumberBandInfo().

Referenced by te::rp::MixtureModelLinearStrategy::execute(), and te::rp::MixtureModelPCAStrategy::execute().

TERPEXPORT std::vector< te::gm::Point * > te::rp::GetRandomPointsInRaster	(	const te::rst::Raster &	inputRaster,
		unsigned int	numberOfPoints = `1000`
	)

Creates a vector of random positions (points) inside the raster.

Parameters

inputRaster	The given raster.
numberOfPoints	The number of random positions to be created (default = 1000).

Returns: A vector of random positions (points).

Definition at line 746 of file Functions.cpp.

References te::rst::Raster::getGrid(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Raster::getSRID(), and te::rst::Grid::gridToGeo().

Referenced by te::rp::ClassifierKMeansStrategy::execute(), and te::rp::ClassifierEMStrategy::execute().

TERPEXPORT std::pair< double, double > te::rp::GetSpectralBandInfo ( std::string bandName )

Returns the maximun and minimum reflectance values of a given sensor/band.

Definition at line 597 of file Functions.cpp.

Referenced by te::rp::GetSpectralBandMax(), and te::rp::GetSpectralBandMin().

TERPEXPORT double te::rp::GetSpectralBandMax ( std::string bandName )

Returns the maximum reflectance value of a given sensor/band.

Definition at line 647 of file Functions.cpp.

References te::rp::GetSpectralBandInfo().

TERPEXPORT double te::rp::GetSpectralBandMin ( std::string bandName )

Returns the minimum reflectance value of a given sensor/band.

Definition at line 642 of file Functions.cpp.

References te::rp::GetSpectralBandInfo().

TERPEXPORT bool te::rp::InversePrincipalComponents	(	const te::rst::Raster &	pcaRaster,
		const boost::numeric::ublas::matrix< double > &	pcaMatrix,
		te::rst::Raster &	outputRaster,
		const unsigned int	maxThreads
	)

Regenerate the original raster from its principal components.

Parameters

pcaRaster	The principal components raster (with the same dimensions of outputRaster).
pcaMatrix	The matrix generated by the direct principal components process.
outputRaster	The regenerated output raster (with the same dimentions.
maxThreads	The maximum number of threads to use (0-auto, 1-single thread used).

Returns: true if OK, false on errors.

Note: Optimized for rasters where the used bands have the same blocking scheme.

Definition at line 1612 of file Functions.cpp.

References te::common::GetInverseMatrix(), te::rst::Raster::getNumberOfBands(), and te::rp::RemapValues().

Referenced by te::rp::PCAFusion::execute().

TERPEXPORT bool te::rp::NormalizeRaster	(	te::rst::Raster &	inputRaster,
		double	nmin = `0.0`,
		double	nmax = `255.0`
	)

Normalizes one raster in a given interval.

Parameters

inputRaster	The given raster.
nmin	The new minimum value (default = 0.0).
nmax	The new maximum value (default = 255.0).

Returns: true if normalization occurs and false otherwise.

Definition at line 702 of file Functions.cpp.

References te::rst::RasterIterator< T >::begin(), te::rst::RasterIterator< T >::end(), te::rst::Raster::getBand(), te::rst::RasterIterator< T >::getColumn(), te::rst::Band::getMaxValue(), te::rst::Band::getMinValue(), te::rst::Raster::getNumberOfBands(), te::rst::RasterIterator< T >::getRow(), and te::rst::Raster::setValue().

Referenced by te::rp::MixtureModel::execute().

TERPEXPORT bool te::rp::RemapValues	(	const te::rst::Raster &	inputRaster,
		const std::vector< unsigned int > &	inputRasterBands,
		const boost::numeric::ublas::matrix< double > &	remapMatrix,
		te::rst::Raster &	outputRaster,
		const unsigned int	maxThreads
	)

Remap pixel values using a remap function matrix.

Parameters

inputRaster	Input raster.
inputRasterBands	Input raster bands.
remapMatrix	The remap function matrix.
outputRaster	The pré-initiated output raster (with the same dimentions of inputRaster).
maxThreads	The maximum number of threads to use (0-auto, 1-single thread used).

Returns: true if OK, false on errors.

Note: Optimized for rasters where the used bands have the same blocking scheme.

Definition at line 1801 of file Functions.cpp.

Referenced by te::rp::DirectPrincipalComponents(), and te::rp::InversePrincipalComponents().