org.geolatte.geom

Class LineString<P extends Position>

java.lang.Object

org.geolatte.geom.Geometry<P>

org.geolatte.geom.LineString<P>

All Implemented Interfaces:

java.io.Serializable, Linear<P>, Simple

Direct Known Subclasses:

LinearRing

public class LineString<P extends Position>
extends Geometry<P>
implements Linear<P>, Simple

A LineString is a 1-dimensional Geometry consisting of the LineSegments defined by consecutive pairs of Points of a PointSequence.

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
	LineString(CoordinateReferenceSystem<P> crs)
protected	LineString(LineString<P> base) This constructor has been added to speed up object creation of LinearRings
	LineString(PositionSequence<P> positions, CoordinateReferenceSystem<P> crs) Constructs a LineString from the specified positions and ProjectedGeometryOperations implementation.

Method Summary

Modifier and Type	Method and Description
void	accept(GeometryVisitor<P> visitor) Accepts a GeometryVisitor.
int	getDimension() Returns the topological dimension of this instance.
P	getEndPosition() Returns the last Position of this LineString.
GeometryType	getGeometryType() Returns the type of this Geometry.
P	getStartPosition() Returns the first Position of this LineString.
boolean	isClosed() Checks whether this LineString is closed, i.e.
boolean	isRing() Checks whether this LineString is a ring, i.e.
(package private) java.lang.Iterable<LineSegment<P>>	lineSegments() Returns the LineSegments that define this instance.

Methods inherited from class org.geolatte.geom.Geometry

equals, forceToCrs, getCoordinateDimension, getCoordinateReferenceSystem, getCrs, getEnvelope, getNumPositions, getPositionClass, getPositionN, getPositions, getSRID, hashCode, isEmpty, nestPositionSequences, toString, writeReplace

Methods inherited from class java.lang.Object

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

Constructor Detail

LineString

public LineString(CoordinateReferenceSystem<P> crs)

LineString

protected LineString(LineString<P> base)

This constructor has been added to speed up object creation of LinearRings

Parameters:

base -

LineString

public LineString(PositionSequence<P> positions,
                  CoordinateReferenceSystem<P> crs)

Constructs a LineString from the specified positions and ProjectedGeometryOperations implementation.

Parameters:

positions - the PositionSequence that determines this geometry

Throws:

java.lang.IllegalArgumentException - if the passed PointSequence is non-empty and of size < 2

Method Detail

getStartPosition

public P getStartPosition()

Returns the first Position of this LineString.

Specified by:

getStartPosition in interface Linear<P extends Position>

Returns:

the first Position of this LineString.

getEndPosition

public P getEndPosition()

Returns the last Position of this LineString.

Specified by:

getEndPosition in interface Linear<P extends Position>

Returns:

the last Position of this LineString.

isClosed

public boolean isClosed()

Checks whether this LineString is closed, i.e. the first Point equals the last.

Returns:

true if this LineString is closed.

isRing

public boolean isRing()

Checks whether this LineString is a ring, i.e. is closed and non-empty.

Note that this implementation allows rings thate are non-simple.

Returns:

true if this LineString is a ring.

getDimension

public int getDimension()

Description copied from class: Geometry

Returns the topological dimension of this instance. In non-homogenous collections, this will return the largest topological dimension of the contained Geometries.

Specified by:

getDimension in class Geometry<P extends Position>

Returns:

the topological dimension of this instance

getGeometryType

public GeometryType getGeometryType()

Description copied from class: Geometry

Returns the type of this Geometry.

Specified by:

getGeometryType in class Geometry<P extends Position>

Returns:

the GeometryType of this instance.

accept

public void accept(GeometryVisitor<P> visitor)

Description copied from class: Geometry

Accepts a GeometryVisitor.

If this Geometry instance is a GeometryCollection then it will pass the visitor to its contained Geometries.

Specified by:

accept in class Geometry<P extends Position>

lineSegments

java.lang.Iterable<LineSegment<P>> lineSegments()

Returns the LineSegments that define this instance.

Returns:

an Iterable of this instance's LineSegments