gmath.h

Go to the documentation of this file.

/*
* Copyright Tim (xtimor@gmail.com)
*
* NMEA library is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program.  If not, see <http://www.gnu.org/licenses/>
*/
/*
 *
 * NMEA library
 * URL: http://nmea.sourceforge.net
 * Author: Tim (xtimor@gmail.com)
 * Licence: http://www.gnu.org/licenses/lgpl.html
 * $Id: gmath.h 17 2008-03-11 11:56:11Z xtimor $
 *
 */

#ifndef __NMEA_GMATH_H__
#define __NMEA_GMATH_H__

#include "info.h"

#define NMEA_PI                     (3.141592653589793)             
#define NMEA_PI180                  (NMEA_PI / 180)                 
#define NMEA_EARTHRADIUS_KM         (6378)                          
#define NMEA_EARTHRADIUS_M          (NMEA_EARTHRADIUS_KM * 1000)    
#define NMEA_EARTH_SEMIMAJORAXIS_M  (6378137.0)                     
#define NMEA_EARTH_SEMIMAJORAXIS_KM (NMEA_EARTHMAJORAXIS_KM / 1000) 
#define NMEA_EARTH_FLATTENING       (1 / 298.257223563)             
#define NMEA_DOP_FACTOR             (5)                             
#ifdef  __cplusplus
extern "C"
{
#endif

  /*
   * degree VS radian
   */

  double nmea_degree2radian( double val );
  double nmea_radian2degree( double val );

  /*
   * NDEG (NMEA degree)
   */

  double nmea_ndeg2degree( double val );
  double nmea_degree2ndeg( double val );

  double nmea_ndeg2radian( double val );
  double nmea_radian2ndeg( double val );

  /*
   * DOP
   */

  double nmea_calc_pdop( double hdop, double vdop );
  double nmea_dop2meters( double dop );
  double nmea_meters2dop( double meters );

  /*
   * positions work
   */

  void nmea_info2pos( const nmeaINFO *info, nmeaPOS *pos );
  void nmea_pos2info( const nmeaPOS *pos, nmeaINFO *info );

  double  nmea_distance(
    const nmeaPOS *from_pos,
    const nmeaPOS *to_pos
  );

  double  nmea_distance_ellipsoid(
    const nmeaPOS *from_pos,
    const nmeaPOS *to_pos,
    double *from_azimuth,
    double *to_azimuth
  );

  int     nmea_move_horz(
    const nmeaPOS *start_pos,
    nmeaPOS *end_pos,
    double azimuth,
    double distance
  );

  int     nmea_move_horz_ellipsoid(
    const nmeaPOS *start_pos,
    nmeaPOS *end_pos,
    double azimuth,
    double distance,
    double *end_azimuth
  );

#ifdef  __cplusplus
}
#endif

#endif /* __NMEA_GMATH_H__ */