Auxiliary functions.

Raster processing auxiliary functions. More...

Enumerations
enum	te::rp::WaveletAtrousFilterType { te::rp::InvalidWAFilter, te::rp::B3SplineWAFilter, te::rp::TriangleWAFilter }
	Wavelet Atrous Filter types. More...

Functions
bool	te::rp::ComposeBands (te::rp::FeederConstRaster &feeder, const std::vector< unsigned int > &inputRasterBands, const te::rst::Interpolator::Method &interpMethod, const std::map< std::string, std::string > &outputRasterInfo, const std::string &outputDataSourceType, std::unique_ptr< te::rst::Raster > &outputRasterPtr)
	Compose a set of bands into one multi-band raster. More...
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::ConvertHLS2RGB (const te::rst::Raster &inputHLSRaster, const unsigned int hueBandIdx, const unsigned int lightBandIdx, const unsigned int saturationBandIdx, const double rgbRangeMin, const double rgbRangeMax, te::rst::Raster &outputRGBRaster)
	HLS to RGB conversion. More...
bool	te::rp::ConvertHLS2RGB (const te::rst::Raster &inputHRaster, const unsigned int hueBandIdx, const te::rst::Raster &inputLRaster, const unsigned int lightBandIdx, const te::rst::Raster &inputSRaster, const unsigned int saturationBandIdx, const double rgbRangeMin, const double rgbRangeMax, te::rst::Raster &outputRGBRaster)
	HLS to RGB conversion. 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::ConvertIHS2RGB (const te::rst::Raster &inputIRaster, const unsigned int intensityBandIdx, const te::rst::Raster &inputHRaster, const unsigned int hueBandIdx, const te::rst::Raster &inputSRaster, const unsigned int saturationBandIdx, const double rgbRangeMin, const double rgbRangeMax, te::rst::Raster &outputRGBRaster)
	IHS to RGB conversion. More...
bool	te::rp::ConvertRGB2HLS (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 &outputHLSRaster)
	RGB to HLS conversion. More...
bool	te::rp::ConvertRGB2HLS (const te::rst::Raster &inputRedRaster, const unsigned int redBandIdx, const te::rst::Raster &inputGreenRaster, const unsigned int greenBandIdx, const te::rst::Raster &inputBlueRaster, const unsigned int blueBandIdx, const double rgbRangeMin, const double rgbRangeMax, te::rst::Raster &outputHLSRaster)
	RGB to HLS 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	te::rp::ConvertRGB2IHS (const te::rst::Raster &inputRedRaster, const unsigned int redBandIdx, const te::rst::Raster &inputGreenRaster, const unsigned int greenBandIdx, const te::rst::Raster &inputBlueRaster, 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::CreateNewGdalRaster (const te::rst::Grid &rasterGrid, std::vector< te::rst::BandProperty * > bandsProperties, const std::string &fileName, std::unique_ptr< te::rst::Raster > &outRasterPtr)
	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...
bool TERPEXPORT	te::rp::CreateNewRaster (const te::rst::Grid &rasterGrid, const std::vector< te::rst::BandProperty * > &bandsProperties, const std::map< std::string, std::string > &rasterInfo, const std::string &rasterType, std::unique_ptr< te::rst::Raster > &outRasterPtr)
	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...
boost::numeric::ublas::matrix< double >	te::rp::CreateWaveletAtrousFilter (const WaveletAtrousFilterType &filterType)
	Create a Wavele Atrous Filter. More...
bool	te::rp::DecomposeBands (const te::rst::Raster &inputRaster, const std::vector< unsigned int > &inputRasterBands, const std::vector< std::map< std::string, std::string > > &outputRastersInfos, const std::string &outputDataSourceType, std::vector< boost::shared_ptr< te::rst::Raster > > &outputRastersPtrs)
	Decompose a multi-band raster into a set of one-band rasters. 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 std::vector< unsigned int > &pcaRasterBands, const unsigned int maxThreads)
	Generate all principal components from the given input raster. More...
bool	te::rp::DirectWaveletAtrous (const te::rst::Raster &inputRaster, const std::vector< unsigned int > &inputRasterBands, te::rst::Raster &waveletRaster, const unsigned int levelsNumber, const boost::numeric::ublas::matrix< double > &filter)
	Generate all wavelet planes 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...
bool	te::rp::GetDetailedExtent (const te::rst::Grid &grid, te::gm::LinearRing &detailedExtent)
	Create a datailed extent from the given grid. 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...
double	te::rp::GetDigitalNumberBandMin (std::string bandName)
	Returns the minimum digital number of a given sensor/band. More...
bool	te::rp::GetIndexedDetailedExtent (const te::rst::Grid &grid, te::gm::LinearRing &indexedDetailedExtent)
	Create a indexed (lines,columns) datailed extent from the given grid. More...
bool	te::rp::GetMeanValue (const te::rst::Band &band, const unsigned int maxThreads, double &meanValue)
	Get the mean of band pixel values. More...
TERASTEREXPORT std::vector< te::gm::Point * >	te::rst::GetRandomPointsInRaster (const te::rst::Raster &inputRaster, unsigned int numberOfPoints=1000)
	Creates a vector of random positions (points) inside the raster. More...
std::string	te::rp::GetSensorFilename ()
	Returns a json filename with spectral sensors parameters. More...
std::map< std::string, SpectralSensorParams >	te::rp::getSensorParams ()
	Returns a map with spectral sensors parameters defined in SpectralSensor.json file. More...
SpectralSensorParams	te::rp::GetSpectralBandInfo (std::string bandName)
	Returns the maximun and minimum reflectance values of a given sensor/band. More...
TERPEXPORT double	te::rp::GetSpectralBandMax (std::string bandName)
	Returns the maximum reflectance value of a given sensor/band. More...
TERPEXPORT double	te::rp::GetSpectralBandMin (std::string bandName)
	Returns the minimum reflectance value of a given sensor/band. More...
bool	te::rp::GetStdDevValue (const te::rst::Band &band, const unsigned int maxThreads, double const *const meanValuePtr, double &stdDevValue)
	Get the standard deviation of band pixel values. More...
bool	te::rp::InversePrincipalComponents (const te::rst::Raster &pcaRaster, const boost::numeric::ublas::matrix< double > &pcaMatrix, te::rst::Raster &outputRaster, const std::vector< unsigned int > &outputRasterBands, const unsigned int maxThreads)
	Regenerate the original raster from its principal components. More...
bool	te::rp::InverseWaveletAtrous (const te::rst::Raster &waveletRaster, const unsigned int levelsNumber, te::rst::Raster &outputRaster, const std::vector< unsigned int > &outputRasterBands)
	Regenerate the original raster from its wavelets planes. 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...
te::rst::Raster *	te::rp::NormalizeRaster (const te::rst::Raster *inputRaster)
	Normalizes a raster in a given interval. More...
bool	te::rp::RasterSlicing (const te::rst::Raster &inputRaster, const unsigned int inputRasterBand, const bool createPaletteRaster, const unsigned int slicesNumber, const bool eqHistogram, const std::map< std::string, std::string > &rasterInfo, const std::string &rasterType, const bool enableProgress, std::vector< te::rst::BandProperty::ColorEntry > const *const palettePtr, std::unique_ptr< te::rst::Raster > &outRasterPtr, std::map< double, double > limits)
	Generate all wavelet planes from the given input raster. 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 std::vector< unsigned int > &outputRasterBands, const unsigned int maxThreads)
	Remap pixel values using a remap function matrix. More...
void	te::rp::SaveSensorParams (std::map< std::string, SpectralSensorParams > &)
	Saves in SpectralSensor.json file the spectral sensors parameters. More...

Detailed Description

Raster processing auxiliary functions.

Enumeration Type Documentation

enum te::rp::WaveletAtrousFilterType

Wavelet Atrous Filter types.

Enumerator
InvalidWAFilter	Invalid filter type.
B3SplineWAFilter	Spline filter type.
TriangleWAFilter	Triangle filter type.

Definition at line 73 of file src/terralib/rp/Functions.h.

Function Documentation

TERPEXPORT bool te::rp::ComposeBands	(	te::rp::FeederConstRaster &	feeder,
		const std::vector< unsigned int > &	inputRasterBands,
		const te::rst::Interpolator::Method &	interpMethod,
		const std::map< std::string, std::string > &	outputRasterInfo,
		const std::string &	outputDataSourceType,
		std::unique_ptr< te::rst::Raster > &	outputRasterPtr
	)

Compose a set of bands into one multi-band raster.

Parameters

feeder	Input rasters feeder.
inputRasterBands	Input raster bands (one band for each input raster).
interpMethod	The interpolator method to use.
outputRasterInfo	Output raster connection info.
outputDataSourceType	Output raster datasource type.
outputRasterPtr	A pointer to the generated output raster.

Returns

true if OK, false on errors.

Note

The first raster Grid will be taken as reference for the composed raster.

Definition at line 3155 of file src/terralib/rp/Functions.cpp.

References te::rst::Grid::geoToGrid(), te::rst::Raster::getBand(), te::rp::FeederConstRaster::getCurrentObj(), te::rp::FeederConstRaster::getCurrentOffset(), te::rst::Raster::getGrid(), te::rst::Raster::getNumberOfBands(), te::rp::FeederConstRaster::getObjsCount(), te::rst::Raster::getSRID(), te::rst::Interpolator::getValue(), te::rst::Grid::gridToGeo(), te::rst::RasterFactory::make(), te::rp::FeederConstRaster::moveNext(), te::rp::FeederConstRaster::reset(), and te::rst::Band::setValue().

Referenced by BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), and te::qt::widgets::ComposeBandsWizard::executeCompose().

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 367 of file src/terralib/rp/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::GetDataTypeRange(), 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 474 of file src/terralib/rp/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::GetDataTypeRange(), te::rp::Contrast::remapBandLevels(), and te::rp::RemapValuesThread().

TERPEXPORT bool te::rp::ConvertHLS2RGB	(	const te::rst::Raster &	inputHLSRaster,
		const unsigned int	hueBandIdx,
		const unsigned int	lightBandIdx,
		const unsigned int	saturationBandIdx,
		const double	rgbRangeMin,
		const double	rgbRangeMax,
		te::rst::Raster &	outputRGBRaster
	)

HLS to RGB conversion.

Parameters

inputHLSRaster	The input raster.
hueBandIdx	The hue band index.
lightBandIdx	The light 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 inputHLSRaster) where the RGB data will be written.

Returns

true if OK, false on errors.

Definition at line 1739 of file src/terralib/rp/Functions.cpp.

References col, 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, nCols, p, te::gm::CurvePolygon::push_back(), te::common::RAccess, te::rst::Band::setValue(), and te::common::WAccess.

Referenced by te::qt::widgets::ColorTransformDialog::applyPreviewHLS2RGB(), BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), and te::qt::widgets::ColorTransformDialog::executeHLS2RGB().

TERPEXPORT bool te::rp::ConvertHLS2RGB	(	const te::rst::Raster &	inputHRaster,
		const unsigned int	hueBandIdx,
		const te::rst::Raster &	inputLRaster,
		const unsigned int	lightBandIdx,
		const te::rst::Raster &	inputSRaster,
		const unsigned int	saturationBandIdx,
		const double	rgbRangeMin,
		const double	rgbRangeMax,
		te::rst::Raster &	outputRGBRaster
	)

HLS to RGB conversion.

Parameters

inputHRaster	The input hue raster.
hueBandIdx	The hue band index.
inputLRaster	The input light raster.
lightBandIdx	The light band index.
inputSRaster	The input saturation raster.
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 inputHLSRaster) where the RGB data will be written.

Returns

true if OK, false on errors.

Definition at line 1871 of file src/terralib/rp/Functions.cpp.

References col, 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, nCols, p, te::gm::CurvePolygon::push_back(), te::common::RAccess, te::rst::Band::setValue(), and te::common::WAccess.

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 1282 of file src/terralib/rp/Functions.cpp.

References col, 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, nCols, te::common::RAccess, te::rst::Band::setValue(), and te::common::WAccess.

Referenced by te::qt::widgets::ColorTransformDialog::applyPreviewIHS2RGB(), BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), and te::qt::widgets::ColorTransformDialog::executeIHS2RGB().

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

IHS to RGB conversion.

Parameters

inputIRaster	The input intensity raster.
intensityBandIdx	The intensity band index.
inputHRaster	The input hue raster.
hueBandIdx	The hue band index.
inputSRaster	The input saturation raster.
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 1408 of file src/terralib/rp/Functions.cpp.

References col, 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, nCols, te::common::RAccess, te::rst::Band::setValue(), and te::common::WAccess.

TERPEXPORT bool te::rp::ConvertRGB2HLS	(	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 &	outputHLSRaster
	)

RGB to HLS 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.
outputHLSRaster	An output pré-initiated raster (with the same dimensions of inputRGBRaster) where the HLS data will be written (double or float as the data type).

Returns

true if OK, false on errors.

Note

The outputHLSRaster mas have a float or double data type.

Definition at line 1542 of file src/terralib/rp/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::getValue(), MAX, MIN, te::common::RAccess, te::rst::Band::setValue(), and te::common::WAccess.

Referenced by te::qt::widgets::ColorTransformDialog::applyPreviewRGB2HLS(), BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), and te::qt::widgets::ColorTransformDialog::executeRGB2HLS().

TERPEXPORT bool te::rp::ConvertRGB2HLS	(	const te::rst::Raster &	inputRedRaster,
		const unsigned int	redBandIdx,
		const te::rst::Raster &	inputGreenRaster,
		const unsigned int	greenBandIdx,
		const te::rst::Raster &	inputBlueRaster,
		const unsigned int	blueBandIdx,
		const double	rgbRangeMin,
		const double	rgbRangeMax,
		te::rst::Raster &	outputHLSRaster
	)

RGB to HLS conversion.

Parameters

inputRedRaster	The input red raster.
redBandIdx	The red band index.
inputGreenRaster	The input green raster.
greenBandIdx	The green band index.
inputBlueRaster	The input blue raster.
blueBandIdx	The blue band index.
rgbRangeMin	The minimum RGB value.
rgbRangeMax	The maximum RGB value.
outputHLSRaster	An output pré-initiated raster (with the same dimensions of inputRGBRaster) where the HLS data will be written (double or float as the data type).

Returns

true if OK, false on errors.

Note

The outputHLSRaster mas have a float or double data type.

Definition at line 1638 of file src/terralib/rp/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::getValue(), MAX, MIN, te::common::RAccess, te::rst::Band::setValue(), and te::common::WAccess.

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 (double or float as the data type).

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 1005 of file src/terralib/rp/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::Band::setValue(), and te::common::WAccess.

Referenced by te::qt::widgets::ColorTransformDialog::applyPreviewRGB2IHS(), BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), and te::qt::widgets::ColorTransformDialog::executeRGB2IHS().

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

RGB to IHS conversion.

Parameters

inputRedRaster	The input red raster.
redBandIdx	The red band index.
inputGreenRaster	The input green raster.
greenBandIdx	The green band index.
inputBlueRaster	The input blue raster.
blueBandIdx	The blue 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 (double or float as the data type).

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 1140 of file src/terralib/rp/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::Band::setValue(), and te::common::WAccess.

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 317 of file src/terralib/rp/Functions.cpp.

References col, 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(), nCols, te::common::RAccess, and te::rst::Band::setValue().

Referenced by BOOST_AUTO_TEST_CASE().

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 271 of file src/terralib/rp/Functions.cpp.

References te::rp::RasterHandler::reset().

Referenced by te::rp::Copy2DiskRaster(), and exportRastertoGPKG().

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

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.
outRasterPtr	The created raster pointer.

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 289 of file src/terralib/rp/Functions.cpp.

References te::rst::RasterFactory::make().

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 260 of file src/terralib/rp/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.)( See te::rst::RasterFactory dictionary for valid registered values ).
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 131 of file src/terralib/rp/Functions.cpp.

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

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

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 167 of file src/terralib/rp/Functions.cpp.

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

bool TERPEXPORT te::rp::CreateNewRaster	(	const te::rst::Grid &	rasterGrid,
		const std::vector< te::rst::BandProperty * > &	bandsProperties,
		const std::map< std::string, std::string > &	rasterInfo,
		const std::string &	rasterType,
		std::unique_ptr< te::rst::Raster > &	outRasterPtr
	)

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.
rasterInfo	The output raster info (specific driver info).
rasterType	The output raster type (specific driver name - See te::rst::RasterFactory dictorary for more info).
outRasterPtr	The created raster pointer.

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 src/terralib/rp/Functions.cpp.

References te::rst::RasterFactory::make().

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 254 of file src/terralib/rp/Functions.h.

References band, col, te::rp::ComposeBands(), te::rp::ConvertHLS2RGB(), te::rp::ConvertIHS2RGB(), te::rp::ConvertRGB2HLS(), te::rp::ConvertRGB2IHS(), te::rp::CreateWaveletAtrousFilter(), te::rp::DecomposeBands(), te::rp::DirectPrincipalComponents(), te::rp::DirectWaveletAtrous(), te::dt::DOUBLE_TYPE, te::rp::GetBandNames(), te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::GetCovarianceValue(), te::rp::GetDetailedExtent(), te::rp::GetDigitalNumberBandInfo(), te::rp::GetDigitalNumberBandMax(), te::rp::GetDigitalNumberBandMin(), te::rp::GetIndexedDetailedExtent(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rp::GetMeanValue(), te::rp::GetSensorFilename(), te::rp::getSensorParams(), te::rp::GetSpectralBandInfo(), te::rp::GetSpectralBandMax(), te::rp::GetSpectralBandMin(), te::rp::GetStdDevValue(), te::rst::GrayIdxCInt, te::sa::Grid, te::rp::InversePrincipalComponents(), te::rp::InverseWaveletAtrous(), line, te::rst::RasterFactory::make(), nCols, nLines, te::qt::plugins::terramobile::NormalizeRaster(), te::rp::RasterResample(), te::rp::RemapValues(), te::rp::SaveSensorParams(), TERP_TRUE_OR_RETURN_FALSE, TERPEXPORT, and te::dt::UCHAR_TYPE.

TERPEXPORT boost::numeric::ublas::matrix< double > te::rp::CreateWaveletAtrousFilter

(

const WaveletAtrousFilterType &

filterType

)

Create a Wavele Atrous Filter.

Parameters

filterType

The filter type.

Returns

the created filter.

Definition at line 3378 of file src/terralib/rp/Functions.cpp.

References te::rp::B3SplineWAFilter, and te::rp::TriangleWAFilter.

Referenced by BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), and te::rp::WisperFusion::execute().

TERPEXPORT bool te::rp::DecomposeBands	(	const te::rst::Raster &	inputRaster,
		const std::vector< unsigned int > &	inputRasterBands,
		const std::vector< std::map< std::string, std::string > > &	outputRastersInfos,
		const std::string &	outputDataSourceType,
		std::vector< boost::shared_ptr< te::rst::Raster > > &	outputRastersPtrs
	)

Decompose a multi-band raster into a set of one-band rasters.

Parameters

inputRaster	Input raster.
inputRasterBands	Input raster bands.
outputRastersInfos	Output rasters connections infos. (one info for each decomposed band).
outputDataSourceType	Output raster datasource type.
outputRastersPtrs	Pointers to the generated outputs rasters.

Returns

true if OK, false on errors.

Definition at line 3089 of file src/terralib/rp/Functions.cpp.

References col, 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::rst::Band::getValue(), te::rst::RasterFactory::make(), nCols, te::common::RAccess, and te::rst::Band::setValue().

Referenced by te::qt::widgets::ColorTransformDialog::applyPreviewHLS2RGB(), te::qt::widgets::ColorTransformDialog::applyPreviewIHS2RGB(), te::qt::widgets::ColorTransformDialog::applyPreviewRGB2HLS(), te::qt::widgets::ColorTransformDialog::applyPreviewRGB2IHS(), BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), te::qt::widgets::MixtureModelWizard::decompose(), te::qt::widgets::ComposeBandsWizard::executeDecompose(), te::qt::widgets::ColorTransformDialog::executeHLS2RGB(), te::qt::widgets::ColorTransformDialog::executeIHS2RGB(), te::qt::widgets::ColorTransformDialog::executeRGB2HLS(), and te::qt::widgets::ColorTransformDialog::executeRGB2IHS().

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 std::vector< unsigned int > &	pcaRasterBands,
		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) and double as the data type.
pcaRasterBands	Output raster bands.
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 2522 of file src/terralib/rp/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 BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), te::rp::Contrast::execDecorrelationEnhancement(), te::qt::widgets::PCAWizard::execute(), and te::rp::PCAFusion::execute().

TERPEXPORT bool te::rp::DirectWaveletAtrous	(	const te::rst::Raster &	inputRaster,
		const std::vector< unsigned int > &	inputRasterBands,
		te::rst::Raster &	waveletRaster,
		const unsigned int	levelsNumber,
		const boost::numeric::ublas::matrix< double > &	filter
	)

Generate all wavelet planes from the given input raster.

Parameters

inputRaster	Input raster.
inputRasterBands	Input raster bands.
waveletRaster	The pré-initiated output wavelet raster (with the same dimensions of inputRaster) and double as the data type.
levelsNumber	The number of decomposed wavelet levels to generate for each input raster band;
filter	The square filter to use.

Returns

true if OK, false on errors.

Note

The band order of the generated wavelet levels: { [ band0-smoothed0, band0-wavelet0, ... , band0-smoothedN, band0-waveletN ], ... }

The number of bands of waveletRaster must be ( inputRasterBands.size() * 2 * levelsNumber ) at least.

Definition at line 3418 of file src/terralib/rp/Functions.cpp.

References col, te::rst::Raster::getAccessPolicy(), te::rst::Raster::getBand(), te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getValue(), nCols, nLines, te::common::RAccess, te::rst::Band::setValue(), and te::common::WAccess.

Referenced by BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), and te::rp::WisperFusion::execute().

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

(

)

Returns a vector os with band's names.

Definition at line 594 of file src/terralib/rp/Functions.cpp.

Referenced by te::rp::CreateRasterFileFromMatrix(), te::rp::getSensorParams(), 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 2375 of file src/terralib/rp/Functions.cpp.

References col, te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::GetCovarianceValueThread(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rp::GetMeanValue(), te::common::GetPhysProcNumber(), te::rst::Band::getProperty(), te::rst::Band::getValue(), te::rst::BandProperty::m_blkh, te::rst::BandProperty::m_blkw, te::rp::GetCovarianceValueThreadParams::m_covarianceValuePtr, te::rp::GetCovarianceValueThreadParams::m_inputBand1Ptr, te::rp::GetCovarianceValueThreadParams::m_inputBand2Ptr, te::rp::GetCovarianceValueThreadParams::m_mean1Value, te::rp::GetCovarianceValueThreadParams::m_mean2Value, te::rp::GetCovarianceValueThreadParams::m_mutexPtr, te::rst::BandProperty::m_nblocksx, te::rst::BandProperty::m_nblocksy, te::rst::BandProperty::m_noDataValue, te::rp::GetCovarianceValueThreadParams::m_pixelsNumberValuePtr, te::rp::GetCovarianceValueThreadParams::m_rasterBlocksStatusPtr, te::rp::GetCovarianceValueThreadParams::m_returnStatus, nCols, and te::rp::Matrix< TemplateElementType >::reset().

Referenced by BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), and 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 215 of file src/terralib/rp/Functions.h.

References te::rp::Convert2DoublesVector(), te::rp::ConvertDoublesVector(), te::rst::GetDataTypeRanges(), and TERPEXPORT.

Referenced by te::rp::Filter::DilationFilter(), te::rp::Filter::ErosionFilter(), te::rp::Contrast::execHistogramEqualizationContrast(), te::rp::Contrast::execLinearContrast(), te::rp::Contrast::execLogContrast(), te::rp::Contrast::execSetMeanAndStdContrast(), te::rp::Contrast::execSquareContrast(), te::rp::Contrast::execSquareRootContrast(), te::rp::WisperFusion::execute(), te::rp::ArithmeticOperations::execute(), te::rp::Filter::MedianFilter(), te::rp::RasterResample(), te::rp::RasterSlicing(), te::rp::Contrast::remapBandLevels(), te::rp::Filter::RobertsFilter(), te::rp::Filter::SobelFilter(), te::rp::PCAFusion::swapBandByHighResRaster(), and te::rp::Filter::UserDefinedFilter().

TERPEXPORT bool te::rp::GetDetailedExtent	(	const te::rst::Grid &	grid,
		te::gm::LinearRing &	detailedExtent
	)

Create a datailed extent from the given grid.

Parameters

grid	Input grid.
detailedExtent	The created detailed extent.

Returns

true if ok, false on errors.

Definition at line 3271 of file src/terralib/rp/Functions.cpp.

References col, te::rst::Grid::getExtent(), te::gm::Envelope::getLowerLeftX(), te::gm::Envelope::getLowerLeftY(), te::rst::Grid::getNumberOfColumns(), te::rst::Grid::getNumberOfRows(), te::rst::Grid::getResolutionX(), te::rst::Grid::getResolutionY(), te::rst::Grid::getSRID(), te::gm::Envelope::getUpperRightX(), te::gm::Envelope::getUpperRightY(), te::gm::LineStringType, and nCols.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_SUITE(), and te::rp::CreateRasterFileFromMatrix().

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 847 of file src/terralib/rp/Functions.cpp.

References te::rp::getSensorParams().

Referenced by te::rp::CreateRasterFileFromMatrix(), te::rp::GetDigitalNumberBandMax(), and te::rp::GetDigitalNumberBandMin().

TERPEXPORT double te::rp::GetDigitalNumberBandMax

(

std::string

bandName

)

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

Definition at line 857 of file src/terralib/rp/Functions.cpp.

References te::rp::GetDigitalNumberBandInfo().

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

TERPEXPORT double te::rp::GetDigitalNumberBandMin

(

std::string

bandName

)

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

Definition at line 862 of file src/terralib/rp/Functions.cpp.

References te::rp::GetDigitalNumberBandInfo().

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

TERPEXPORT bool te::rp::GetIndexedDetailedExtent	(	const te::rst::Grid &	grid,
		te::gm::LinearRing &	indexedDetailedExtent
	)

Create a indexed (lines,columns) datailed extent from the given grid.

Parameters

grid	Input grid.
indexedDetailedExtent	The created detailed extent.

Returns

true if ok, false on errors.

Definition at line 3326 of file src/terralib/rp/Functions.cpp.

References col, te::rst::Grid::getNumberOfColumns(), te::rst::Grid::getNumberOfRows(), te::gm::LineStringType, nCols, and te::gm::LineString::setPoint().

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_SUITE(), te::rp::CreateRasterFileFromMatrix(), te::rp::Register::execute(), te::rp::TiePointsMosaic::execute(), and te::rp::SequenceMosaic::execute().

TERPEXPORT bool te::rp::GetMeanValue	(	const te::rst::Band &	band,
		const unsigned int	maxThreads,
		double &	meanValue
	)

Get the mean of band pixel values.

Parameters

band	The input raster band.
maxThreads	The maximum number of threads to use (0-auto, 1-single thread used).
meanValue	The calculated mean value.

Returns

true if OK, false on errors.

Note

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

Definition at line 2104 of file src/terralib/rp/Functions.cpp.

References band, col, te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rp::GetMeanValueThread(), te::common::GetPhysProcNumber(), te::rst::Band::getProperty(), te::rp::GetMeanValueThreadParams::m_inputBandPtr, te::rp::GetMeanValueThreadParams::m_meanValuePtr, te::rp::GetMeanValueThreadParams::m_mutexPtr, te::rst::BandProperty::m_nblocksx, te::rst::BandProperty::m_nblocksy, te::rp::GetMeanValueThreadParams::m_pixelsNumberValuePtr, te::rp::GetMeanValueThreadParams::m_rasterBlocksStatusPtr, te::rp::GetMeanValueThreadParams::m_returnStatus, and te::rp::Matrix< TemplateElementType >::reset().

Referenced by BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), te::rp::Contrast::execDecorrelationEnhancement(), te::rp::GetCovarianceValue(), te::rp::GetStdDevValue(), and te::rp::PCAFusion::swapBandByHighResRaster().

std::vector< te::gm::Point * > te::rst::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 632 of file src/terralib/raster/Utils.cpp.

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

Referenced by te::qt::widgets::createHistogram(), te::qt::widgets::createScatter(), te::rp::ClassifierKMeansStrategy::execute(), te::rp::ClassifierEMStrategy::execute(), te::rst::Band::getMaxValue(), te::rst::Band::getMinValue(), and te::rst::Round().

TERPEXPORT std::string te::rp::GetSensorFilename

(

)

Returns a json filename with spectral sensors parameters.

Definition at line 582 of file src/terralib/rp/Functions.cpp.

References te::common::Version::asString(), te::core::GetAppLocalDataLocation(), and te::common::Singleton< T >::getInstance().

Referenced by te::rp::CreateRasterFileFromMatrix(), te::rp::getSensorParams(), and te::rp::SaveSensorParams().

TERPEXPORT std::map< std::string, SpectralSensorParams > te::rp::getSensorParams

(

)

Returns a map with spectral sensors parameters defined in SpectralSensor.json file.

Definition at line 688 of file src/terralib/rp/Functions.cpp.

References band, te::rp::GetBandNames(), te::rp::GetSensorFilename(), and te::rp::GetSpectralBandInfo().

Referenced by te::rp::CreateRasterFileFromMatrix(), te::rp::GetDigitalNumberBandInfo(), te::qt::widgets::MixtureModelWizardPage::listBands(), te::qt::widgets::MixtureModelWizardPage::onSensorToolButtonClicked(), and te::qt::widgets::SensorManagerDialog::updateSensorParams().

TERPEXPORT SpectralSensorParams te::rp::GetSpectralBandInfo

(

std::string

bandName

)

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

Definition at line 748 of file src/terralib/rp/Functions.cpp.

Referenced by te::rp::CreateRasterFileFromMatrix(), and te::rp::getSensorParams().

TERPEXPORT double te::rp::GetSpectralBandMax

(

std::string

bandName

)

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

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

TERPEXPORT double te::rp::GetSpectralBandMin

(

std::string

bandName

)

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

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

TERPEXPORT bool te::rp::GetStdDevValue	(	const te::rst::Band &	band,
		const unsigned int	maxThreads,
		double const *const	meanValuePtr,
		double &	stdDevValue
	)

Get the standard deviation of band pixel values.

Parameters

band	The input raster band.
maxThreads	The maximum number of threads to use (0-auto, 1-single thread used).
meanValuePtr	A pointer to a pre-calculated band mean value or zero if it does not exist.
stdDevValue	The calculated standard deviation value.

Returns

true if OK, false on errors.

Note

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

Definition at line 2229 of file src/terralib/rp/Functions.cpp.

References band, col, te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rp::GetMeanValue(), te::common::GetPhysProcNumber(), te::rst::Band::getProperty(), te::rp::GetStdDevValueThread(), te::rp::GetStdDevValueThreadParams::m_inputBandPtr, te::rp::GetStdDevValueThreadParams::m_meanValue, te::rp::GetStdDevValueThreadParams::m_mutexPtr, te::rst::BandProperty::m_nblocksx, te::rst::BandProperty::m_nblocksy, te::rp::GetStdDevValueThreadParams::m_pixelsNumberValuePtr, te::rp::GetStdDevValueThreadParams::m_rasterBlocksStatusPtr, te::rp::GetStdDevValueThreadParams::m_returnStatus, te::rp::GetStdDevValueThreadParams::m_stdDevValuePtr, and te::rp::Matrix< TemplateElementType >::reset().

Referenced by BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), te::rp::Contrast::execDecorrelationEnhancement(), and te::rp::PCAFusion::swapBandByHighResRaster().

TERPEXPORT bool te::rp::InversePrincipalComponents	(	const te::rst::Raster &	pcaRaster,
		const boost::numeric::ublas::matrix< double > &	pcaMatrix,
		te::rst::Raster &	outputRaster,
		const std::vector< unsigned int > &	outputRasterBands,
		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.
outputRasterBands	Output raster bands.
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 2612 of file src/terralib/rp/Functions.cpp.

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

Referenced by BOOST_AUTO_TEST_CASE(), te::rp::CreateRasterFileFromMatrix(), te::rp::Contrast::execDecorrelationEnhancement(), te::qt::widgets::PCAWizard::execute(), and te::rp::PCAFusion::execute().

TERPEXPORT bool te::rp::InverseWaveletAtrous	(	const te::rst::Raster &	waveletRaster,
		const unsigned int	levelsNumber,
		te::rst::Raster &	outputRaster,
		const std::vector< unsigned int > &	outputRasterBands
	)

Regenerate the original raster from its wavelets planes.

Parameters

waveletRaster	The input wavelet raster (with the same dimensions of outputRaster).
levelsNumber	The number of decomposed wavelet levels present inside the wavelet raster.
outputRaster	The regenerated output raster.
outputRasterBands	Output raster bands.

Returns

true if OK, false on errors.

Note

The band order of the expected wavelet levels: { [ band0-smoothed0, band0-wavelet0, ... , band0-smoothedN, band0-waveletN ], ... }

The number of bands of waveletRaster must be ( outputRasterBands.size() * 2 * levelsNumber ) at least.

Only the wavelet bands and the last smoothed band are used.

Definition at line 3546 of file src/terralib/rp/Functions.cpp.

References col, te::rst::Raster::getAccessPolicy(), te::rst::Raster::getBand(), te::rst::GetDataTypeRanges(), te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rst::Raster::getValue(), te::rst::BandProperty::m_type, nCols, te::common::RAccess, te::rst::Raster::setValue(), and te::common::WAccess.

Referenced by BOOST_AUTO_TEST_CASE(), and te::rp::CreateRasterFileFromMatrix().

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 867 of file src/terralib/rp/Functions.cpp.

References b, compose::bands, te::rst::RasterIterator< T >::begin(), te::rst::RasterIterator< T >::end(), te::rst::Raster::getBand(), te::rst::RasterIterator< T >::getColumn(), te::common::Singleton< RasterSummaryManager >::getInstance(), te::rst::Raster::getNumberOfBands(), te::rst::Band::getProperty(), te::rst::RasterIterator< T >::getRow(), te::rst::BandProperty::m_noDataValue, te::rst::Raster::setValue(), te::rst::SUMMARY_MAX, and te::rst::SUMMARY_MIN.

Referenced by te::qt::widgets::ComposeBandsWizard::executeCompose(), and te::qt::widgets::ComposeBandsWizard::executeDecompose().

TERPEXPORT te::rst::Raster * te::rp::NormalizeRaster

(

const te::rst::Raster *

inputRaster

)

Normalizes a raster in a given interval.

Parameters

inputRaster

The given raster.

Returns

a raster normalized.

Definition at line 920 of file src/terralib/rp/Functions.cpp.

References b, compose::bands, te::rst::RasterIterator< T >::begin(), te::rst::RasterIterator< T >::end(), te::rst::Raster::getBand(), te::rst::RasterIterator< T >::getColumn(), te::rst::Raster::getGrid(), te::common::Singleton< RasterSummaryManager >::getInstance(), te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::rst::Band::getProperty(), te::rst::RasterIterator< T >::getRow(), te::rst::Raster::getValue(), te::rst::BandProperty::m_noDataValue, te::rst::BandProperty::m_type, te::rst::RasterFactory::make(), te::rst::Raster::setValue(), te::rst::SUMMARY_MAX, te::rst::SUMMARY_MIN, and te::dt::UCHAR_TYPE.

TERPEXPORT bool te::rp::RasterSlicing	(	const te::rst::Raster &	inputRaster,
		const unsigned int	inputRasterBand,
		const bool	createPaletteRaster,
		const unsigned int	slicesNumber,
		const bool	eqHistogram,
		const std::map< std::string, std::string > &	rasterInfo,
		const std::string &	rasterType,
		const bool	enableProgress,
		std::vector< te::rst::BandProperty::ColorEntry > const *const	palettePtr,
		std::unique_ptr< te::rst::Raster > &	outRasterPtr,
		std::map< double, double >	limits
	)

Generate all wavelet planes from the given input raster.

Parameters

inputRaster	Input raster.
inputRasterBand	Input raster band.
createPaletteRaster	If true a paletted raster will be created instead of a multi-band raster..
slicesNumber	The number of histogram slices to create;
eqHistogram	If true, the input raster will be equalized before the slicing process.
rasterInfo	The output raster info (specific driver info).
rasterType	The output raster type (specific driver name - See te::rst::RasterFactory dictorary for more info).
enableProgress	Enable/disable the progress interface.
palettePtr	A pointer to an optional user given palette (if null, an fixed step pallete will be generated).
outRasterPtr	The output sliced raster pointer.
limits	slice limits values

Returns

true if OK, false on errors.

Definition at line 3787 of file src/terralib/rp/Functions.cpp.

References te::rst::BlueCInt, te::rst::BandProperty::ColorEntry::c1, te::rst::BandProperty::ColorEntry::c2, te::rst::BandProperty::ColorEntry::c3, col, te::rp::CreateFixedStepPalette(), te::rp::CreateNewRaster(), te::rp::Contrast::execute(), te::rst::Raster::getBand(), te::rp::GetDataTypeRange(), te::rst::Raster::getNumberOfBands(), te::rst::Band::getProperty(), te::rst::Band::getValue(), te::rst::GreenCInt, te::rp::Contrast::InputParameters::HistogramEqualizationContrastT, te::rp::Contrast::initialize(), te::rp::Contrast::OutputParameters::m_createdOutRasterDSType, te::rst::BandProperty::m_noDataValue, te::rp::Contrast::InputParameters::m_type, te::rst::BandProperty::m_type, nCols, te::rst::PaletteIdxCInt, te::rst::RedCInt, te::rst::RGBPalInt, te::rst::Band::setValue(), TERP_LOG_AND_RETURN_FALSE, TERP_TRUE_OR_RETURN_FALSE, te::dt::UCHAR_TYPE, te::dt::UINT16_TYPE, and te::dt::UINT32_TYPE.

Referenced by te::qt::widgets::RasterSlicingWizardPage::applyPreview(), BOOST_AUTO_TEST_CASE(), te::qt::widgets::RasterSlicingWizard::execute(), and te::rp::GetTPConvexHullArea().

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 std::vector< unsigned int > &	outputRasterBands,
		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).
outputRasterBands	Output raster bands.
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 2815 of file src/terralib/rp/Functions.cpp.

References col, te::rst::Raster::getAccessPolicy(), te::rst::Raster::getBand(), te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rst::GetDataTypeRanges(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rst::Raster::getNumberOfBands(), te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), te::common::GetPhysProcNumber(), te::rst::Band::getProperty(), te::rst::BandProperty::getType(), te::rst::Raster::getValue(), te::rst::BandProperty::m_blkh, te::rst::BandProperty::m_blkw, te::rp::RemapValuesThreadParams::m_inputRasterBandsPtr, te::rp::RemapValuesThreadParams::m_inputRasterPtr, te::rp::RemapValuesThreadParams::m_mutexPtr, te::rst::BandProperty::m_nblocksx, te::rst::BandProperty::m_nblocksy, te::rst::BandProperty::m_noDataValue, te::rp::RemapValuesThreadParams::m_outputRasterBandsPtr, te::rp::RemapValuesThreadParams::m_outputRasterPtr, te::rp::RemapValuesThreadParams::m_rasterBlocksStatusPtr, te::rp::RemapValuesThreadParams::m_remapMatrixPtr, te::rp::RemapValuesThreadParams::m_returnStatus, nCols, te::common::RAccess, te::rp::RemapValuesThread(), te::rp::Matrix< TemplateElementType >::reset(), te::rst::Raster::setValue(), and te::common::WAccess.

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

TERPEXPORT void te::rp::SaveSensorParams

(

std::map< std::string, SpectralSensorParams > &

params

)

Saves in SpectralSensor.json file the spectral sensors parameters.

Definition at line 721 of file src/terralib/rp/Functions.cpp.

References te::rp::GetSensorFilename().

Referenced by te::rp::CreateRasterFileFromMatrix(), te::qt::widgets::SensorManagerDialog::onOkPushButtonClicked(), and te::qt::widgets::SensorManagerDialog::onSavePushButtonClicked().