Fourth commit

Signed-off-by: Mattias Andrée <m@maandree.se>

1 files changed, 53 insertions, 0 deletions

diff --git a/libtellurian_normal_gravity.3 b/libtellurian_normal_gravity.3
new file mode 100644
index 0000000..cc3a6fa
--- /dev/null
+++ b/libtellurian_normal_gravity.3
@@ -0,0 +1,53 @@
+.TH LIBTELLURIAN_NORMAL_GRAVITY 3 libtellurian
+.SH NAME
+libtellurian_normal_gravity \- Calculate normal gravity
+
+.SH SYNPOSIS
+.nf
+#include <libtellurian.h>
+
+double libtellurian_normal_gravity(double \fIlatitude\fP);
+
+double libtellurian_normal_gravity_radians(double \fIlatitude\fP);
+.fi
+.PP
+Link with
+.I -ltellurian
+.IR -lm .
+
+.SH DESCRIPTION
+The
+.BR libtellurian_normal_gravity ()
+function models the Earth as a spheroid and calculates
+the normal (theoretical) gravity for any point on a given
+.I latitude
+at the surface. This acceleration does not account for
+the angular velocity of the Earth's rotation.
+.PP
+The
+.I latitude
+shall be specified according to GPS and in degrees.
+.PP
+The
+.BR libtellurian_normal_gravity_radians ()
+function is identical to the
+.BR libtellurian_normal_gravity ()
+function except that
+.I latitude
+shall be specified in radians.
+
+.SH RETURN VALUE
+The
+.BR libtellurian_normal_gravity ()
+and
+.BR libtellurian_normal_gravity_radians ()
+functions return the normal gravity, at the specified
+latitude, measured in meters per square second.
+
+.SH ERRORS
+None.
+
+.SH SEE ALSO
+.BR libtellurian (7),
+.BR libtellurian_effective_gravity (3),
+.BR libtellurian_elevated_gravity (3)