AR1/docs/analysis-tools/dissolve.md

66 lines
1.4 KiB
Markdown

# Dissolve Analysis
Merge features based on attribute values, optionally aggregating numeric fields.
## Overview
Dissolve analysis merges adjacent or overlapping features that share the same attribute value, creating simplified datasets.
## Inputs
- **Source Dataset**: Dataset to dissolve
- **Dissolve Field**: Field to dissolve on (or merge all)
- **Aggregation Fields** (optional): Fields to aggregate with functions
## Outputs
New dataset containing:
- Merged geometries for each group
- Aggregated attribute values
- Group identifiers
## Aggregation Functions
- **Sum**: Sum of numeric values
- **Average**: Average of numeric values
- **Min/Max**: Minimum/maximum values
- **Count**: Count of features
## Example
```json
{
"source_dataset_id": 123,
"dissolve_field": "category",
"aggregation_fields": {
"population": "sum",
"area": "sum"
}
}
```
## Background Jobs
This analysis runs as a background job. See [Dissolve Worker](../workers/dissolve.md) for details.
## Use Cases
- Administrative boundary simplification
- Aggregated statistics
- Data generalization
- Map simplification
## Notes
- Adjacent features are merged
- Aggregation required for numeric fields
- Complex geometries may slow processing
- Results depend on dissolve field values
## Related Documentation
- [Dissolve Worker](../workers/dissolve.md)
- [Analysis API](../api/analysis.md)