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