statType over the region of interest defined by zone. It computes the statistic from the pixel values within the ROI geometry and returns the result. If the excludeNoData parameter is not specified, it will default to true. This excludes NoData values from the statistic calculation. Additionally, if the band parameter is not provided, band 1 will be used by default for the statistic computation. The valid options for statType are:
The allTouched parameter (Since v1.7.1) determines how pixels are selected:
- When true, any pixel touched by the geometry will be included.
- When false (default), only pixels whose centroid intersects with the geometry will be included.
count: Number of pixels in the region.sum: Sum of pixel values.mean|average|avg: Arithmetic mean.median: Middle value in the region.mode: Most occurring value, if there are multiple values with same occurrence then will return the largest number.stddev|sd: Standard deviation.variance: Variance.min: Minimum value in the region.max: Maximum value in the region.
If the coordinate reference system (CRS) of the input
zone geometry differs from that of the raster, then zone will be transformed to match the CRS of the raster before computation.The following conditions will throw an IllegalArgumentException if they are not met:- The provided
rasterandzonegeometry should intersect whenlenientparameter is set tofalse. - The option provided to
statTypeshould be valid.
lenient parameter is set to true by default. The function will return null if the raster and zone geometry do not intersect.
Signatures
Parameters
The input raster.
The zone value.
The band index.
The stat type value.
The all touched value.
The exclude no data value.
The lenient value.
Return type
A numeric value.