org.apache.commons.geometry.spherical.twod

Class InteriorAngleGreatArcConnector

java.lang.Object

org.apache.commons.geometry.euclidean.internal.AbstractPathConnector<AbstractGreatArcConnector.ConnectableGreatArc>

org.apache.commons.geometry.spherical.twod.AbstractGreatArcConnector

org.apache.commons.geometry.spherical.twod.InteriorAngleGreatArcConnector

Direct Known Subclasses:

InteriorAngleGreatArcConnector.Maximize, InteriorAngleGreatArcConnector.Minimize

public abstract class InteriorAngleGreatArcConnector
extends AbstractGreatArcConnector

Great arc connector that selects between multiple connection options based on the resulting interior angle. An interior angle in this case is the angle created between an incoming arc and an outgoing arc as measured on the minus (interior) side of the incoming arc. If looking along the direction of the incoming arc, smaller interior angles point more to the left and larger ones point more to the right.

This class provides two concrete implementations: InteriorAngleGreatArcConnector.Maximize and InteriorAngleGreatArcConnector.Minimize, which choose connections with the largest or smallest interior angles respectively.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InteriorAngleGreatArcConnector.Maximize Implementation of InteriorAngleGreatArcConnector that chooses arc connections that produce the largest interior angles.
static class	InteriorAngleGreatArcConnector.Minimize Implementation of InteriorAngleGreatArcConnector that chooses arc connections that produce the smallest interior angles.

Nested classes/interfaces inherited from class org.apache.commons.geometry.spherical.twod.AbstractGreatArcConnector

AbstractGreatArcConnector.ConnectableGreatArc

Nested classes/interfaces inherited from class org.apache.commons.geometry.euclidean.internal.AbstractPathConnector

AbstractPathConnector.ConnectableElement<E extends AbstractPathConnector.ConnectableElement<E>>

Constructor Summary

Constructors

Constructor and Description
InteriorAngleGreatArcConnector()

Method Summary

Modifier and Type	Method and Description
static List<GreatArcPath>	connectMaximized(Collection<GreatArc> arcs) Convenience method for connecting a set of arcs with interior angles maximized when possible.
static List<GreatArcPath>	connectMinimized(Collection<GreatArc> arcs) Convenience method for connecting a set of line segments with interior angles minimized when possible.
protected abstract boolean	isBetterAngle(double newAngle, double previousAngle) Return true if newAngle represents a better interior angle than previousAngle.
protected AbstractGreatArcConnector.ConnectableGreatArc	selectConnection(AbstractGreatArcConnector.ConnectableGreatArc incoming, List<AbstractGreatArcConnector.ConnectableGreatArc> outgoing)

Methods inherited from class org.apache.commons.geometry.spherical.twod.AbstractGreatArcConnector

add, add, connect, connectAll, connectAll

Methods inherited from class org.apache.commons.geometry.euclidean.internal.AbstractPathConnector

addPathElement, computePathRoots, connectPathElements, selectPointConnection

Methods inherited from class java.lang.Object

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

Constructor Detail

InteriorAngleGreatArcConnector

public InteriorAngleGreatArcConnector()

Method Detail

selectConnection

protected AbstractGreatArcConnector.ConnectableGreatArc selectConnection(AbstractGreatArcConnector.ConnectableGreatArc incoming,
                                                                         List<AbstractGreatArcConnector.ConnectableGreatArc> outgoing)

Specified by:

selectConnection in class AbstractPathConnector<AbstractGreatArcConnector.ConnectableGreatArc>

isBetterAngle

protected abstract boolean isBetterAngle(double newAngle,
                                         double previousAngle)

Return true if newAngle represents a better interior angle than previousAngle.

Parameters:

newAngle - the new angle under consideration

previousAngle - the previous best angle

Returns:

true if newAngle represents a better interior angle than previousAngle

connectMaximized

public static List<GreatArcPath> connectMaximized(Collection<GreatArc> arcs)

Convenience method for connecting a set of arcs with interior angles maximized when possible. This method is equivalent to new Maximize().connect(segments).

Parameters:

arcs - arcs to connect

Returns:

a list of connected arc paths

See Also:

InteriorAngleGreatArcConnector.Maximize

connectMinimized

public static List<GreatArcPath> connectMinimized(Collection<GreatArc> arcs)

Convenience method for connecting a set of line segments with interior angles minimized when possible. This method is equivalent to new Minimize().connect(segments).

Parameters:

arcs - arcs to connect

Returns:

a list of connected arc paths

See Also:

InteriorAngleGreatArcConnector.Minimize