pe_loxodrome_distance

Finds the distance and forward and inverse azimuths between two points along a loxodrome

Usage syntax

void pe_loxodrome_distance (double a, double e2, double lam1, double phi1, double lam2, double phi2, double *distance, double *az12, double *az21);

Parameters
a Semimajor axis of the spheroid
e2 Eccentricity squared of the spheroid
lam1 Longitude value of the first point
phi1 Latitude value of the first point
lam2 Longitude value of the second point
phi2 Latitude value of the second point
distance Distance
az12 Azimuth from the first to the second point
az21 Azimuth from the second to the first point
Description

The pe_loxodrome_distance function takes a spheroid and two geographic points and calculates the distance and azimuths along the loxodrome. A loxodrome, or rhumb line, is the path of equal bearing between two points on a spheroid. The Mercator projection has the special property that straight lines are loxodromes. This property makes the Mercator projection useful when navigating a course. Set e2 to zero to calculate distance on a sphere. The geographic coordinates and the azimuths are in radians. The azimuth value range is -π ≤ azimuth ≤ +π. An azimuth is measured positive clockwise with North equal to a zero azimuth. The semimajor axis (a) is usually given in meters, which means that the distance is in meters. To return the distance in another linear unit of measure, specify the semimajor axis in that unit of measure. As an example, if the semimajor axis is in US survey feet, the returned distance is in US survey feet.

Returns

Distance and forward and inverse azimuths (in radians)