cartagen.skeletonize_artificial

skeletonize_artificial(polygon, entries, connection='joint', threshold_range=(0.7, 1.4))

Create a TIN skeleton from a polygon by enforcing entry points.

The artificial skeleton means the entry points of the skeleton are manually set and the natural entry points of the skeleton calculated during the skeleton creation are removed.

This version is inspired by the enhanced TIN skeleton proposed by Wang [1]

Parameters:

• polygon (Polygon) – The polygon to compute the skeleton from.

• entries (list of Point) – The entry points of the skeleton.

• connection (str, optional) – Connection can be ‘joint’, which forces the entry point to connect to the closest joint, or can be ‘interior’, which first look if there is an interior triangle inside the triangulation and connect directly the entry point to its skeleton joint. If no interior triangle is found, apply ‘joint’ connection instead.

• threshold_range (tuple, optional) – This value is only used for inner triangles calculated by the Delaunay triangulation. If two of the length ratio between each pair of edges (of an inner triangle) is outside the given range, the skeleton uses the middle of the line connecting the two center of the longest lines of the triangle, else it uses the centroid of the triangle.

Returns:

list of LineString

See also

skeletonize_natural

Create the natural TIN skeleton.

skeletonize_network

Create a TIN skeleton and blend it with the provided network.

References

[1]

Tao Wang. Extraction of optimal skeleton of polygon based on hierarchical analysis. In Computer Science. 2010. URL: https://api.semanticscholar.org/CorpusID:6207216.

(Source code)