aboutsummaryrefslogtreecommitdiffstats
path: root/libtellurian_transverse_radius.3
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--libtellurian_transverse_radius.350
1 files changed, 50 insertions, 0 deletions
diff --git a/libtellurian_transverse_radius.3 b/libtellurian_transverse_radius.3
new file mode 100644
index 0000000..aa24be4
--- /dev/null
+++ b/libtellurian_transverse_radius.3
@@ -0,0 +1,50 @@
+.TH LIBTELLURIAN_TRANSVERSE_RADIUS 3 libtellurian
+.SH NAME
+libtellurian_transverse_radius \- Calculate a transverse radius of curvature
+
+.SH SYNPOSIS
+.nf
+#include <libtellurian.h>
+
+double libtellurian_transverse_radius(double \fIlatitude\fP);
+
+double libtellurian_transverse_radius_radians(double \fIlatitude\fP);
+.fi
+.PP
+Link with
+.I -ltellurian
+.IR -lm .
+
+.SH DESCRIPTION
+The
+.BR libtellurian_transverse_radius ()
+function calculates the Earth's transverse radius of
+curvature (prime-vertial radius of curvature; the
+curvature in the east–west direction), at a given
+.IR latitude .
+.PP
+The
+.I latitude
+shall be specified according to GPS and in degrees.
+.PP
+The
+.BR libtellurian_transverse_radius_radians ()
+function is identical to the
+.BR libtellurian_transverse_radius ()
+function except that
+.I latitude
+shall be specified in radians.
+
+.SH RETURN VALUE
+The
+.BR libtellurian_transverse_radius ()
+and
+.BR libtellurian_transverse_radius_radians ()
+functions return the radius of curvature
+measured in meters.
+
+.SH ERRORS
+None.
+
+.SH SEE ALSO
+.BR libtellurian (7)