bg_union_polygon
Geometric functions bg_union_polygon

not reliable on real data
Use geos_union_polygon instead, the recommended default for polygon set operations, or dms_union_polygon for polygons that are not valid.
Boost.Geometry documents invalid geometry as undefined behaviour, and unioning real-world polygons, such as BAG building footprints, regularly produces intermediate results that Boost.Geometry itself rejects as invalid. Those are repaired with GEOS MakeValid, but the repair does not always yield geometry that Boost.Geometry accepts. The engine then cleans degenerate rings out of the repair result and reports an error rather than continue into undefined behaviour, so on such data bg_union_polygon stops with an error.
syntax
- bg_union_polygon(polygon_data_item)
- bg_union_polygon(polygon_data_item, relation)
description
bg_union_polygon(polygon_data_item, partitioning) results in an attribute with all polygons from polygon_data_item, grouped by the Argument relation.
Lines between adjacent polygons within each group are removed.
The Domain unit of the resulting Attribute is the Values unit of the relation.
In other GIS software, the term dissolve is often used for this operation.
conditions
- The composition type of the polygon_data_item item needs to be a polygon with an ipoint, spoint, fpoint, or dpoint Value type.
- The domain unit of the polygon_data_item item must be of value type uint32.
- The domain unit of arguments polygon_data_item and relation must match.
- The order of points in the polygon_data_item needs to be clockwise for exterior bounds and counterclockwise for holes in polygons (right-hand rule).
function type
- bg_union_polygon(D->P) -> void->P
- bg_union_polygon(D->P, part_rel: D->R) -> R->P
where P is a GeoDms point type with signed integer coordinates, i.e. 16, 32, or 64-bit signed integers, D is the domain of the argument, and R is the values unit of the partitioning part_rel.
since version
15.6.0
example
parameter<fpoint> geometry (polygon) := bg_union_polygon(district/geometry);
attribute<fpoint> geometry (polygon, region) := bg_union_polygon(district/geometry, district/region_rel);