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	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 AbstractGreatArcConnector

AbstractGreatArcConnector.ConnectableGreatArc

Nested classes/interfaces inherited from class AbstractPathConnector

AbstractPathConnector.ConnectableElement<E>

Constructor Summary

Constructors

Constructor	Description
InteriorAngleGreatArcConnector()

Method Summary

Modifier and Type	Method	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)	Method called to select a connection to use for a given segment when multiple non-length-zero connections are available.

Methods inherited from class AbstractGreatArcConnector

add, add, connect, connectAll, connectAll

Methods inherited from class AbstractPathConnector

addPathElement, computePathRoots, connectPathElements, selectPointConnection

Methods inherited from class Object

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

Constructor Details

InteriorAngleGreatArcConnector

public InteriorAngleGreatArcConnector()

Method Details

selectConnection

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

Method called to select a connection to use for a given segment when multiple non-length-zero connections are available. In this case, the selection of the outgoing connection depends only on the desired characteristics of the connected path.

Specified by:

selectConnection in class AbstractPathConnector<AbstractGreatArcConnector.ConnectableGreatArc>

Parameters:

incoming - the incoming segment

outgoing - list of available outgoing connections; will always contain at least two elements

Returns:

the connection to use

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