Package org.locationtech.jts.algorithm
Class Centroid
- java.lang.Object
-
- org.locationtech.jts.algorithm.Centroid
-
public class Centroid extends java.lang.Object
Computes the centroid of aGeometry
of any dimension. If the geometry is nominally of higher dimension, but has lower effective dimension (i.e. contains only components having zero length or area), the centroid will be computed as for the equivalent lower-dimension geometry. If the input geometry is empty, anull
Coordinate is returned.Algorithm
- Dimension 2 - the centroid is computed
as the weighted sum of the centroids
of a decomposition of the area into (possibly overlapping) triangles.
Holes and multipolygons are handled correctly.
See
http://www.faqs.org/faqs/graphics/algorithms-faq/
for further details of the basic approach. - Dimension 1 - Computes the average of the midpoints of all line segments weighted by the segment length. Zero-length lines are treated as points.
- Dimension 0 - Compute the average coordinate for all points. Repeated points are all included in the average.
- Version:
- 1.7
- Dimension 2 - the centroid is computed
as the weighted sum of the centroids
of a decomposition of the area into (possibly overlapping) triangles.
Holes and multipolygons are handled correctly.
See
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description Coordinate
getCentroid()
Gets the computed centroid.static Coordinate
getCentroid(Geometry geom)
Computes the centroid point of a geometry.
-
-
-
Constructor Detail
-
Centroid
public Centroid(Geometry geom)
Creates a new instance for computing the centroid of a geometry
-
-
Method Detail
-
getCentroid
public static Coordinate getCentroid(Geometry geom)
Computes the centroid point of a geometry.- Parameters:
geom
- the geometry to use- Returns:
- the centroid point, or null if the geometry is empty
-
getCentroid
public Coordinate getCentroid()
Gets the computed centroid.- Returns:
- the computed centroid, or null if the input is empty
-
-