aboutsummaryrefslogtreecommitdiffstats
path: root/libtellurian_gaussian_radius.3
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--libtellurian_gaussian_radius.352
1 files changed, 52 insertions, 0 deletions
diff --git a/libtellurian_gaussian_radius.3 b/libtellurian_gaussian_radius.3
new file mode 100644
index 0000000..aaa84dc
--- /dev/null
+++ b/libtellurian_gaussian_radius.3
@@ -0,0 +1,52 @@
+.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)