te::rst::SynchronizedRaster Class Reference

An adapter class to allow concurrent access to raster data by multiple threads. More...

#include <SynchronizedRaster.h>

Inheritance diagram for te::rst::SynchronizedRaster:
te::rst::Raster te::dt::AbstractData

Public Member Functions

RastercallOperator (std::complex< double >(*f)(std::complex< double >, std::complex< double >), const Raster &rhs)
 It calls a parameter function f to apply in all pixels from two rasters, e.g. pixel = f(lhs, rhs);. More...
 
virtual Rasterclip (const std::vector< te::gm::Geometry const *> geometries, const std::map< std::string, std::string > &rinfo, const std::string &rType) const
 Subsetting operation for clipping the raster. More...
 
te::dt::AbstractDataclone () const
 It returns a clone of this object. More...
 
bool createMultiResolution (const unsigned int levels, const InterpolationMethod interpMethod)
 Create a sub-sampled multi-resolution pyramid. More...
 
te::common::AccessPolicy getAccessPolicy () const
 Returns the raster access policy. More...
 
const te::rst::BandgetBand (std::size_t i) const
 Returns the raster i-th band. More...
 
te::rst::BandgetBand (std::size_t i)
 Returns the raster i-th band. More...
 
int getBandDataType (std::size_t i) const
 Returns the data type in a particular band (or dimension). More...
 
te::gm::EnvelopegetExtent ()
 Returns the geographic extension of the raster data. More...
 
const te::gm::EnvelopegetExtent () const
 Returns the geographic extension of the raster data. More...
 
te::gm::EnvelopegetExtent (int srid, te::gm::Envelope *roi=0) const
 Returns the geographic extension of the raster data, in a given SRS (distinct from its original one). More...
 
GridgetGrid ()
 It returns the raster grid. More...
 
const GridgetGrid () const
 It returns the raster grid. More...
 
std::map< std::string, std::string > getInfo () const
 It returns additional information about the raster. More...
 
virtual void getIValue (unsigned int c, unsigned int r, double &value, std::size_t b=0) const
 Returns the imaginary attribute value in a complex band of a cell. More...
 
RastergetMultiResLevel (const unsigned int level) const
 Returns the required level of a multi-resolution pyramid or NULL if that level does not exists. More...
 
unsigned int getMultiResLevelsCount () const
 Returns the current number of multi-resolution pyramid levels. More...
 
const std::string & getName () const
 Returns the raster name. More...
 
std::size_t getNumberOfBands () const
 Returns the number of bands (dimension of cells attribute values) in the raster. More...
 
unsigned int getNumberOfColumns () const
 Returns the raster number of columns. More...
 
unsigned int getNumberOfRows () const
 Returns the raster number of rows. More...
 
GridgetResampledGrid (int scale) const
 Return the raster grid for a specific scale. More...
 
double getResolutionX () const
 Returns the raster horizontal (x-axis) resolution. More...
 
double getResolutionY () const
 Returns the raster vertical (y-axis) resolution. More...
 
int getSRID () const
 Returns the raster spatial reference system identifier. More...
 
int getTypeCode () const
 It returns the data type code associated to the data value. More...
 
virtual void getValue (unsigned int c, unsigned int r, double &value, std::size_t b=0) const
 Returns the attribute value of a band of a cell. More...
 
virtual void getValue (unsigned int c, unsigned int r, std::complex< double > &value, std::size_t b=0) const
 Returns the imaginary attribute value in a complex band of a cell. More...
 
virtual void getValues (unsigned int c, unsigned int r, std::vector< double > &values) const
 Returns the imaginary attribute values in all complex bands of a cell. More...
 
virtual void getValues (unsigned int c, unsigned int r, std::vector< std::complex< double > > &values) const
 Returns the imaginary attribute values in all complex bands of a cell. More...
 
virtual Rasteroperator*= (Raster &rhs)
 It returns the raster product (pixel by pixel). More...
 
virtual Rasteroperator*= (std::complex< double > &cvalue)
 It returns the product of a constant value to all pixels in the raster. More...
 
virtual Rasteroperator+= (Raster &rhs)
 It returns the raster sum (pixel by pixel). More...
 
virtual Rasteroperator+= (std::complex< double > &cvalue)
 It returns the sum of a constant value to all pixels in the raster. More...
 
virtual Rasteroperator-= (Raster &rhs)
 It returns the raster subtraction (pixel by pixel). More...
 
virtual Rasteroperator-= (std::complex< double > &cvalue)
 It returns the difference from all pixels in the raster to a constant value (pixels - constant). More...
 
virtual Rasteroperator/= (Raster &rhs)
 It returns the raster division (pixel by pixel). More...
 
virtual Rasteroperator/= (std::complex< double > &cvalue)
 It returns the division of all pixels in the raster by a constant value (pixels / constant). More...
 
const te::rst::Bandoperator[] (std::size_t i) const
 Access band in i position. More...
 
te::rst::Bandoperator[] (std::size_t i)
 Access band in i position. More...
 
virtual void rasterize (std::vector< te::gm::Geometry *> g, std::vector< double > vp, std::size_t b=0)
 Rasterizes a given vector of geometries. More...
 
bool removeMultiResolution ()
 Remove/Destroy a sub-sampled multi-resolution pyramid, if there is one. More...
 
virtual Rasterresample (int method, unsigned int drow, unsigned int dcolumn, unsigned int height, unsigned int width, unsigned int newheight, unsigned int newwidth, const std::map< std::string, std::string > &rinfo) const
 Resample a subset of the raster, given a box. More...
 
virtual Rasterresample (int method, int scale, const std::map< std::string, std::string > &rinfo) const
 Resample raster. More...
 
void setAccessPolicy (te::common::AccessPolicy p)
 Sets the raster access policy. More...
 
virtual void setIValue (unsigned int c, unsigned int r, const double value, std::size_t b=0)
 Sets the imaginary attribute value in a complex band of a cell. More...
 
void setName (const std::string name)
 Sets the raster name. More...
 
virtual void setValue (unsigned int c, unsigned int r, const double value, std::size_t b=0)
 Sets the attribute value in a band of a cell. More...
 
virtual void setValue (unsigned int c, unsigned int r, const std::complex< double > &value, std::size_t b=0)
 Sets the imaginary attribute value in a complex band of a cell. More...
 
virtual void setValues (unsigned int c, unsigned int r, const std::vector< double > &values)
 Sets the imaginary attribute values in all complex bands of a cell. More...
 
virtual void setValues (unsigned int c, unsigned int r, const std::vector< std::complex< double > > &values)
 Sets the imaginary attribute values in all complex bands of a cell. More...
 
 SynchronizedRaster (RasterSynchronizer &sync, const unsigned char maxMemPercentUsed)
 Constructor. More...
 
 SynchronizedRaster (const unsigned int maxNumberOfCacheBlocks, RasterSynchronizer &sync)
 Constructor. More...
 
std::string toString (void) const
 It returns the data value in a string notation. More...
 
virtual Rastertransform (int srid, const std::map< std::string, std::string > &rinfo, int m=1) const
 Reprojects this raster to a distinct SRS. This method reprojects this raster to a distinct SRS. The output resolution is calculated in order to maintain the same number of pixels as in this raster. More...
 
virtual Rastertransform (int srid, double llx, double lly, double urx, double ury, const std::map< std::string, std::string > &rinfo, int m=1) const
 Reprojects a squared portion of this raster to a distinct SRS. This method reprojects a squared portion of this raster to a distinct SRS. The output resolution is calculated in order to maintain the same number of pixels as in the desired portion of this raster. More...
 
virtual Rastertransform (int srid, double llx, double lly, double urx, double ury, double resx, double resy, const std::map< std::string, std::string > &rinfo, int m=1) const
 Reprojects a squared portion of this raster to another SRS with a desired resolution. More...
 
virtual Rastertrim (const te::gm::Envelope *env, const std::map< std::string, std::string > &rinfo) const
 Subsetting operation for trimming (cropping) the raster. More...
 
virtual void vectorize (std::vector< te::gm::Geometry *> &g, std::size_t b, unsigned int mp=0, std::vector< double > *const polygonsValues=0)
 Vectorizes a given raster band, using GDALPolygonize function. More...
 
 ~SynchronizedRaster ()
 

Protected Member Functions

double applyScale (int i, const double &v) const
 Scales a value according to a specific resampling scale. More...
 
void free ()
 Free all allocated internal resources and go back to the initial state. More...
 

Protected Attributes

std::vector< SynchronizedBand *> m_bands
 Internal raster bands. More...
 
SynchronizedBandBlocksManager m_blocksManager
 Internal blocks manager. More...
 
Gridm_grid
 The spatial support for raster data. More...
 
std::string m_name
 The raster name. More...
 
te::common::AccessPolicy m_policy
 The access policy, can be te::common::{NoAccess, RAccess, RWAccess, WAccess}. More...
 

Private Member Functions

void open (const std::map< std::string, std::string > &rinfo, te::common::AccessPolicy p=te::common::RAccess)
 Opens a raster. More...
 
 SynchronizedRaster ()
 
 SynchronizedRaster (te::rst::Grid *grid, te::common::AccessPolicy p=te::common::RAccess)
 

Detailed Description

An adapter class to allow concurrent access to raster data by multiple threads.

Note
One unique RasterSynchronizer must be instantiated on the main process. That RasterSynchronizer is used by each thread to instantiate multiple SynchronizedRaster instances.
More efficient access can be achieved by following the bands internal blocking scheme.

Definition at line 51 of file SynchronizedRaster.h.

Constructor & Destructor Documentation

◆ SynchronizedRaster() [1/4]

te::rst::SynchronizedRaster::SynchronizedRaster ( RasterSynchronizer sync,
const unsigned char  maxMemPercentUsed 
)

Constructor.

Parameters
syncThe raster synchronizer instance.
maxMemPercentUsedThe maximum free memory percentual to use valid range: [1:100].
Note
For the case where using the write raster access policy: The use of multiple cached blocks can cause deadlocks if multiple threads are locking blocks needed by other threads, use it with caution!

◆ SynchronizedRaster() [2/4]

te::rst::SynchronizedRaster::SynchronizedRaster ( const unsigned int  maxNumberOfCacheBlocks,
RasterSynchronizer sync 
)

Constructor.

Parameters
syncThe raster synchronizer instance.
maxNumberOfCacheBlocksThe maximum number of cache blocks.
Note
For the case where using the write raster access policy: The use of multiple cached blocks can cause deadlocks if multiple threads are locking blocks needed by other threads, use it with caution!

◆ ~SynchronizedRaster()

te::rst::SynchronizedRaster::~SynchronizedRaster ( )

◆ SynchronizedRaster() [3/4]

te::rst::SynchronizedRaster::SynchronizedRaster ( )
private

◆ SynchronizedRaster() [4/4]

te::rst::SynchronizedRaster::SynchronizedRaster ( te::rst::Grid grid,
te::common::AccessPolicy  p = te::common::RAccess 
)
private

Member Function Documentation

◆ applyScale()

double te::rst::Raster::applyScale ( int  i,
const double &  v 
) const
protectedinherited

Scales a value according to a specific resampling scale.

Parameters
iThe scale to apply.
vThe value to be scaled.
Returns
The scaled value.

◆ callOperator()

Raster& te::rst::Raster::callOperator ( std::complex< double >(*)(std::complex< double >, std::complex< double >)  f,
const Raster rhs 
)
inherited

It calls a parameter function f to apply in all pixels from two rasters, e.g. pixel = f(lhs, rhs);.

Parameters
(*f)a function with the signature complex<double>(*f)(complex<double>, complex<double>), const Raster& rhs)
rhsThe rhs raster to apply the function.
Returns
The resultant raster.

◆ clip()

virtual Raster* te::rst::Raster::clip ( const std::vector< te::gm::Geometry const *>  geometries,
const std::map< std::string, std::string > &  rinfo,
const std::string &  rType 
) const
virtualinherited

Subsetting operation for clipping the raster.

Parameters
geometriesA vector of pointers to valid geometries.
rinfoThe parameters needed to build the output raster (see RasterFactory documentation).
rTypeThe name of the specific driver to create the raster.
Returns
A pointer to the trimmed raster if success and a null pointer otherwise.
Note
The caller will take the ownership of the returned pointer.
Accepted geometry types: te::gm::Polygon, te::gm::MultiPolygon

◆ clone()

te::dt::AbstractData* te::rst::SynchronizedRaster::clone ( ) const
virtual

It returns a clone of this object.

Returns
A clone of this object.

Implements te::dt::AbstractData.

◆ createMultiResolution()

bool te::rst::SynchronizedRaster::createMultiResolution ( const unsigned int  levels,
const InterpolationMethod  interpMethod 
)
inlinevirtual

Create a sub-sampled multi-resolution pyramid.

Parameters
levelsThe number of pyramid levels to generate.
interpMethodThe used interpolation method.
Returns
true if OK, false if errors ocurred.

Implements te::rst::Raster.

Definition at line 114 of file SynchronizedRaster.h.

◆ free()

void te::rst::SynchronizedRaster::free ( )
protected

Free all allocated internal resources and go back to the initial state.

◆ getAccessPolicy()

te::common::AccessPolicy te::rst::Raster::getAccessPolicy ( ) const
inherited

Returns the raster access policy.

◆ getBand() [1/2]

const te::rst::Band* te::rst::SynchronizedRaster::getBand ( std::size_t  i) const
inlinevirtual

Returns the raster i-th band.

Parameters
iThe band index.
Warning
The caller is reponsible for providing a valid band index.

Implements te::rst::Raster.

Definition at line 88 of file SynchronizedRaster.h.

◆ getBand() [2/2]

te::rst::Band* te::rst::SynchronizedRaster::getBand ( std::size_t  i)
inlinevirtual

Returns the raster i-th band.

Parameters
iThe band index.
Warning
The caller is reponsible for providing a valid band index.

Implements te::rst::Raster.

Definition at line 94 of file SynchronizedRaster.h.

◆ getBandDataType()

int te::rst::SynchronizedRaster::getBandDataType ( std::size_t  i) const
virtual

Returns the data type in a particular band (or dimension).

Note
The data types are listed in terralib/datatype/DataTypes.h
Parameters
iThe desired band.
Returns
The data type in a particular band (or dimension).

Implements te::rst::Raster.

◆ getExtent() [1/3]

te::gm::Envelope* te::rst::Raster::getExtent ( )
inherited

Returns the geographic extension of the raster data.

Referenced by te::rst::LineIterator< T >::LineIterator(), and te::rst::PointSetIterator< T >::PointSetIterator().

◆ getExtent() [2/3]

const te::gm::Envelope* te::rst::Raster::getExtent ( ) const
inherited

Returns the geographic extension of the raster data.

◆ getExtent() [3/3]

te::gm::Envelope* te::rst::Raster::getExtent ( int  srid,
te::gm::Envelope roi = 0 
) const
inherited

Returns the geographic extension of the raster data, in a given SRS (distinct from its original one).

Parameters
sridThe target SRS id.
roiPointer to a region of interest. If NULL the original extenstion will be considered.
Returns
A pointer the raster extension in a given SRS or NULL if it fails.
Note
The caller will take the ownership of the returned pointer.

◆ getGrid() [1/2]

Grid* te::rst::Raster::getGrid ( )
inherited

◆ getGrid() [2/2]

const Grid* te::rst::Raster::getGrid ( ) const
inherited

It returns the raster grid.

◆ getInfo()

std::map<std::string, std::string> te::rst::SynchronizedRaster::getInfo ( ) const
virtual

It returns additional information about the raster.

The return of thi smethod is driver dependent.

Returns
Additional information about the raster.

Implements te::rst::Raster.

◆ getIValue()

virtual void te::rst::Raster::getIValue ( unsigned int  c,
unsigned int  r,
double &  value,
std::size_t  b = 0 
) const
virtualinherited

Returns the imaginary attribute value in a complex band of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valueThe attribute value to be assigned.
bA particular band of the cell attribute. Default value 0.
Warning
The caller is responsible for providing correct values for the range [c x r x b].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be read.

◆ getMultiResLevel()

Raster* te::rst::SynchronizedRaster::getMultiResLevel ( const unsigned int  level) const
inlinevirtual

Returns the required level of a multi-resolution pyramid or NULL if that level does not exists.

Parameters
levelLevel of a multi-resolution pyramid.
Returns
Returns the required level of a multi-resolution pyramid or NULL if that level does not exists.
Note
The caller must take the ownership of the returned pointer.

Implements te::rst::Raster.

Definition at line 126 of file SynchronizedRaster.h.

◆ getMultiResLevelsCount()

unsigned int te::rst::SynchronizedRaster::getMultiResLevelsCount ( ) const
inlinevirtual

Returns the current number of multi-resolution pyramid levels.

Returns
Returns the current number of multi-resolution pyramid levels.

Implements te::rst::Raster.

Definition at line 121 of file SynchronizedRaster.h.

◆ getName()

const std::string& te::rst::Raster::getName ( ) const
inherited

Returns the raster name.

◆ getNumberOfBands()

std::size_t te::rst::SynchronizedRaster::getNumberOfBands ( ) const
inlinevirtual

Returns the number of bands (dimension of cells attribute values) in the raster.

Implements te::rst::Raster.

Definition at line 81 of file SynchronizedRaster.h.

◆ getNumberOfColumns()

◆ getNumberOfRows()

◆ getResampledGrid()

Grid* te::rst::Raster::getResampledGrid ( int  scale) const
inherited

Return the raster grid for a specific scale.

Parameters
scaleThe desired sacale of interpolation (use - to shrink or + to enlarge).
Returns
The raster grid.
Note
The caller will take the ownership of the returned pointer.

◆ getResolutionX()

double te::rst::Raster::getResolutionX ( ) const
inherited

Returns the raster horizontal (x-axis) resolution.

Referenced by te::rst::LineIterator< T >::LineIterator().

◆ getResolutionY()

double te::rst::Raster::getResolutionY ( ) const
inherited

Returns the raster vertical (y-axis) resolution.

Referenced by te::rst::LineIterator< T >::LineIterator().

◆ getSRID()

int te::rst::Raster::getSRID ( ) const
inherited

◆ getTypeCode()

int te::rst::Raster::getTypeCode ( ) const
inlinevirtualinherited

It returns the data type code associated to the data value.

Returns
The data type code associated to the data value.

Implements te::dt::AbstractData.

Definition at line 362 of file Raster.h.

References te::dt::RASTER_TYPE.

◆ getValue() [1/2]

virtual void te::rst::Raster::getValue ( unsigned int  c,
unsigned int  r,
double &  value,
std::size_t  b = 0 
) const
virtualinherited

Returns the attribute value of a band of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valueTo return the attribute value.
bA particular band of the cell attribute.
Warning
The caller is responsible for providing correct values for the range [c x r x b].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be read.

Referenced by te::rp::ca::RasterInputAdaptor< DataType >::getFeature().

◆ getValue() [2/2]

virtual void te::rst::Raster::getValue ( unsigned int  c,
unsigned int  r,
std::complex< double > &  value,
std::size_t  b = 0 
) const
virtualinherited

Returns the imaginary attribute value in a complex band of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valueThe complex attribute value to be assigned (real, imaginary).
bA particular band of the cell attribute. Default value 0.
Warning
The caller is responsible for providing correct values for the range [c x r x b].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be read.

◆ getValues() [1/2]

virtual void te::rst::Raster::getValues ( unsigned int  c,
unsigned int  r,
std::vector< double > &  values 
) const
virtualinherited

Returns the imaginary attribute values in all complex bands of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valuesA vector of attribute values to be assigned (not complex values).
Warning
The caller is responsible for providing correct values for the range [c x r].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be read.

◆ getValues() [2/2]

virtual void te::rst::Raster::getValues ( unsigned int  c,
unsigned int  r,
std::vector< std::complex< double > > &  values 
) const
virtualinherited

Returns the imaginary attribute values in all complex bands of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valuesA vector of complex attribute values to be assigned (real, imaginary).
Warning
The caller is responsible for providing correct values for the range [c x r].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be read.

◆ open()

void te::rst::SynchronizedRaster::open ( const std::map< std::string, std::string > &  rinfo,
te::common::AccessPolicy  p = te::common::RAccess 
)
privatevirtual

Opens a raster.

Parameters
rinfoThe information needed by each driver to open the raster.
pAccess Policy.

Implements te::rst::Raster.

◆ operator*=() [1/2]

virtual Raster& te::rst::Raster::operator*= ( Raster rhs)
virtualinherited

It returns the raster product (pixel by pixel).

Parameters
rhsThe raster to be multiplied, right-hand side.
Note
Both rasters must have the same properties, #bands, #columns, #rows, and data type.
The caller is responsible to guarantee that resultant values will not exceed the range of the data type.
Returns
The raster product.

◆ operator*=() [2/2]

virtual Raster& te::rst::Raster::operator*= ( std::complex< double > &  cvalue)
virtualinherited

It returns the product of a constant value to all pixels in the raster.

Parameters
cvalueThe constant value to be multiplied.
Note
The caller is responsible to guarantee that resultant values will not exceed the range of the data type.
Returns
The raster product.

◆ operator+=() [1/2]

virtual Raster& te::rst::Raster::operator+= ( Raster rhs)
virtualinherited

It returns the raster sum (pixel by pixel).

Parameters
rhsThe raster to be added, right-hand side.
Note
Both rasters must have the same properties, #bands, #columns, #rows, and data type.
The caller is responsible to guarantee that resultant values will not exceed the range of the data type.
Returns
The raster sum.

◆ operator+=() [2/2]

virtual Raster& te::rst::Raster::operator+= ( std::complex< double > &  cvalue)
virtualinherited

It returns the sum of a constant value to all pixels in the raster.

Parameters
cvalueThe constant value to be added.
Note
The caller is responsible to guarantee that resultant values will not exceed the range of the data type.
Returns
The raster sum.

◆ operator-=() [1/2]

virtual Raster& te::rst::Raster::operator-= ( Raster rhs)
virtualinherited

It returns the raster subtraction (pixel by pixel).

Parameters
rhsThe raster to be subtracted, right-hand side.
Note
Both rasters must have the same properties, #bands, #columns, #rows, and data type.
The caller is responsible to guarantee that resultant values will not exceed the range of the data type.
Returns
The raster subtraction.

◆ operator-=() [2/2]

virtual Raster& te::rst::Raster::operator-= ( std::complex< double > &  cvalue)
virtualinherited

It returns the difference from all pixels in the raster to a constant value (pixels - constant).

Parameters
cvalueThe constant value to be subtracted.
Note
The caller is responsible to guarantee that resultant values will not exceed the range of the data type.
Returns
The raster difference.

◆ operator/=() [1/2]

virtual Raster& te::rst::Raster::operator/= ( Raster rhs)
virtualinherited

It returns the raster division (pixel by pixel).

Parameters
rhsThe raster to be divided, right-hand side.
Note
Both rasters must have the same properties, #bands, #columns, #rows, and data type.
The caller is responsible to guarantee that resultant values will not exceed the range of the data type.
Returns
The raster division.

◆ operator/=() [2/2]

virtual Raster& te::rst::Raster::operator/= ( std::complex< double > &  cvalue)
virtualinherited

It returns the division of all pixels in the raster by a constant value (pixels / constant).

Parameters
cvalueThe constant value to be divided.
Note
The caller is responsible to guarantee that resultant values will not exceed the range of the data type.
Returns
The raster division.

◆ operator[]() [1/2]

const te::rst::Band& te::rst::SynchronizedRaster::operator[] ( std::size_t  i) const
inlinevirtual

Access band in i position.

Parameters
iThe band index.
Warning
The caller is reponsible for providing a valid band index.
Returns
A reference to the i-th band.

Implements te::rst::Raster.

Definition at line 100 of file SynchronizedRaster.h.

◆ operator[]() [2/2]

te::rst::Band& te::rst::SynchronizedRaster::operator[] ( std::size_t  i)
inlinevirtual

Access band in i position.

Parameters
iThe band index.
Warning
The caller is reponsible for providing a valid band index.
Returns
A reference to the i-th band.

Implements te::rst::Raster.

Definition at line 106 of file SynchronizedRaster.h.

◆ rasterize()

virtual void te::rst::Raster::rasterize ( std::vector< te::gm::Geometry *>  g,
std::vector< double >  vp,
std::size_t  b = 0 
)
virtualinherited

Rasterizes a given vector of geometries.

Parameters
gA vector of geometries to be rasterized.
vpA vector of pixel values for each geometry. Can have the same size of the vector of geometries, or be null.
bThe band index to rasterize.

◆ removeMultiResolution()

bool te::rst::SynchronizedRaster::removeMultiResolution ( )
inlinevirtual

Remove/Destroy a sub-sampled multi-resolution pyramid, if there is one.

Returns
true if OK, false if errors ocurred.

Implements te::rst::Raster.

Definition at line 119 of file SynchronizedRaster.h.

◆ resample() [1/2]

virtual Raster* te::rst::Raster::resample ( int  method,
unsigned int  drow,
unsigned int  dcolumn,
unsigned int  height,
unsigned int  width,
unsigned int  newheight,
unsigned int  newwidth,
const std::map< std::string, std::string > &  rinfo 
) const
virtualinherited

Resample a subset of the raster, given a box.

Parameters
methodThe method of interpolation.
See also
te::rst::Interpolator
Parameters
drowThe starting row to make a subset of the image.
dcolumnThe starting column to make a subset of the image.
heightThe height of the subset.
widthThe width of the subset.
newheightThe resampled height of the new raster.
newwidthThe resampled width of the new raster.
rinfoThe parameters needed to build the output raster (see RasterFactory documentation).
Returns
A pointer to the resampled raster if success and a null pointer otherwise.
Note
The caller will take the ownership of the returned pointer.
Warning
A scale of 0 is not allowed. Use 1, 2, 3, or -1, -2, 3...

◆ resample() [2/2]

virtual Raster* te::rst::Raster::resample ( int  method,
int  scale,
const std::map< std::string, std::string > &  rinfo 
) const
virtualinherited

Resample raster.

Parameters
methodThe method of interpolation.
scaleThe scale of interpolation (use - to shrink or + to enlarge).
rinfoThe parameters needed to build the output raster (see RasterFactory documentation).
Returns
A pointer to the resampled raster if success and a null pointer otherwise.
Note
The caller will take the ownership of the returned pointer.
Warning
A scale of 0 is not allowed. Use 1, 2, 3, or -1, -2, 3...

Reimplemented in te::gdal::Raster.

◆ setAccessPolicy()

void te::rst::Raster::setAccessPolicy ( te::common::AccessPolicy  p)
inherited

Sets the raster access policy.

Parameters
pThe new raster access policy.

◆ setIValue()

virtual void te::rst::Raster::setIValue ( unsigned int  c,
unsigned int  r,
const double  value,
std::size_t  b = 0 
)
virtualinherited

Sets the imaginary attribute value in a complex band of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valueThe attribute value to be assigned.
bA particular band of the cell attribute. Default value 0.
Warning
The caller is responsible for providing correct values for the range [c x r x b].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be write.

◆ setName()

void te::rst::Raster::setName ( const std::string  name)
inherited

Sets the raster name.

Parameters
nameThe new raster name.

◆ setValue() [1/2]

virtual void te::rst::Raster::setValue ( unsigned int  c,
unsigned int  r,
const double  value,
std::size_t  b = 0 
)
virtualinherited

Sets the attribute value in a band of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valueThe attribute value to be assigned.
bA particular band of the cell attribute.
Warning
The caller is responsible for providing correct values for the range [c x r x b].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be write.

Referenced by te::rp::ca::RasterOutputAdaptor< DataType >::setFeature().

◆ setValue() [2/2]

virtual void te::rst::Raster::setValue ( unsigned int  c,
unsigned int  r,
const std::complex< double > &  value,
std::size_t  b = 0 
)
virtualinherited

Sets the imaginary attribute value in a complex band of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valueThe complex attribute value to be assigned (real, imaginary).
bA particular band of the cell attribute. Default value 0.
Warning
The caller is responsible for providing correct values for the range [c x r x b].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be write.

◆ setValues() [1/2]

virtual void te::rst::Raster::setValues ( unsigned int  c,
unsigned int  r,
const std::vector< double > &  values 
)
virtualinherited

Sets the imaginary attribute values in all complex bands of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valuesA vector of attribute values to be assigned (not complex values).
Warning
The caller is responsible for providing correct values for the range [c x r].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be write.

◆ setValues() [2/2]

virtual void te::rst::Raster::setValues ( unsigned int  c,
unsigned int  r,
const std::vector< std::complex< double > > &  values 
)
virtualinherited

Sets the imaginary attribute values in all complex bands of a cell.

Parameters
cThe column location of the cell.
rThe row location of the cell.
valuesA vector of complex attribute values to be assigned (real, imaginary).
Warning
The caller is responsible for providing correct values for the range [c x r].
Exceptions
ExceptionSubclasses may throw an exception if the data value can not be write.

◆ toString()

std::string te::rst::Raster::toString ( void  ) const
virtualinherited

It returns the data value in a string notation.

Returns
The data value in a string notation.

Implements te::dt::AbstractData.

◆ transform() [1/3]

virtual Raster* te::rst::Raster::transform ( int  srid,
const std::map< std::string, std::string > &  rinfo,
int  m = 1 
) const
virtualinherited

Reprojects this raster to a distinct SRS. This method reprojects this raster to a distinct SRS. The output resolution is calculated in order to maintain the same number of pixels as in this raster.

Parameters
sridThe target SRS identifier.
rinfoThe parameters needed to build the output raster (see RasterFactory documentation).
mThe method of interpolation to apply (default 1 = nearest neighbor).
See also
te::rst::Interpolator
Returns
A pointer to the reprojected raster if success and a null pointer otherwise.
Note
The caller will take the ownership of the returned pointer.

◆ transform() [2/3]

virtual Raster* te::rst::Raster::transform ( int  srid,
double  llx,
double  lly,
double  urx,
double  ury,
const std::map< std::string, std::string > &  rinfo,
int  m = 1 
) const
virtualinherited

Reprojects a squared portion of this raster to a distinct SRS. This method reprojects a squared portion of this raster to a distinct SRS. The output resolution is calculated in order to maintain the same number of pixels as in the desired portion of this raster.

Parameters
sridThe target SRS identifier.
llxLower-left X-coordinate of the portion to be reprojected (in the original SRS).
llyLower-left Y-coordinate of the portion to be reprojected (in the original SRS).
urxUpper-Right X-coordinate of the portion to be reprojected (in the original SRS).
urlUpper-Right Y-coordinate of the portion to be reprojected (in the original SRS).
rinfoThe parameters needed to build the output raster (see RasterFactory documentation).
mThe method of interpolation to apply (default 1 = nearest neighbor).
See also
te::rst::Interpolator
Returns
A pointer to the reprojected raster if success and a null pointer otherwise.
Note
The caller will take the ownership of the returned pointer.

◆ transform() [3/3]

virtual Raster* te::rst::Raster::transform ( int  srid,
double  llx,
double  lly,
double  urx,
double  ury,
double  resx,
double  resy,
const std::map< std::string, std::string > &  rinfo,
int  m = 1 
) const
virtualinherited

Reprojects a squared portion of this raster to another SRS with a desired resolution.

This method reprojects a squared portion of this raster to another SRS. The number of pixels in the output will be calculated according to the portion being reprojected and the asked resolution.

Parameters
sridThe SRS id of the target SRS.
llxLower-left X-coordinate of the portion to be reprojected (in the original SRS).
llyLower-left Y-coordinate of the portion to be reprojected (in the original SRS).
urxUpper-Right X-coordinate of the portion to be reprojected (in the original SRS).
urlUpper-Right Y-coordinate of the portion to be reprojected (in the original SRS).
resxThe output x resolution (in units of the target SRS).
resxThe output y resolution (in units of the target SRS).
rinfoThe parameters needed to build the output raster (see RasterFactory documentation).
mThe method of interpolation to apply (default 1 = nearest neighbor).
See also
te::rst::Interpolator
Returns
A pointer to the reprojected raster if success and a null pointer otherwise.
Note
The caller will take the ownership of the returned pointer.

Reimplemented in te::gdal::Raster.

◆ trim()

virtual Raster* te::rst::Raster::trim ( const te::gm::Envelope env,
const std::map< std::string, std::string > &  rinfo 
) const
virtualinherited

Subsetting operation for trimming (cropping) the raster.

Parameters
envThe envelope (inside original extent) to crop the raster.
rinfoThe parameters needed to build the output raster (see RasterFactory documentation).
Returns
A pointer to the trimmed raster if success and a null pointer otherwise.
Note
The caller will take the ownership of the returned pointer.

◆ vectorize()

virtual void te::rst::Raster::vectorize ( std::vector< te::gm::Geometry *> &  g,
std::size_t  b,
unsigned int  mp = 0,
std::vector< double > *const  polygonsValues = 0 
)
virtualinherited

Vectorizes a given raster band, using GDALPolygonize function.

Parameters
gA reference to a vector of geometries. Will be filled with geometries found in band.
bThe band index to vectorize.
polygonsValuesA pointer to a valid vector where the raster pixel values related to each polygon will be stored, or a NULL pointer.
Note
The caller of this method must take the ownership of the returned geometries and must delete them when necessary.

Member Data Documentation

◆ m_bands

std::vector< SynchronizedBand* > te::rst::SynchronizedRaster::m_bands
protected

Internal raster bands.

Definition at line 148 of file SynchronizedRaster.h.

◆ m_blocksManager

SynchronizedBandBlocksManager te::rst::SynchronizedRaster::m_blocksManager
protected

Internal blocks manager.

Definition at line 146 of file SynchronizedRaster.h.

◆ m_grid

Grid* te::rst::Raster::m_grid
protectedinherited

The spatial support for raster data.

Definition at line 699 of file Raster.h.

◆ m_name

std::string te::rst::Raster::m_name
protectedinherited

The raster name.

Definition at line 698 of file Raster.h.

◆ m_policy

te::common::AccessPolicy te::rst::Raster::m_policy
protectedinherited

The access policy, can be te::common::{NoAccess, RAccess, RWAccess, WAccess}.

Definition at line 700 of file Raster.h.


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