A raster band description. More...
#include <Band.h>
Public Member Functions | |
Band (BandProperty *p, std::size_t idx) | |
Constructor. More... | |
Band & | callOperator (std::complex< double >(*f)(std::complex< double >, std::complex< double >), Band &rhs) |
It calls a parameter function f to apply in all pixels from two bands, e.g. pixel = f(lhs, rhs);. More... | |
Band & | callOperator (std::complex< double >(*f)(std::complex< double >, std::complex< double >), std::complex< double > &cvalue) |
It calls a parameter function f to apply in all pixels from the band, e.g. pixel = f(lhs, rhs);. More... | |
virtual int | getBlockSize () const |
It returns the number of bytes ocuppied by a data block. More... | |
virtual std::map< double, unsigned > | getHistogramI (unsigned int rs=0, unsigned int cs=0, unsigned int rf=0, unsigned int cf=0, unsigned int b=0) const |
It computes and returns the histogram occurring values (imaginary part) in a window of the band. More... | |
virtual std::map< double, unsigned > | getHistogramR (unsigned int rs=0, unsigned int cs=0, unsigned int rf=0, unsigned int cf=0, unsigned int b=0) const |
It computes and returns the histogram occurring values (real part) in a window of the band. More... | |
virtual void | getIValue (unsigned int c, unsigned int r, double &value) const =0 |
Returns the imaginary attribute value in a complex band of a cell. More... | |
virtual std::complex< double > | getMaxValue (bool readall=false, unsigned int rs=0, unsigned int cs=0, unsigned int rf=0, unsigned int cf=0) const |
It computes and returns the maximum occurring value in a window of the band. More... | |
virtual std::complex< double > | getMeanValue (unsigned int rs=0, unsigned int cs=0, unsigned int rf=0, unsigned int cf=0) const |
It computes and returns the mean of the occurring values in a window of the band. More... | |
virtual std::complex< double > | getMinValue (bool readall=false, unsigned int rs=0, unsigned int cs=0, unsigned int rf=0, unsigned int cf=0) const |
It computes and returns the minimum occurring value in a window of the band. More... | |
std::complex< double > | getOffsetValue () const |
It returns the offset values (real and imaginary) to be applied to the band. More... | |
BandProperty * | getProperty () |
Returns the band property. More... | |
const BandProperty * | getProperty () const |
Returns the band property. More... | |
virtual Raster * | getRaster () const =0 |
Returns the associated raster. More... | |
std::complex< double > | getScaleValue () const |
It returns the scale values (real and imaginary) to be applied to the band. More... | |
virtual std::complex< double > | getStdValue (unsigned int rs=0, unsigned int cs=0, unsigned int rf=0, unsigned int cf=0) const |
It computes and returns the standard deviation of the occurring values in a window of the band. More... | |
virtual void | getValue (unsigned int c, unsigned int r, double &value) const =0 |
Returns the cell attribute value. More... | |
virtual void | getValue (unsigned int c, unsigned int r, std::complex< double > &value) const |
Returns the imaginary attribute value in a complex band of a cell. More... | |
virtual Band & | operator*= (Band &rhs) |
It returns the band product (pixel by pixel). More... | |
virtual Band & | operator*= (std::complex< double > &cvalue) |
It returns the product of a constant value to all pixels in the band. More... | |
virtual Band & | operator+= (Band &rhs) |
It returns the band sum (pixel by pixel). More... | |
virtual Band & | operator+= (std::complex< double > &cvalue) |
It returns the sum of a constant value to all pixels in the band. More... | |
virtual Band & | operator-= (Band &rhs) |
It returns the band subtraction (pixel by pixel). More... | |
virtual Band & | operator-= (std::complex< double > &cvalue) |
It returns the difference from all pixels in the band to a constant value (pixel - constant). More... | |
virtual Band & | operator/= (Band &rhs) |
It returns the band division (pixel by pixel). More... | |
virtual Band & | operator/= (std::complex< double > &cvalue) |
It returns the division of all pixels in the band by a constant value (pixel / constant). More... | |
virtual Band & | operator= (const Band &rhs) |
Assignment operator. More... | |
virtual void | read (int x, int y, void *buffer) const =0 |
It reads a data block to the specified buffer. More... | |
virtual void * | read (int x, int y)=0 |
It reads and returns a data block. More... | |
virtual void | setIValue (unsigned int c, unsigned int r, const double value)=0 |
Sets the imaginary attribute value in a complex band of a cell. More... | |
void | setOffsetValue (const std::complex< double > o) |
Sets the offset values (real and imaginary) to be applied to the band. More... | |
void | setScaleValue (const std::complex< double > s) |
Sets the scale values (real and imaginary) to be applied to the band. More... | |
virtual void | setValue (unsigned int c, unsigned int r, const double value)=0 |
Sets the cell attribute value. More... | |
virtual void | setValue (unsigned int c, unsigned int r, const std::complex< double > &value) |
Sets the imaginary attribute value in a complex band of a cell. More... | |
virtual void | write (int x, int y, void *buffer)=0 |
It writes a data block from the specified buffer. More... | |
virtual | ~Band () |
Virtual destructor. More... | |
Protected Member Functions | |
Band (const Band &rhs) | |
Copy constructor. More... | |
Protected Attributes | |
std::size_t | m_idx |
The band index. More... | |
BandProperty * | m_property |
The band information. More... | |
A raster band description.
The raster band describes how to interpret (and use) values that can be associated to each element of a raster, in one given dimension (e.g. a band of multi-hiperspectral remote sensing image). Each instance of this class refers to a particular dimension. This implementation defines a set of information commonly used to describe any raster.
te::rst::Band::Band | ( | BandProperty * | p, |
std::size_t | idx | ||
) |
|
virtual |
Virtual destructor.
Reimplemented in te::gdal::Band, te::mem::Band, te::grib::Band, and terralib4::Band.
|
protected |
Copy constructor.
rhs | The right-hand-side copy used to copy from. |
Definition at line 652 of file Band.cpp.
References m_property.
te::rst::Band & te::rst::Band::callOperator | ( | std::complex< double >(*)(std::complex< double >, std::complex< double >) | f, |
Band & | rhs | ||
) |
It calls a parameter function f to apply in all pixels from two bands, e.g. pixel = f(lhs, rhs);.
(*f) | a function with the signature complex<double>(*f)(complex<double>, complex<double>) |
rhs | The rhs band to apply the function. |
Definition at line 447 of file Band.cpp.
References te::rst::Raster::getNumberOfColumns(), te::rst::Raster::getNumberOfRows(), getProperty(), getRaster(), getValue(), te::rst::BandProperty::m_noDataValue, te::common::RWAccess, and te::common::WAccess.
te::rst::Band & te::rst::Band::callOperator | ( | std::complex< double >(*)(std::complex< double >, std::complex< double >) | f, |
std::complex< double > & | cvalue | ||
) |
It calls a parameter function f to apply in all pixels from the band, e.g. pixel = f(lhs, rhs);.
(*f) | a function with the signature complex<double>(*f)(complex<double>, complex<double>) |
cvalue | The constant value that will work with the generic function. |
Definition at line 517 of file Band.cpp.
References te::common::RWAccess, and te::common::WAccess.
|
virtual |
It returns the number of bytes ocuppied by a data block.
Reimplemented in te::mem::Band.
Definition at line 639 of file Band.cpp.
References te::rst::GetPixelSize().
Referenced by te::gdal::Band::Band(), te::rst::BandIteratorWindow< T >::BandIteratorWindow(), te::rp::Blender::blendIntoRaster1(), te::mem::CachedBand::CachedBand(), te::rst::Copy(), te::rp::Segmenter::execute(), te::rp::GetCovarianceValueThread(), te::rp::GetMeanValueThread(), te::rp::GetStdDevValueThread(), te::rst::SynchronizedBandBlocksManager::initialize(), te::gdal::Band::operator=(), te::rp::Contrast::remapBandLevels(), te::rp::RemapValuesThread(), te::rst::SynchronizedBand::SynchronizedBand(), and te::mem::TiledBand::TiledBand().
|
virtual |
It computes and returns the histogram occurring values (imaginary part) in a window of the band.
rs | The starting row. |
cs | The starting column. |
rf | The final row. |
cf | The final column. |
b | The number of bins (intervals from minimum pixel to maximum). When b = 0, the histogram will be divided according to all pixel values. |
Definition at line 343 of file Band.cpp.
Referenced by te::rst::RasterSummaryManager::get().
|
virtual |
It computes and returns the histogram occurring values (real part) in a window of the band.
rs | The starting row. |
cs | The starting column. |
rf | The final row. |
cf | The final column. |
b | The number of bins (intervals from minimum pixel to maximum). When b = 0, the histogram will be divided according to all pixel values. |
Definition at line 260 of file Band.cpp.
Referenced by te::rst::RasterSummaryManager::get().
|
pure virtual |
Returns the imaginary attribute value in a complex band of a cell.
c | The column location of the cell. |
r | The row location of the cell. |
value | The attribute value to be assigned. |
Exception | Subclasses may throw an exception if the data value can not be read. |
Implemented in te::gdal::Band, te::idl::IdlBand, te::mem::ExpansibleBand, te::mem::CachedBand, te::rst::SynchronizedBand, te::mem::Band, te::grib::Band, te::mem::TiledBand, and terralib4::Band.
|
virtual |
It computes and returns the maximum occurring value in a window of the band.
readall | Force the reading the entire image (can be slow). If false, will read up to 1000 pixels of the image, equally spaced. |
rs | The starting row. |
cs | The starting column. |
rf | The final row. |
cf | The final column. |
Definition at line 139 of file Band.cpp.
References te::rst::PointSetIterator< T >::begin(), te::rst::PointSetIterator< T >::end(), te::rst::PointSetIterator< T >::getColumn(), te::rst::GetRandomPointsInRaster(), and te::rst::PointSetIterator< T >::getRow().
Referenced by te::rst::RasterSummaryManager::get(), and te::rp::NormalizeRaster().
|
virtual |
It computes and returns the mean of the occurring values in a window of the band.
rs | The starting row. |
cs | The starting column. |
rf | The final row. |
cf | The final column. |
Definition at line 231 of file Band.cpp.
Referenced by te::rst::RasterSummaryManager::get().
|
virtual |
It computes and returns the minimum occurring value in a window of the band.
readall | Force the reading the entire image (can be slow). If false, will read up to 1000 pixels of the image, equally spaced. |
rs | The starting row. |
cs | The starting column. |
rf | The final row. |
cf | The final column. |
Definition at line 82 of file Band.cpp.
References te::rst::PointSetIterator< T >::begin(), te::rst::PointSetIterator< T >::end(), te::rst::PointSetIterator< T >::getColumn(), te::rst::GetRandomPointsInRaster(), and te::rst::PointSetIterator< T >::getRow().
Referenced by te::rst::RasterSummaryManager::get(), and te::rp::NormalizeRaster().
std::complex< double > te::rst::Band::getOffsetValue | ( | ) | const |
te::rst::BandProperty * te::rst::Band::getProperty | ( | ) |
Returns the band property.
Definition at line 437 of file Band.cpp.
Referenced by te::rst::AbstractBandIterator< T >::AbstractBandIterator(), te::mem::ExpansibleRaster::addTopBands(), te::rst::BandIteratorWindow< T >::BandIteratorWindow(), te::rp::Blender::blendIntoRaster1(), te::rp::Blender::blendIntoRaster1Thread(), te::qt::widgets::ColorTransformWizard::buildOutputRaster(), te::mem::CachedBand::CachedBand(), te::rp::GeoMosaic::calcBandStatistics(), te::rp::TiePointsMosaic::calcBandStatistics(), te::rp::SequenceMosaic::calcBandStatistics(), callOperator(), te::rp::ConvertIHS2RGB(), te::rp::ConvertRGB2IHS(), te::rst::Copy(), te::rp::Copy2DiskRaster(), te::tools::rastermanager::RasterManager::copyRaster(), te::mem::Raster::create(), te::rst::CreateCopy(), te::rp::Segmenter::createCutOffLinesTiff(), te::rp::SequenceMosaic::createDiskRasterCopy(), te::rp::SequenceMosaic::createRasterDataSet(), te::rst::CropRaster(), te::rp::DecomposeBands(), te::rp::Filter::DilationFilter(), te::mem::ExpansibleRaster::dummyFillAllBlocks(), te::rst::BandIteratorWindow< T >::end(), te::rst::BandIterator< T >::end(), te::rst::ConstBandIterator< T >::end(), te::rst::BandIteratorWithMask< T >::end(), te::rp::Filter::ErosionFilter(), te::rp::ArithmeticOperations::execBinaryOperatorRasterXRaster(), te::rp::ArithmeticOperations::execBinaryOperatorRasterXReal(), te::rp::Contrast::execDecorrelationEnhancement(), 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::GeoMosaic::execute(), te::rp::Register::execute(), te::rp::ArithmeticOperations::execute(), te::rp::Filter::execute(), te::rp::TiePointsMosaic::execute(), te::rp::WisperFusion::execute(), te::rp::Skeleton::execute(), te::rp::SequenceMosaic::execute(), te::rp::Segmenter::execute(), te::rp::Contrast::execute(), te::rp::GetCovarianceValue(), te::rp::GetCovarianceValueThread(), te::map::GetExtentRaster(), te::rp::RasterAttributes::getGLCM(), te::rp::GetMeanValue(), te::rp::GetMeanValueThread(), te::tools::rastermanager::RasterManager::getRasterInfo(), te::rp::IHSFusion::getRGBRange(), te::map::RasterLayer::getSchema(), te::rp::GetStdDevValue(), te::rp::GetStdDevValueThread(), te::rst::SynchronizedBandBlocksManager::initialize(), te::mem::CachedBandBlocksManager::initialize(), te::rp::Blender::initialize(), te::rst::Interpolator::initialize(), te::rp::InverseWaveletAtrous(), te::rp::IHSFusion::loadIHSData(), te::rp::PCAFusion::loadRessampledRaster(), te::rp::Filter::MeanFilter(), te::rp::Filter::MedianFilter(), te::rp::Filter::ModeFilter(), te::mem::Raster::open(), te::rp::RasterResample(), te::rst::RasterSynchronizer::RasterSynchronizer(), te::rp::Contrast::remapBandLevels(), te::rp::RemapValues(), te::rp::RemapValuesThread(), te::rst::Reproject(), te::rp::Filter::RobertsFilter(), te::serialize::xml::Save(), te::rp::IHSFusion::saveIHSData(), te::qt::widgets::LayerPropertiesInfo::setLayerRasterProperties(), te::rp::Filter::SobelFilter(), te::rp::PCAFusion::swapBandByHighResRaster(), te::rst::SynchronizedBand::SynchronizedBand(), te::mem::CachedBandBlocksManager::threadEntry(), te::rp::Filter::UserDefinedFilter(), and te::rst::Vectorizer::Vectorizer().
const te::rst::BandProperty * te::rst::Band::getProperty | ( | ) | const |
|
pure virtual |
Returns the associated raster.
Implemented in te::gdal::Band, te::idl::IdlBand, te::mem::ExpansibleBand, te::mem::CachedBand, te::rst::SynchronizedBand, te::mem::Band, te::grib::Band, te::mem::TiledBand, and terralib4::Band.
Referenced by te::rst::AbstractBandIterator< T >::AbstractBandIterator(), te::rst::BandIteratorWindow< T >::BandIteratorWindow(), callOperator(), te::rst::Copy(), te::rp::Contrast::execSetMeanAndStdContrast(), te::rst::FillBand(), and te::rst::Raster::rasterize().
std::complex< double > te::rst::Band::getScaleValue | ( | ) | const |
|
virtual |
It computes and returns the standard deviation of the occurring values in a window of the band.
rs | The starting row. |
cs | The starting column. |
rf | The final row. |
cf | The final column. |
Definition at line 196 of file Band.cpp.
Referenced by te::rst::RasterSummaryManager::get().
|
pure virtual |
Returns the cell attribute value.
c | The column location of the cell. |
r | The row location of the cell. |
value | To return the attribute value. |
Exception | Subclasses may throw an exception if the data value can not be read. |
Implemented in te::gdal::Band, te::idl::IdlBand, te::mem::ExpansibleBand, te::mem::CachedBand, te::rst::SynchronizedBand, te::mem::Band, te::grib::Band, te::mem::TiledBand, and terralib4::Band.
Referenced by te::rp::GeoMosaic::calcBandStatistics(), te::rp::TiePointsMosaic::calcBandStatistics(), te::rp::SequenceMosaic::calcBandStatistics(), callOperator(), te::rp::ConvertIHS2RGB(), te::rp::ConvertRGB2IHS(), te::rst::Copy(), te::rp::Copy2DiskRaster(), te::rp::SequenceMosaic::createDiskRasterCopy(), te::rp::SequenceMosaic::createRasterDataSet(), te::rp::DecomposeBands(), te::rp::DirectWaveletAtrous(), te::rp::ArithmeticOperations::execBinaryOperatorRasterXRaster(), te::rp::ArithmeticOperations::execBinaryOperatorRasterXReal(), te::rp::Contrast::execSetMeanAndStdContrast(), te::rp::GeoMosaic::execute(), te::rp::TiePointsMosaic::execute(), te::rp::SequenceMosaic::execute(), te::rp::Segmenter::execute(), te::rp::GetCovarianceValue(), te::rp::IHSFusion::getRGBRange(), te::gdal::Band::getValue(), te::rp::Skeleton::loadData(), te::rp::TiePointsLocatorStrategy::loadRasterData(), te::rp::Contrast::remapBandLevels(), te::rp::Filter::RobertsFilter(), te::rp::Filter::SobelFilter(), te::rp::PCAFusion::swapBandByHighResRaster(), and te::rp::IHSFusion::swapIntensity().
|
virtual |
Returns the imaginary attribute value in a complex band of a cell.
c | The column location of the cell. |
r | The row location of the cell. |
value | The complex attribute value to be assigned (real, imaginary). |
Exception | Subclasses may throw an exception if the data value can not be read. |
Reimplemented in te::gdal::Band.
|
virtual |
It returns the band product (pixel by pixel).
rhs | The band to be multiplied, right-hand side. |
Definition at line 624 of file Band.cpp.
References times().
|
virtual |
It returns the product of a constant value to all pixels in the band.
cvalue | The constant value to be multiplied. |
Definition at line 619 of file Band.cpp.
References times().
|
virtual |
It returns the band sum (pixel by pixel).
rhs | The band to be added, right-hand side. |
Definition at line 599 of file Band.cpp.
References plus().
|
virtual |
It returns the sum of a constant value to all pixels in the band.
cvalue | The constant value to be added. |
Definition at line 604 of file Band.cpp.
References plus().
|
virtual |
It returns the band subtraction (pixel by pixel).
rhs | The band to be subtracted, right-hand side. |
Definition at line 609 of file Band.cpp.
References minus().
|
virtual |
It returns the difference from all pixels in the band to a constant value (pixel - constant).
cvalue | The constant value to be subtracted. |
Definition at line 614 of file Band.cpp.
References minus().
|
virtual |
It returns the band division (pixel by pixel).
rhs | The band to be divided, right-hand side. |
Definition at line 629 of file Band.cpp.
References divide().
|
virtual |
It returns the division of all pixels in the band by a constant value (pixel / constant).
cvalue | The constant value to be divided. |
Definition at line 634 of file Band.cpp.
References divide().
|
virtual |
Assignment operator.
rhs | The right-hand-side copy used to copy from. |
Definition at line 48 of file Band.cpp.
References m_idx, and m_property.
Referenced by te::mem::TiledBand::operator=(), te::mem::Band::operator=(), and te::gdal::Band::operator=().
|
pure virtual |
It reads a data block to the specified buffer.
x | The block-id in x (or x-offset). |
y | The block-id in y (or y-offset). |
buffer | The buffer to be used to read from the band. |
Implemented in te::gdal::Band, te::idl::IdlBand, te::mem::ExpansibleBand, te::mem::CachedBand, te::rst::SynchronizedBand, te::mem::Band, te::grib::Band, te::mem::TiledBand, and terralib4::Band.
Referenced by te::rst::Copy(), te::rp::GetCovarianceValueThread(), te::rp::GetMeanValueThread(), te::rp::GetStdDevValueThread(), te::rp::Contrast::remapBandLevels(), and te::rp::RemapValuesThread().
|
pure virtual |
It reads and returns a data block.
x | The block-id in x (or x-offset). |
y | The block-id in y (or y-offset). |
Implemented in te::gdal::Band, te::idl::IdlBand, te::mem::ExpansibleBand, te::mem::CachedBand, te::rst::SynchronizedBand, te::mem::Band, te::grib::Band, te::mem::TiledBand, and terralib4::Band.
|
pure virtual |
Sets the imaginary attribute value in a complex band of a cell.
c | The column location of the cell. |
r | The row location of the cell. |
value | The attribute value to be assigned. |
Exception | Subclasses may throw an exception if the data value can not be write. |
Implemented in te::gdal::Band, te::idl::IdlBand, te::mem::ExpansibleBand, te::mem::CachedBand, te::rst::SynchronizedBand, te::mem::Band, te::grib::Band, te::mem::TiledBand, and terralib4::Band.
void te::rst::Band::setOffsetValue | ( | const std::complex< double > | o | ) |
void te::rst::Band::setScaleValue | ( | const std::complex< double > | s | ) |
|
pure virtual |
Sets the cell attribute value.
c | The column location of the cell. |
r | The row location of the cell. |
value | The attribute value to be assigned. |
Exception | Subclasses may throw an exception if the data value can not be write. |
Implemented in te::gdal::Band, te::idl::IdlBand, te::mem::ExpansibleBand, te::mem::CachedBand, te::rst::SynchronizedBand, te::mem::Band, te::grib::Band, te::mem::TiledBand, and terralib4::Band.
Referenced by te::rp::ComposeBands(), te::rp::ConvertIHS2RGB(), te::rst::Copy(), te::rp::Copy2DiskRaster(), te::rp::SequenceMosaic::createDiskRasterCopy(), te::rp::SequenceMosaic::createRasterDataSet(), te::rp::DecomposeBands(), te::rp::DirectWaveletAtrous(), te::rp::ArithmeticOperations::execBinaryOperatorRasterXRaster(), te::rp::ArithmeticOperations::execBinaryOperatorRasterXReal(), te::rp::Contrast::execHistogramEqualizationContrast(), te::rp::Contrast::execSetMeanAndStdContrast(), te::rp::GeoMosaic::execute(), te::rp::Register::execute(), te::rp::TiePointsMosaic::execute(), te::rp::SequenceMosaic::execute(), te::rp::Segmenter::execute(), te::rst::FillBand(), te::rp::RasterResample(), te::rp::Contrast::remapBandLevels(), te::rp::Filter::RobertsFilter(), te::rp::IHSFusion::saveIHSData(), te::gdal::Band::setValue(), and te::rp::Filter::SobelFilter().
|
virtual |
Sets the imaginary attribute value in a complex band of a cell.
c | The column location of the cell. |
r | The row location of the cell. |
value | The complex attribute value to be assigned (real, imaginary). |
Exception | Subclasses may throw an exception if the data value can not be write. |
Reimplemented in te::gdal::Band.
|
pure virtual |
It writes a data block from the specified buffer.
x | The block-id in x (or x-offset). |
y | The block-id in y (or y-offset). |
buffer | The buffer to be used to write to the band. |
Implemented in te::gdal::Band, te::idl::IdlBand, te::mem::ExpansibleBand, te::mem::CachedBand, te::rst::SynchronizedBand, te::mem::Band, te::grib::Band, te::mem::TiledBand, and terralib4::Band.
Referenced by te::rst::Copy(), te::rp::Contrast::remapBandLevels(), and te::rp::RemapValuesThread().
|
protected |
The band index.
Definition at line 475 of file Band.h.
Referenced by operator=(), and te::gdal::Band::read().
|
protected |
The band information.
Definition at line 474 of file Band.h.
Referenced by te::grib::Band::Band(), te::mem::Band::Band(), te::gdal::Band::Band(), Band(), te::mem::ExpansibleBand::ExpansibleBand(), te::idl::IdlBand::IdlBand(), te::gdal::Band::operator=(), operator=(), te::rst::SynchronizedBand::SynchronizedBand(), and te::mem::TiledBand::TiledBand().