org.gavaghan.geodesy

Class GeodeticCalculator

java.lang.Object

org.gavaghan.geodesy.GeodeticCalculator

public class GeodeticCalculator
extends Object

Implementation of Thaddeus Vincenty's algorithms to solve the direct and inverse geodetic problems.

Author:

Mike Gavaghan

See Also:

Vincenty's original publication on the NOAA website.

Constructor Summary

Constructors

Constructor and Description
GeodeticCalculator()

Method Summary

Modifier and Type	Method and Description
GlobalCoordinates	calculateEndingGlobalCoordinates(Ellipsoid ellipsoid, GlobalCoordinates start, double startBearing, double distance) Calculate the destination after traveling a specified distance, and a specified starting bearing, for an initial location.
GlobalCoordinates	calculateEndingGlobalCoordinates(Ellipsoid ellipsoid, GlobalCoordinates start, double startBearing, double distance, double[] endBearing) Calculate the destination and final bearing after traveling a specified distance, and a specified starting bearing, for an initial location.
GeodeticCurve	calculateGeodeticCurve(Ellipsoid ellipsoid, GlobalCoordinates start, GlobalCoordinates end) Calculate the geodetic curve between two points on a specified reference ellipsoid.
GeodeticMeasurement	calculateGeodeticMeasurement(Ellipsoid refEllipsoid, GlobalPosition start, GlobalPosition end) Calculate the three dimensional geodetic measurement between two positions measured in reference to a specified ellipsoid.

Methods inherited from class java.lang.Object

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

Constructor Detail

GeodeticCalculator

public GeodeticCalculator()

Method Detail

calculateEndingGlobalCoordinates

public GlobalCoordinates calculateEndingGlobalCoordinates(Ellipsoid ellipsoid,
                                                          GlobalCoordinates start,
                                                          double startBearing,
                                                          double distance,
                                                          double[] endBearing)

Calculate the destination and final bearing after traveling a specified distance, and a specified starting bearing, for an initial location. This is the solution to the direct geodetic problem.

Parameters:

ellipsoid - reference ellipsoid to use

start - starting location

startBearing - starting bearing (degrees)

distance - distance to travel (meters)

endBearing - bearing at destination (degrees) element at index 0 will be populated with the result

Returns:

solution to the direct geodetic problem

calculateEndingGlobalCoordinates

public GlobalCoordinates calculateEndingGlobalCoordinates(Ellipsoid ellipsoid,
                                                          GlobalCoordinates start,
                                                          double startBearing,
                                                          double distance)

Calculate the destination after traveling a specified distance, and a specified starting bearing, for an initial location. This is the solution to the direct geodetic problem.

Parameters:

ellipsoid - reference ellipsoid to use

start - starting location

startBearing - starting bearing (degrees)

distance - distance to travel (meters)

Returns:

solution to the direct geodetic problem

calculateGeodeticCurve

public GeodeticCurve calculateGeodeticCurve(Ellipsoid ellipsoid,
                                            GlobalCoordinates start,
                                            GlobalCoordinates end)

Calculate the geodetic curve between two points on a specified reference ellipsoid. This is the solution to the inverse geodetic problem.

Parameters:

ellipsoid - reference ellipsoid to use

start - starting coordinates

end - ending coordinates

Returns:

solution to the inverse geodetic problem

calculateGeodeticMeasurement

public GeodeticMeasurement calculateGeodeticMeasurement(Ellipsoid refEllipsoid,
                                                        GlobalPosition start,
                                                        GlobalPosition end)

Calculate the three dimensional geodetic measurement between two positions measured in reference to a specified ellipsoid.

This calculation is performed by first computing a new ellipsoid by expanding or contracting the reference ellipsoid such that the new ellipsoid passes through the average elevation of the two positions. A geodetic curve across the new ellisoid is calculated. The point-to-point distance is calculated as the hypotenuse of a right triangle where the length of one side is the ellipsoidal distance and the other is the difference in elevation.

Parameters:

refEllipsoid - reference ellipsoid to use

start - starting position

end - ending position

Returns:

solution to the inverse geodetic problem