Class TopologyPreservingSimplifier

Namespace

NetTopologySuite.Simplify

Assembly

NetTopologySuite.dll

Simplifies a point and ensures that the result is a valid point having the same dimension and number of components as the input, and with the components having the same topological relationship.

If the input is a polygonal geometry (Polygon or MultiPolygon):

• The result has the same number of shells and holes as the input, with the same topological structure
• The result rings touch at no more than the number of touching points in the input (although they may touch at fewer points). The key implication of this statement is that if the input is topologically valid, so is the simplified output.

For linear geometries, if the input does not contain any intersecting line segments, this property will be preserved in the output.

For all geometry types, the result will contain enough vertices to ensure validity. For polygons and closed linear geometries, the result will have at least 4 vertices; for open LineStrings the result will have at least 2 vertices.

All geometry types are handled. Empty and point geometries are returned unchanged. Empty geometry components are deleted.

The simplification uses a maximum-distance difference algorithm similar to the Douglas-Peucker algorithm.

public class TopologyPreservingSimplifier

Inheritance

object

TopologyPreservingSimplifier

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Remarks

KNOWN BUGS

• May create invalid topology if there are components which are small relative to the tolerance value. In particular, if a small hole is very near an edge, it is possible for the edge to be moved by a relatively large tolerance value and end up with the hole outside the result shell (or inside another hole). Similarly, it is possible for a small polygon component to end up inside a nearby larger polygon. A workaround is to test for this situation in post-processing and remove any invalid holes or polygons.

Constructors

TopologyPreservingSimplifier(Geometry)

Creates an instance of this class for the provided inputGeom geometry

public TopologyPreservingSimplifier(Geometry inputGeom)

Parameters

inputGeom Geometry

The geometry to simplify

See Also

DouglasPeuckerSimplifier

Properties

DistanceTolerance

Gets or sets the distance tolerance for the simplification.
Points closer than this tolerance to a simplified segment may be removed.

public double DistanceTolerance { get; set; }

Property Value

double

See Also

DouglasPeuckerSimplifier

Methods

GetResultGeometry()

public Geometry GetResultGeometry()

Returns

Geometry

See Also

DouglasPeuckerSimplifier

Simplify(Geometry, double)

public static Geometry Simplify(Geometry geom, double distanceTolerance)

Parameters

geom Geometry

distanceTolerance double

Returns

Geometry

See Also

DouglasPeuckerSimplifier

See Also

DouglasPeuckerSimplifier