AR1/docs/analysis-tools/zonal-stats.md

64 lines
1.2 KiB
Markdown

# Zonal Statistics
Calculate statistics for raster data within polygon zones.
## Overview
Zonal statistics calculates summary statistics (mean, sum, count, etc.) for raster pixel values within polygon zones.
## Inputs
- **Raster Dataset**: Raster dataset to analyze
- **Zone Dataset**: Polygon dataset defining zones
- **Statistics**: Statistics to calculate
## Outputs
New dataset containing:
- Zone polygons
- Raster statistics for each zone
- Zone attributes
## Statistics
- **Mean**: Average pixel value
- **Sum**: Sum of pixel values
- **Count**: Number of pixels
- **Min/Max**: Minimum/maximum pixel values
- **StdDev**: Standard deviation of pixel values
## Example
```json
{
"raster_dataset_id": 125,
"zone_dataset_id": 123,
"statistics": ["mean", "sum", "count"]
}
```
## Background Jobs
This analysis runs as a background job.
## Use Cases
- Land cover analysis
- Elevation statistics
- Climate data aggregation
- Raster value extraction
## Notes
- Zones must overlap raster extent
- Statistics calculated for overlapping pixels
- NoData values excluded
- Processing time depends on raster and zone sizes
## Related Documentation
- [Analysis API](../api/analysis.md)
- [Raster Tools](raster.md)