From 6ac74a858b8f9ff122c8494dd4590fe1e5678a24 Mon Sep 17 00:00:00 2001
From: Mattias Andrée <m@maandree.se>
Date: Sun, 20 Oct 2024 00:01:25 +0200
Subject: Third commit
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Mattias Andrée <m@maandree.se>
---
 libtellurian_end_point.3 | 84 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 libtellurian_end_point.3

(limited to 'libtellurian_end_point.3')

diff --git a/libtellurian_end_point.3 b/libtellurian_end_point.3
new file mode 100644
index 0000000..3a93fe9
--- /dev/null
+++ b/libtellurian_end_point.3
@@ -0,0 +1,84 @@
+.TH LIBTELLURIAN_END_POINT 3 libtellurian
+.SH NAME
+libtellurian_end_point \- Calculate travel end-point
+
+.SH SYNPOSIS
+.ni
+#include <libtellurian.h>
+
+void libtellurian_end_point(double \fIlatitude1\fP, double \fIlongitude1\fP,
+                            double \fIazimuth1\fP, double \fIdistance\fP,
+                            double \fIlatitude2_out\fP, double \fIlongitude2_out\fP,
+                            double *\fIazimuth2_out\fP);
+
+void libtellurian_end_point_radians(double \fIlatitude1\fP, double \fIlongitude1\fP,
+                                    double \fIazimuth1\fP, double \fIdistance\fP,
+                                    double \fIlatitude2_out\fP, double \fIlongitude2_out\fP,
+                                    double *\fIazimuth2_out\fP);
+.fi
+.PP
+Link with
+.I -ltellurian
+.IR -lm .
+
+.SH DESCRIPTION
+The
+.BR libtellurian_end_point ()
+function models the Earth as an oblate
+spheroid and calculates a good approximate
+location where a traveller starting at
+.RI ( latitude1 ", " longitude1 )
+travelling in an azimuthal direction,
+.IR azimuth1 ,
+for a specified
+.IR distance ,
+measured in meters, along the ellipsoid.
+.PP
+The location the traveller will end at will
+be stored at
+.RI ( *latitude2_out ", " *longitude2_out ).
+along the ellipsoid. The azimuth from this
+point to the starting point will be stored in
+.IR *azimuth2_out .
+.PP
+However
+.IR latitude2_out ,
+.IR longitude2_out ,
+and
+.I azimuth2_out
+can each, independently, be set to
+.IR NULL ,
+which will cause the function to skip the
+specific calculations needed for the value
+stored in the referenced memory.
+.PP
+The coordinates shall be specified, and are
+returned, according to GPS and in degrees.
+Likewise
+.I azimuth1
+shall be in degrees, and
+.I *azimuth2_out
+will be in degress.
+.PP
+The
+.BR libtellurian_end_point_radians ()
+function is identical to the
+.BR libtellurian_end_point ()
+function except that radians are
+used instead of degress for
+.IR latitude1 ,
+.IR longitude1 ,
+.IR azimuth1 ,
+.IR *latitude2_out ,
+.IR *longitude2_out ,
+and
+.IR *azimuth2_out .
+
+.SH RETURN VALUE
+None.
+
+.SH ERRORS
+None.
+
+.SH SEE ALSO
+.BR libtellurian (7)
-- 
cgit v1.2.3-70-g09d2