## DESCRIPTION

r.stats.zonal is a tool to analyse exploratory statistics of a floating-point "cover layer" according to how it intersects with objects in a "base layer". A variety of standard statistical measures are possible. This type of analysis is often called zonal statistics. The zones are specified as the base raster map and the statistics are computed from cells in the cover raster map. Notably, the output of this module is spatial: The resulting values are recorded as cell values in the output raster map.

## NOTES

r.stats.zonal is intended to be a partial replacement for r.statistics, with support for floating-point cover maps at the expense of not supporting quantiles. For this, see r.stats.quantile.

## EXAMPLE

In this example, the raster polygon map `zipcodes` in the North Carolina sample dataset is used to calculate zonal raster statistics using the `elevation` raster map:

    g.region raster=zipcodes -p

    # pixel count in zipcode areas
    r.stats.zonal base=zipcodes cover=elevation method=count output=zipcodes_elev_count
    r.colors zipcodes_elev_count color=gyr -g

    # average elevation in zipcode areas
    r.stats.zonal base=zipcodes cover=elevation method=average output=zipcodes_elev_avg
    r.colors zipcodes_elev_avg color=elevation -g

## SEE ALSO

- r.stats.quantile for computing quantiles in zones (objects in base raster map),
- r.quantile for computing quantiles of a whole raster map,
- r.statistics for categorical (integer) zonal statistics,
- r.univar for zonal statistics with textual (non-spatial) output,
- v.vect.stats for statistics of vector points in vector areas.

## AUTHOR

Glynn Clements