Class LinearRing

java.lang.Object

org.locationtech.jts.geom.Geometry

org.locationtech.jts.geom.LineString

org.locationtech.jts.geom.LinearRing

All Implemented Interfaces:

Serializable, Cloneable, Comparable, Lineal

public class LinearRing
extends LineString

Models an OGC SFS LinearRing. A LinearRing is a LineString which is both closed and simple. In other words, the first and last coordinate in the ring must be equal, and the ring must not self-intersect. Either orientation of the ring is allowed.

A ring must have either 0 or 3 or more points. The first and last points must be equal (in 2D). If these conditions are not met, the constructors throw an IllegalArgumentException. A ring with 3 points is invalid, because it is collapsed and thus has a self-intersection. It is allowed to be constructed so that it can be represented, and repaired if needed.

Version:

1.7

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final int	MINIMUM_VALID_SIZE	The minimum number of vertices allowed in a valid non-empty ring.

Fields inherited from class LineString

points

Fields inherited from class Geometry

envelope, factory, SRID, TYPECODE_GEOMETRYCOLLECTION, TYPECODE_LINEARRING, TYPECODE_LINESTRING, TYPECODE_MULTILINESTRING, TYPECODE_MULTIPOINT, TYPECODE_MULTIPOLYGON, TYPECODE_POINT, TYPECODE_POLYGON, TYPENAME_GEOMETRYCOLLECTION, TYPENAME_LINEARRING, TYPENAME_LINESTRING, TYPENAME_MULTILINESTRING, TYPENAME_MULTIPOINT, TYPENAME_MULTIPOLYGON, TYPENAME_POINT, TYPENAME_POLYGON

Constructor Summary

Constructors

Constructor	Description
LinearRing(Coordinate[] points, PrecisionModel precisionModel, int SRID)	Deprecated. Use GeometryFactory instead
LinearRing(CoordinateSequence points, GeometryFactory factory)	Constructs a LinearRing with the vertices specified by the given CoordinateSequence.

Method Summary

Modifier and Type	Method	Description
protected LinearRing	copyInternal()	An internal method to copy subclass-specific geometry data.
int	getBoundaryDimension()	Returns Dimension.FALSE, since by definition LinearRings do not have a boundary.
String	getGeometryType()	Returns the name of this Geometry's actual class.
protected int	getTypeCode()
boolean	isClosed()	Tests whether this ring is closed.
LinearRing	reverse()	Creates a LineString whose coordinates are in the reverse order of this objects
LinearRing	reverseInternal()

Methods inherited from class LineString

apply, apply, apply, apply, clone, compareToSameClass, compareToSameClass, computeEnvelopeInternal, equalsExact, getBoundary, getCoordinate, getCoordinateN, getCoordinates, getCoordinateSequence, getDimension, getEndPoint, getLength, getNumPoints, getPointN, getStartPoint, isCoordinate, isEmpty, isEquivalentClass, isRing, normalize

Methods inherited from class Geometry

buffer, buffer, buffer, compare, compareTo, compareTo, contains, convexHull, copy, coveredBy, covers, crosses, difference, disjoint, distance, equal, equals, equals, equalsExact, equalsNorm, equalsTopo, geometryChanged, geometryChangedAction, getArea, getCentroid, getEnvelope, getEnvelopeInternal, getFactory, getGeometryN, getInteriorPoint, getNumGeometries, getPrecisionModel, getSRID, getUserData, hasDimension, hashCode, hasNonEmptyElements, hasNullElements, intersection, intersects, isGeometryCollection, isRectangle, isSimple, isValid, isWithinDistance, norm, overlaps, relate, relate, setSRID, setUserData, symDifference, toString, toText, touches, union, union, within

Methods inherited from class Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

MINIMUM_VALID_SIZE

public static final int MINIMUM_VALID_SIZE

The minimum number of vertices allowed in a valid non-empty ring. Empty rings with 0 vertices are also valid.

See Also:

• Constant Field Values

Constructor Details

LinearRing

public LinearRing(Coordinate[] points,
 PrecisionModel precisionModel,
 int SRID)

Deprecated.

Use GeometryFactory instead

Constructs a LinearRing with the given points.

Parameters:

points - points forming a closed and simple linestring, or null or an empty array to create the empty geometry. This array must not contain null elements.

precisionModel - the specification of the grid of allowable points for this LinearRing

SRID - the ID of the Spatial Reference System used by this LinearRing

Throws:

IllegalArgumentException - if the ring is not closed, or has too few points

LinearRing

public LinearRing(CoordinateSequence points,
 GeometryFactory factory)

Constructs a LinearRing with the vertices specified by the given CoordinateSequence.

Parameters:

points - a sequence points forming a closed and simple linestring, or null to create the empty geometry.

Throws:

IllegalArgumentException - if the ring is not closed, or has too few points

Method Details

getBoundaryDimension

public int getBoundaryDimension()

Returns Dimension.FALSE, since by definition LinearRings do not have a boundary.

Overrides:

getBoundaryDimension in class LineString

Returns:

Dimension.FALSE

isClosed

public boolean isClosed()

Tests whether this ring is closed. Empty rings are closed by definition.

Overrides:

isClosed in class LineString

Returns:

true if this ring is closed

getGeometryType

public String getGeometryType()

Description copied from class: Geometry

Returns the name of this Geometry's actual class.

Overrides:

getGeometryType in class LineString

Returns:

the name of this Geometrys actual class

getTypeCode

protected int getTypeCode()

Overrides:

getTypeCode in class LineString

copyInternal

protected LinearRing copyInternal()

Description copied from class: Geometry

An internal method to copy subclass-specific geometry data.

Overrides:

copyInternal in class LineString

Returns:

a copy of the target geometry object.

reverse

public LinearRing reverse()

Description copied from class: LineString

Creates a LineString whose coordinates are in the reverse order of this objects

Overrides:

reverse in class LineString

Returns:

a LineString with coordinates in the reverse order

reverseInternal

public LinearRing reverseInternal()

Overrides:

reverseInternal in class LineString