org.locationtech.jts.algorithm

Class Centroid

java.lang.Object

org.locationtech.jts.algorithm.Centroid

public class Centroid
extends Object

Computes the centroid of a Geometry 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, a null 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

Constructor Summary

Constructors

Constructor and Description
Centroid(Geometry geom) Creates a new instance for computing the centroid of a geometry

Method Summary

Modifier and Type	Method and Description
Coordinate	getCentroid() Gets the computed centroid.
static Coordinate	getCentroid(Geometry geom) Computes the centroid point of a geometry.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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