path: root/libtellurian_gaussian_radius.3

.TH LIBTELLURIAN_GAUSSIAN_RADIUS 3 libtellurian
.SH NAME
libtellurian_gaussian_radius \- Calculate a Gaussian radius of curvature

.SH SYNPOSIS
.nf
#include <libtellurian.h>

double libtellurian_gaussian_radius(double \fIlatitude\fP);

double libtellurian_gaussian_radius_radians(double \fIlatitude\fP);
.fi
.PP
Link with
.I -ltellurian
.IR -lm .

.SH DESCRIPTION
The
.BR libtellurian_gaussian_radius ()
function calculates the Earth's Gaussian radius of
curvature at a given
.IR latitude ,
that is, the geometric mean of the meridian and
the transverse radii of curvature at the given
.IR latitude .
.PP
The
.I latitude
shall be specified according to GPS and in degrees.
.PP
The
.BR libtellurian_gaussian_radius_radians ()
function is identical to the
.BR libtellurian_gaussian_radius ()
function except that
.I latitude
shall be specified in radians.

.SH RETURN VALUE
The
.BR libtellurian_gaussian_radius ()
and
.BR libtellurian_gaussian_radius_radians ()
functions return the radius of curvature
measured in meters.

.SH ERRORS
None.

.SH SEE ALSO
.BR libtellurian (7)