C# Geodesy Library for GPS – Vincenty’s Formulae
This will be handy for anyone, particularly Geocachers, interested in developing software for use with a GPS receiver. The library provides two important functions:
- Calculate a destination given a starting point, direction, and distance traveled on Earth
- Calculate the distance between two points on Earth
The fancy schmancy names for these functions are the “direct geodetic problem” and the “the inverse geodetic problem”.
For a deeper discussion of the source code, I recommend reading my blog entry: C#, GPS Receivers, and Geocaching: Vincenty’s Formula.
This is the C# source code for implementations of Thaddeus Vincenty’s algorithms to solve the direct and inverse geodetic problems.
The inputs for the direct solution are the latitude and longitude of a starting point, a starting bearing, a distance to travel, and a reference model of Earth (several are provided). The outputs are the latitude and longitude of the destination and, optionally, the final bearing at the destination.
The inputs for the inverse solution are the latitude and longitude of two points and a reference model of Earth (several are provided). The outputs are 1) the distance between the points along the curve of Earth, and 2) the direction from the starting point to the ending point.
The library has no dependencies on any other libraries.
The primary classes in the library are:
Gavaghan.Geodesy (2-D calculations)
Angle – encapsulates latitude and longitude measurements in degrees while providing easy conversion to radians.
Ellipsoid – an immutable property class representing a model of Earth used for geodetic calculations. Several static instances are included that describe scientifically measured models. WGS84 (the 1984 World Geodetic System) and GRS80 (the 1980 Geodetic Reference System) are the most widely used.
GlobalCoordinates – encapsulates a location on Earth as described by two
Angles: latitude and longitude.
GeodeticCurve – the outcome of an inverse geodetic calculation. It represents the path and ellipsoidal distance between two
GlobalCoordinates for a specified reference
GeodeticCalculator – this is a behavior class that contains the actual implementations of Vincenty’s Formulae.
Gavaghan.Geodesy (3-D calculations)
GlobalPosition – this is similar to
GlobalCoordinates, but it also includes a measurement of elevation, in meters, above or below the reference
GeodeticMeasurement – this is similar to
GeodeticCurve, but it also adds a point-to-point measurement which accounts for a change in elevation between two points in addition to the ellipsoidal distance.
GeodeticCalculator – this is the same behavior class described above. It contains methods for both 2-D and 3-D calculations.
This is a console application project that sets up and computes a direct calculation and a 2-D and 3-D inverse calculation. This is a good starting point for figuring out how to use the library.
This is an NUnit project. Currently, there are not many tests. It is mostly geared toward ensuring that the canonicalization of
GlobalCoordinates behaves properly.
|1.1.1||Apr 15, 2008||Fixed pole-crossing defect. Many thanks to Matt Feemster for finding this.|
|1.1.0||Jan 6, 2008||Incorporated Vincenty’s direct solution.|