pud: update nmealib to 2.0.0
[olsrd.git] / lib / pud / nmealib / include / nmea / gmath.h
1 /*
2  * This file is part of nmealib.
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program. If not, see <http://www.gnu.org/licenses/>.
16  */
17
18 #ifndef __NMEA_GMATH_H__
19 #define __NMEA_GMATH_H__
20
21 #include <nmea/info.h>
22
23 #define NMEA_TUD_YARDS              (1.0936133)                     /**< Yards, meter * NMEA_TUD_YARDS = yard */
24 #define NMEA_TUD_KNOTS              (1.852)                         /**< Knots, kilometer / NMEA_TUD_KNOTS = knot */
25 #define NMEA_TUD_MILES              (1.609344)                      /**< Miles, kilometer / NMEA_TUD_MILES = mile */
26 #define NMEA_TUS_MS                 (3.6)                           /**< Meters per seconds, (k/h) / NMEA_TUS_MS= (m/s) */
27 #define NMEA_PI                     (3.141592653589793)             /**< PI value */
28 #define NMEA_PI180                  (NMEA_PI / 180)                 /**< PI division by 180 */
29 #define NMEA_EARTHRADIUS_KM         (6378)                          /**< Earth's mean radius in km */
30 #define NMEA_EARTHRADIUS_M          (NMEA_EARTHRADIUS_KM * 1000)    /**< Earth's mean radius in m */
31 #define NMEA_EARTH_SEMIMAJORAXIS_M  (6378137.0)                     /**< Earth's semi-major axis in m according WGS84 */
32 #define NMEA_EARTH_SEMIMAJORAXIS_KM (NMEA_EARTHMAJORAXIS_KM / 1000) /**< Earth's semi-major axis in km according WGS 84 */
33 #define NMEA_EARTH_FLATTENING       (1 / 298.257223563)             /**< Earth's flattening according WGS 84 */
34 #define NMEA_DOP_FACTOR             (5)                             /**< Factor for translating DOP to meters */
35
36 #ifdef  __cplusplus
37 extern "C" {
38 #endif /* __cplusplus */
39
40 /*
41  * degree VS radian
42  */
43
44 double nmea_degree2radian(const double val);
45 double nmea_radian2degree(const double val);
46
47 /*
48  * NDEG (NMEA degree)
49  */
50
51 double nmea_ndeg2degree(const double val);
52 double nmea_degree2ndeg(const double val);
53
54 double nmea_ndeg2radian(const double val);
55 double nmea_radian2ndeg(const double val);
56
57 /*
58  * DOP
59  */
60
61 double nmea_calc_pdop(const double hdop, const double vdop);
62 double nmea_dop2meters(const double dop);
63 double nmea_meters2dop(const double meters);
64
65 /*
66  * positions work
67  */
68
69 void nmea_info2pos(const nmeaINFO *info, nmeaPOS *pos);
70 void nmea_pos2info(const nmeaPOS *pos, nmeaINFO *info);
71
72 double nmea_distance(const nmeaPOS *from_pos, const nmeaPOS *to_pos);
73
74 double nmea_distance_ellipsoid(const nmeaPOS *from_pos, const nmeaPOS *to_pos, double *from_azimuth,
75                 double *to_azimuth);
76
77 int nmea_move_horz(const nmeaPOS *start_pos, nmeaPOS *end_pos, double azimuth, double distance);
78
79 int nmea_move_horz_ellipsoid(const nmeaPOS *start_pos, nmeaPOS *end_pos, double azimuth, double distance,
80                 double *end_azimuth);
81
82 #ifdef  __cplusplus
83 }
84 #endif /* __cplusplus */
85
86 #endif /* __NMEA_GMATH_H__ */