agi.foundation.routedesign.advanced

(agi.foundation.routedesign-2024r3.jar)

Class GeodesicConnectionStrategy

java.lang.Object

agi.foundation.routedesign.advanced.ConnectionStrategy

agi.foundation.routedesign.advanced.GeodesicConnectionStrategy

public class GeodesicConnectionStrategy
extends ConnectionStrategy

A connection strategy that connects two procedures with a straight path of minimum distance (geodesic).

Constructor Summary

Constructors

Constructor and Description
GeodesicConnectionStrategy(Ellipsoid shape) Create a new instance based on the given surface shape.
GeodesicConnectionStrategy(Ellipsoid shape, Cartographic start, Cartographic stop) Create a new instance based on the given start and stop positions.
GeodesicConnectionStrategy(EllipsoidGeodesic line) Create a new instance based on the given EllipsoidGeodesic.

Method Summary

Modifier and Type	Method and Description
double	getDistance() Get the total distance traversed by this connection from start to finish, in meters.
double	getFinalHeading() Get the final heading of the connection, in radians.
double	getFinalHeading(Ellipsoid shape, Cartographic initialPoint, Cartographic finalPoint) Get the final heading of the curve corresponding to the given parameters.
double	getFinalHeading(Ellipsoid shape, Cartographic initialPoint, double heading, double distance) Get the final heading of the curve corresponding to the given parameters.
double	getFinalHeading(EllipsoidSurfaceCurve curve) Get the final heading of the given curve, in radians.
Cartographic	getFinalPoint() Gets the final point of the connection segment.
double	getHeading(double s) Get the heading at an arbitrary point along the connection, in radians.
double	getInitialHeading() Get the initial heading of the connection, in radians.
double	getInitialHeading(Ellipsoid shape, Cartographic initialPoint, Cartographic finalPoint) Get the initial heading of the curve corresponding to the given parameters.
double	getInitialHeading(EllipsoidSurfaceCurve curve) Get the initial heading of the given curve, in radians.
Cartographic	getInitialPoint() Gets the initial point of the connection segment.
EllipsoidSurfaceCurve	getSurfaceCurve(Ellipsoid shape, Cartographic initialPoint, Cartographic finalPoint) Generate a curve representing the connection from the initial to the final point.
EllipsoidSurfaceCurve	getSurfaceCurve(Ellipsoid shape, Cartographic initialPoint, double heading, double distance) Generate a curve representing the connection from the initial to the final point.
Cartographic	getSurfacePoint(double s) Get the surface point along the connection at the given arc length.
SurfaceSegment	getSurfaceSegment() Get an instance of the surface geometry corresponding to this connection segment.
Ellipsoid	getSurfaceShape() Gets the shape of the reference surface upon which the surface geometry is defined.
void	setPoints(Cartographic start, Cartographic stop) Set the initial and final points of the connection segment.
void	setStart(Cartographic start) Set the initial point of the connection segment.
void	setStop(Cartographic stop) Set the final point of the connection segment.
void	setSurfaceCurve(EllipsoidSurfaceCurve curve) Set this connection to use the given surface curve.

Methods inherited from class java.lang.Object

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

Constructor Detail

GeodesicConnectionStrategy

public GeodesicConnectionStrategy(Ellipsoid shape)

Create a new instance based on the given surface shape.

Parameters:

shape - The shape of the surface upon which to define the connection.

GeodesicConnectionStrategy

public GeodesicConnectionStrategy(Ellipsoid shape,
                                  @Nonnull
                                  Cartographic start,
                                  @Nonnull
                                  Cartographic stop)

Create a new instance based on the given start and stop positions.

Parameters:

shape - The shape of the surface over which the connection path is defined.

start - The initial position for the connection.

stop - The final position for the connection.

GeodesicConnectionStrategy

public GeodesicConnectionStrategy(EllipsoidGeodesic line)

Create a new instance based on the given EllipsoidGeodesic.

Parameters:

line - The line representing the geometry of the connection.

Method Detail

setPoints

public void setPoints(@Nonnull
                      Cartographic start,
                      @Nonnull
                      Cartographic stop)

Set the initial and final points of the connection segment.

Specified by:

setPoints in class ConnectionStrategy

Parameters:

start - The initial point of the connection.

stop - The final point of the connection.

setStart

public void setStart(@Nonnull
                     Cartographic start)

Set the initial point of the connection segment.

Specified by:

setStart in class ConnectionStrategy

Parameters:

start - The initial point of the connection.

setStop

public void setStop(@Nonnull
                    Cartographic stop)

Set the final point of the connection segment.

Specified by:

setStop in class ConnectionStrategy

Parameters:

stop - The final point of the connection.

getInitialHeading

public double getInitialHeading()

Get the initial heading of the connection, in radians.

Specified by:

getInitialHeading in class ConnectionStrategy

Returns:

The initial heading measured clockwise from north, in radians.

getFinalHeading

public double getFinalHeading()

Get the final heading of the connection, in radians.

Specified by:

getFinalHeading in class ConnectionStrategy

Returns:

The final heading measured clockwise from north, in radians.

getDistance

public double getDistance()

Get the total distance traversed by this connection from start to finish, in meters.

Specified by:

getDistance in class ConnectionStrategy

Returns:

The total distance, in meters.

getSurfaceSegment

public SurfaceSegment getSurfaceSegment()

Get an instance of the surface geometry corresponding to this connection segment.

Specified by:

getSurfaceSegment in class ConnectionStrategy

Returns:

The immutable surface geometry corresponding to this connection.

getHeading

public double getHeading(double s)

Get the heading at an arbitrary point along the connection, in radians.

Specified by:

getHeading in class ConnectionStrategy

Parameters:

s - The arc length parameter along the connection, in meters.

Returns:

The heading measured clockwise from north, in radians.

getSurfacePoint

@Nonnull
public Cartographic getSurfacePoint(double s)

Get the surface point along the connection at the given arc length.

Specified by:

getSurfacePoint in class ConnectionStrategy

Parameters:

s - The arc length parameter along the connection, in meters.

Returns:

The surface point at the given distance along the connection.

getInitialPoint

@Nonnull
public Cartographic getInitialPoint()

Gets the initial point of the connection segment.

Specified by:

getInitialPoint in class ConnectionStrategy

getFinalPoint

@Nonnull
public Cartographic getFinalPoint()

Gets the final point of the connection segment.

Specified by:

getFinalPoint in class ConnectionStrategy

getSurfaceShape

public Ellipsoid getSurfaceShape()

Gets the shape of the reference surface upon which the surface geometry is defined.

Specified by:

getSurfaceShape in class ConnectionStrategy

getSurfaceCurve

public EllipsoidSurfaceCurve getSurfaceCurve(Ellipsoid shape,
                                             @Nonnull
                                             Cartographic initialPoint,
                                             @Nonnull
                                             Cartographic finalPoint)

Generate a curve representing the connection from the initial to the final point.

Specified by:

getSurfaceCurve in class ConnectionStrategy

Parameters:

shape - The surface shape to use.

initialPoint - The initial point of the curve.

finalPoint - The final point of the curve.

Returns:

The resulting connection curve.

getSurfaceCurve

public EllipsoidSurfaceCurve getSurfaceCurve(Ellipsoid shape,
                                             @Nonnull
                                             Cartographic initialPoint,
                                             double heading,
                                             double distance)

Generate a curve representing the connection from the initial to the final point.

Specified by:

getSurfaceCurve in class ConnectionStrategy

Parameters:

shape - The surface shape to use.

initialPoint - The initial point of the curve.

heading - The initial heading along the curve, in radians.

distance - The surface distance along the curve, in meters.

Returns:

The resulting connection curve.

getInitialHeading

public double getInitialHeading(Ellipsoid shape,
                                @Nonnull
                                Cartographic initialPoint,
                                @Nonnull
                                Cartographic finalPoint)

Get the initial heading of the curve corresponding to the given parameters.

Specified by:

getInitialHeading in class ConnectionStrategy

Parameters:

shape - The shape of the surface.

initialPoint - The initial point of the curve.

finalPoint - The final point of the curve.

Returns:

The initial heading along the curve, in radians.

getFinalHeading

public double getFinalHeading(Ellipsoid shape,
                              @Nonnull
                              Cartographic initialPoint,
                              @Nonnull
                              Cartographic finalPoint)

Get the final heading of the curve corresponding to the given parameters.

Specified by:

getFinalHeading in class ConnectionStrategy

Parameters:

shape - The shape of the surface.

initialPoint - The initial point on the curve.

finalPoint - The final point on the curve.

Returns:

The final heading along the curve, in radians.

getFinalHeading

public double getFinalHeading(Ellipsoid shape,
                              @Nonnull
                              Cartographic initialPoint,
                              double heading,
                              double distance)

Get the final heading of the curve corresponding to the given parameters.

Specified by:

getFinalHeading in class ConnectionStrategy

Parameters:

shape - The shape of the surface.

initialPoint - The initial point on the curve.

heading - The initial heading along the curve, in radians.

distance - The surface distance along the curve, in meters.

Returns:

The final heading along the curve, in radians.

getInitialHeading

public double getInitialHeading(EllipsoidSurfaceCurve curve)

Get the initial heading of the given curve, in radians.

Specified by:

getInitialHeading in class ConnectionStrategy

Parameters:

curve - The curve to analyze.

Returns:

The initial heading of the curve, in radians.

getFinalHeading

public double getFinalHeading(EllipsoidSurfaceCurve curve)

Get the final heading of the given curve, in radians.

Specified by:

getFinalHeading in class ConnectionStrategy

Parameters:

curve - The curve to analyze.

Returns:

The final heading of the curve, in radians.

setSurfaceCurve

public void setSurfaceCurve(EllipsoidSurfaceCurve curve)

Set this connection to use the given surface curve.

If the given curve is incompatible with the current strategy, the strategy will attempt to create a new curve that will use the end points of the specified curve.

Specified by:

setSurfaceCurve in class ConnectionStrategy

Parameters:

curve - The curve to use as the connection.