Class GDALBand
Wrap a GDAL raster band, needs to be obtained from a GDALRaster object.
Declaration
source linkDocumentation
Methods
▷ def color_interp(self, as_string=False) Return the GDAL color interpretation for this band.
▶ def data(self, data=None, offset=None, size=None, shape=None, as_memoryview=False) Read or writes pixel values for this band. Blocks of data can
be accessed by specifying the width, height and offset of the
desired block. The same specification can be used to update
parts of a raster by providing an array of values.
Allowed input data types are bytes, memoryview, list, tuple, and array.
▷ def datatype(self, as_string=False) Return the GDAL Pixel Datatype for this band.
▷ def description(self) @property Return the description string of the band.
@property
def description(self)
▷ def height(self) @property Height (Y axis) in pixels of the band.
@property
def height(self)
▷ def max(self) @property Return the maximum pixel value for this band.
▷ def mean(self) @property Return the mean of all pixel values of this band.
▷ def min(self) @property Return the minimum pixel value for this band.
▷ def nodata_value(self) @property Return the nodata value for this band, or None if it isn't set.
@property
def nodata_value(self)
▷ def nodata_value(self, value) @nodata_value.setter Set the nodata value for this band.
@nodata_value.setter
def nodata_value(
self,
value,
)
▷ def pixel_count(self) @property Return the total number of pixels in this band.
@property
def pixel_count(self)
▶ def statistics(self, refresh=False, approximate=False) Compute statistics on the pixel values of this band.
The return value is a tuple with the following structure:
(minimum, maximum, mean, standard deviation).
If approximate=True, the statistics may be computed based on overviews
or a subset of image tiles.
If refresh=True, the statistics will be computed from the data directly,
and the cache will be updated where applicable.
For empty bands (where all pixel values are nodata), all statistics
values are returned as None.
For raster formats using Persistent Auxiliary Metadata (PAM) services,
the statistics might be cached in an auxiliary file.
▷ def std(self) @property Return the standard deviation of all pixel values of this band.
▷ def width(self) @property Width (X axis) in pixels of the band.