cartagen.amalgamate_buildings

amalgamate_buildings(building1, building2)

Amalgamate two buildings by computing their most compact junction.

The amalgamation algorithm was proposed by Nicolas Regnauld [1] (pp. 150-154). The algorithm is based on the edges of the convex hull that join both buildings. The algorithm chooses the links that create the smallest joined polygons.

Parameters:

• building1 (Polygon) – The first building to amalgamate.

• building2 (Polygon) – The second building to amalgamate.

Returns:

Polygon

See also

amalgamate_buildings_morphological

Amalgamate multiple close buildings.

References

[1]

Nicolas Regnauld. Généralisation du bâti: Structure spatiale de type graphe et représentation cartographique. PhD Thesis, Université de Provence, 1998.

Examples

>>> buildings = [Polygon([(1, 0), (9, 0), (9, 6), (1, 6), (1, 0)]), Polygon([(10, 0), (17, 0), (17, 6), (10, 6), (10, 0)])]
>>> morphological_amalgamation(buildings, 1.0, 1.0)
<POLYGON ((1.207 1.983, 2.547 5.885, 16.768 4.282, 15.42 0.148, 1.207 1.983))>

(Source code)