org.opentripplanner.graph_builder.module.map

Class LinearIterator

java.lang.Object

org.opentripplanner.graph_builder.module.map.LinearIterator

All Implemented Interfaces:

Iterable<com.vividsolutions.jts.linearref.LinearLocation>

public class LinearIterator
extends Object
implements Iterable<com.vividsolutions.jts.linearref.LinearLocation>

I copied this class from JTS but made a few changes. The JTS version of this class has several design decisions that don't work for me. In particular, hasNext() in the original should be "isValid", and if we start mid-segment, we should continue at the end of this segment rather than the end of the next segment.

Constructor Summary

Constructors

Constructor and Description
LinearIterator(com.vividsolutions.jts.geom.Geometry linear) Creates an iterator initialized to the start of a linear Geometry
LinearIterator(com.vividsolutions.jts.geom.Geometry linearGeom, int componentIndex, int vertexIndex) Creates an iterator starting at a specified component and vertex in a linear Geometry
LinearIterator(com.vividsolutions.jts.geom.Geometry linear, com.vividsolutions.jts.linearref.LinearLocation start) Creates an iterator starting at a LinearLocation on a linear Geometry

Method Summary

Modifier and Type	Method and Description
int	getComponentIndex() The component index of the vertex the iterator is currently at.
static com.vividsolutions.jts.linearref.LinearLocation	getEndLocation(com.vividsolutions.jts.geom.Geometry linear)
com.vividsolutions.jts.geom.LineString	getLine() Gets the LineString component the iterator is current at.
com.vividsolutions.jts.linearref.LinearLocation	getLocation()
com.vividsolutions.jts.geom.Coordinate	getSegmentEnd() Gets the second Coordinate of the current segment.
com.vividsolutions.jts.geom.Coordinate	getSegmentStart() Gets the first Coordinate of the current segment.
int	getVertexIndex() The vertex index of the vertex the iterator is currently at.
boolean	hasNext() Tests whether there are any vertices left to iterator over.
boolean	isEndOfLine() Checks whether the iterator cursor is pointing to the endpoint of a linestring.
boolean	isValidIndex()
Iterator<com.vividsolutions.jts.linearref.LinearLocation>	iterator()
void	next() Moves the iterator ahead to the next vertex and (possibly) linear component.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

LinearIterator

public LinearIterator(com.vividsolutions.jts.geom.Geometry linear)

Creates an iterator initialized to the start of a linear Geometry

Parameters:

linear - the linear geometry to iterate over

Throws:

IllegalArgumentException - if linearGeom is not lineal

LinearIterator

public LinearIterator(com.vividsolutions.jts.geom.Geometry linear,
                      com.vividsolutions.jts.linearref.LinearLocation start)

Creates an iterator starting at a LinearLocation on a linear Geometry

Parameters:

linear - the linear geometry to iterate over

start - the location to start at

Throws:

IllegalArgumentException - if linearGeom is not lineal

LinearIterator

public LinearIterator(com.vividsolutions.jts.geom.Geometry linearGeom,
                      int componentIndex,
                      int vertexIndex)

Creates an iterator starting at a specified component and vertex in a linear Geometry

Parameters:

linearGeom - the linear geometry to iterate over

componentIndex - the component to start at

vertexIndex - the vertex to start at

Throws:

IllegalArgumentException - if linearGeom is not lineal

Method Detail

hasNext

public boolean hasNext()

Tests whether there are any vertices left to iterator over.

Returns:

true if there are more vertices to scan

isValidIndex

public boolean isValidIndex()

next

public void next()

Moves the iterator ahead to the next vertex and (possibly) linear component.

isEndOfLine

public boolean isEndOfLine()

Checks whether the iterator cursor is pointing to the endpoint of a linestring.

Returns:

true if the iterator is at an endpoint

getComponentIndex

public int getComponentIndex()

The component index of the vertex the iterator is currently at.

Returns:

the current component index

getVertexIndex

public int getVertexIndex()

The vertex index of the vertex the iterator is currently at.

Returns:

the current vertex index

getLine

public com.vividsolutions.jts.geom.LineString getLine()

Gets the LineString component the iterator is current at.

Returns:

a linestring

getSegmentStart

public com.vividsolutions.jts.geom.Coordinate getSegmentStart()

Gets the first Coordinate of the current segment. (the coordinate of the current vertex).

Returns:

a Coordinate

getSegmentEnd

public com.vividsolutions.jts.geom.Coordinate getSegmentEnd()

Gets the second Coordinate of the current segment. (the coordinate of the next vertex). If the iterator is at the end of a line, null is returned.

Returns:

a Coordinate or null

getLocation

public com.vividsolutions.jts.linearref.LinearLocation getLocation()

iterator

public Iterator<com.vividsolutions.jts.linearref.LinearLocation> iterator()

Specified by:

iterator in interface Iterable<com.vividsolutions.jts.linearref.LinearLocation>

getEndLocation

public static com.vividsolutions.jts.linearref.LinearLocation getEndLocation(com.vividsolutions.jts.geom.Geometry linear)