Merge Features by Rules

Merge vector features based on configurable rules including name matching, adjacency, and explicit merge specifications. Used to combine HUC12 polygons into larger drainage units based on naming conventions.

ID	vector_merge_by_rules
Domain	geo
Category	vector
Type	vector-to-vector
Version	1.0.0

view yaml ◦view github ◦

Parameters

merge_by_group: boolean · default true · Merge features that share the same group_id (from group_by_name). Requires features to have group_id attribute.
require_adjacency: boolean · default true · Only merge features that are spatially adjacent (touching). If false, may create multipolygons from disjoint features.
explicit_merges: array · default · List of explicit merge rules as objects with 'target' (name to merge into) and 'sources' (list of names to merge). Takes precedence over automatic rules.
exclude_patterns: array · default · Regex patterns for names to exclude from merging. Features matching these patterns remain separate.
name_column: string · default name · Column containing feature name for rule matching
output_name_column: string · default merged_name · Column for the merged feature's name
aggregation: string · default {"area_km2": "sum", "huc12_count": "count"} · JSON string defining how to aggregate numeric columns when merging. Keys are column names, values are aggregation functions (sum, mean, min, max, count).