# Summarize Within

Calculate summary statistics for features within polygon zones.

## Overview

Summarize within calculates statistics (count, sum, average, etc.) for features that fall within polygon zones.

## Inputs

- **Input Dataset**: Point or line dataset to summarize
- **Zone Dataset**: Polygon dataset defining zones
- **Statistics**: Statistics to calculate

## Outputs

New dataset containing:

- Zone polygons
- Summary statistics for each zone
- Zone attributes

## Statistics

- **Count**: Number of features in zone
- **Sum**: Sum of numeric values
- **Average**: Average of numeric values
- **Min/Max**: Minimum/maximum values

## Example

```json
{
  "input_dataset_id": 123,
  "zone_dataset_id": 124,
  "statistics": ["count", "sum", "average"]
}
```

## Use Cases

- Zonal statistics
- Aggregated analysis
- Summary reporting
- Data aggregation

## Notes

- Features must be within zones
- Multiple statistics can be calculated
- Results depend on zone boundaries
- Processing time depends on dataset sizes

## Related Documentation

- [Analysis API](../api/analysis.md)

