eqdc.hpp 8.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226
  1. // Boost.Geometry - gis-projections (based on PROJ4)
  2. // Copyright (c) 2008-2015 Barend Gehrels, Amsterdam, the Netherlands.
  3. // This file was modified by Oracle on 2017, 2018.
  4. // Modifications copyright (c) 2017-2018, Oracle and/or its affiliates.
  5. // Contributed and/or modified by Adam Wulkiewicz, on behalf of Oracle.
  6. // Use, modification and distribution is subject to the Boost Software License,
  7. // Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
  8. // http://www.boost.org/LICENSE_1_0.txt)
  9. // This file is converted from PROJ4, http://trac.osgeo.org/proj
  10. // PROJ4 is originally written by Gerald Evenden (then of the USGS)
  11. // PROJ4 is maintained by Frank Warmerdam
  12. // PROJ4 is converted to Boost.Geometry by Barend Gehrels
  13. // Last updated version of proj: 5.0.0
  14. // Original copyright notice:
  15. // Permission is hereby granted, free of charge, to any person obtaining a
  16. // copy of this software and associated documentation files (the "Software"),
  17. // to deal in the Software without restriction, including without limitation
  18. // the rights to use, copy, modify, merge, publish, distribute, sublicense,
  19. // and/or sell copies of the Software, and to permit persons to whom the
  20. // Software is furnished to do so, subject to the following conditions:
  21. // The above copyright notice and this permission notice shall be included
  22. // in all copies or substantial portions of the Software.
  23. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  24. // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  25. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  26. // THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  27. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  28. // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  29. // DEALINGS IN THE SOFTWARE.
  30. #ifndef BOOST_GEOMETRY_PROJECTIONS_EQDC_HPP
  31. #define BOOST_GEOMETRY_PROJECTIONS_EQDC_HPP
  32. #include <boost/geometry/srs/projections/impl/base_static.hpp>
  33. #include <boost/geometry/srs/projections/impl/base_dynamic.hpp>
  34. #include <boost/geometry/srs/projections/impl/factory_entry.hpp>
  35. #include <boost/geometry/srs/projections/impl/pj_mlfn.hpp>
  36. #include <boost/geometry/srs/projections/impl/pj_msfn.hpp>
  37. #include <boost/geometry/srs/projections/impl/pj_param.hpp>
  38. #include <boost/geometry/srs/projections/impl/projects.hpp>
  39. #include <boost/geometry/util/math.hpp>
  40. #include <boost/math/special_functions/hypot.hpp>
  41. namespace boost { namespace geometry
  42. {
  43. namespace projections
  44. {
  45. #ifndef DOXYGEN_NO_DETAIL
  46. namespace detail { namespace eqdc
  47. {
  48. static const double epsilon10 = 1.e-10;
  49. template <typename T>
  50. struct par_eqdc
  51. {
  52. T phi1;
  53. T phi2;
  54. T n;
  55. T rho0;
  56. T c;
  57. detail::en<T> en;
  58. bool ellips;
  59. };
  60. // template class, using CRTP to implement forward/inverse
  61. template <typename T, typename Parameters>
  62. struct base_eqdc_ellipsoid
  63. : public base_t_fi<base_eqdc_ellipsoid<T, Parameters>, T, Parameters>
  64. {
  65. par_eqdc<T> m_proj_parm;
  66. inline base_eqdc_ellipsoid(const Parameters& par)
  67. : base_t_fi<base_eqdc_ellipsoid<T, Parameters>, T, Parameters>(*this, par)
  68. {}
  69. // FORWARD(e_forward) sphere & ellipsoid
  70. // Project coordinates from geographic (lon, lat) to cartesian (x, y)
  71. inline void fwd(T lp_lon, T const& lp_lat, T& xy_x, T& xy_y) const
  72. {
  73. T rho = 0.0;
  74. rho = this->m_proj_parm.c - (this->m_proj_parm.ellips ? pj_mlfn(lp_lat, sin(lp_lat),
  75. cos(lp_lat), this->m_proj_parm.en) : lp_lat);
  76. xy_x = rho * sin( lp_lon *= this->m_proj_parm.n );
  77. xy_y = this->m_proj_parm.rho0 - rho * cos(lp_lon);
  78. }
  79. // INVERSE(e_inverse) sphere & ellipsoid
  80. // Project coordinates from cartesian (x, y) to geographic (lon, lat)
  81. inline void inv(T xy_x, T xy_y, T& lp_lon, T& lp_lat) const
  82. {
  83. static T const half_pi = detail::half_pi<T>();
  84. T rho = 0.0;
  85. if ((rho = boost::math::hypot(xy_x, xy_y = this->m_proj_parm.rho0 - xy_y)) != 0.0 ) {
  86. if (this->m_proj_parm.n < 0.) {
  87. rho = -rho;
  88. xy_x = -xy_x;
  89. xy_y = -xy_y;
  90. }
  91. lp_lat = this->m_proj_parm.c - rho;
  92. if (this->m_proj_parm.ellips)
  93. lp_lat = pj_inv_mlfn(lp_lat, this->m_par.es, this->m_proj_parm.en);
  94. lp_lon = atan2(xy_x, xy_y) / this->m_proj_parm.n;
  95. } else {
  96. lp_lon = 0.;
  97. lp_lat = this->m_proj_parm.n > 0. ? half_pi : -half_pi;
  98. }
  99. }
  100. static inline std::string get_name()
  101. {
  102. return "eqdc_ellipsoid";
  103. }
  104. };
  105. // Equidistant Conic
  106. template <typename Params, typename Parameters, typename T>
  107. inline void setup_eqdc(Params const& params, Parameters& par, par_eqdc<T>& proj_parm)
  108. {
  109. T cosphi, sinphi;
  110. int secant;
  111. proj_parm.phi1 = pj_get_param_r<T, srs::spar::lat_1>(params, "lat_1", srs::dpar::lat_1);
  112. proj_parm.phi2 = pj_get_param_r<T, srs::spar::lat_2>(params, "lat_2", srs::dpar::lat_2);
  113. if (fabs(proj_parm.phi1 + proj_parm.phi2) < epsilon10)
  114. BOOST_THROW_EXCEPTION( projection_exception(error_conic_lat_equal) );
  115. proj_parm.en = pj_enfn<T>(par.es);
  116. proj_parm.n = sinphi = sin(proj_parm.phi1);
  117. cosphi = cos(proj_parm.phi1);
  118. secant = fabs(proj_parm.phi1 - proj_parm.phi2) >= epsilon10;
  119. if( (proj_parm.ellips = (par.es > 0.)) ) {
  120. double ml1, m1;
  121. m1 = pj_msfn(sinphi, cosphi, par.es);
  122. ml1 = pj_mlfn(proj_parm.phi1, sinphi, cosphi, proj_parm.en);
  123. if (secant) { /* secant cone */
  124. sinphi = sin(proj_parm.phi2);
  125. cosphi = cos(proj_parm.phi2);
  126. proj_parm.n = (m1 - pj_msfn(sinphi, cosphi, par.es)) /
  127. (pj_mlfn(proj_parm.phi2, sinphi, cosphi, proj_parm.en) - ml1);
  128. }
  129. proj_parm.c = ml1 + m1 / proj_parm.n;
  130. proj_parm.rho0 = proj_parm.c - pj_mlfn(par.phi0, sin(par.phi0),
  131. cos(par.phi0), proj_parm.en);
  132. } else {
  133. if (secant)
  134. proj_parm.n = (cosphi - cos(proj_parm.phi2)) / (proj_parm.phi2 - proj_parm.phi1);
  135. proj_parm.c = proj_parm.phi1 + cos(proj_parm.phi1) / proj_parm.n;
  136. proj_parm.rho0 = proj_parm.c - par.phi0;
  137. }
  138. }
  139. }} // namespace detail::eqdc
  140. #endif // doxygen
  141. /*!
  142. \brief Equidistant Conic projection
  143. \ingroup projections
  144. \tparam Geographic latlong point type
  145. \tparam Cartesian xy point type
  146. \tparam Parameters parameter type
  147. \par Projection characteristics
  148. - Conic
  149. - Spheroid
  150. - Ellipsoid
  151. \par Projection parameters
  152. - lat_1: Latitude of first standard parallel (degrees)
  153. - lat_2: Latitude of second standard parallel (degrees)
  154. \par Example
  155. \image html ex_eqdc.gif
  156. */
  157. template <typename T, typename Parameters>
  158. struct eqdc_ellipsoid : public detail::eqdc::base_eqdc_ellipsoid<T, Parameters>
  159. {
  160. template <typename Params>
  161. inline eqdc_ellipsoid(Params const& params, Parameters const& par)
  162. : detail::eqdc::base_eqdc_ellipsoid<T, Parameters>(par)
  163. {
  164. detail::eqdc::setup_eqdc(params, this->m_par, this->m_proj_parm);
  165. }
  166. };
  167. #ifndef DOXYGEN_NO_DETAIL
  168. namespace detail
  169. {
  170. // Static projection
  171. BOOST_GEOMETRY_PROJECTIONS_DETAIL_STATIC_PROJECTION(srs::spar::proj_eqdc, eqdc_ellipsoid, eqdc_ellipsoid)
  172. // Factory entry(s)
  173. BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_ENTRY_FI(eqdc_entry, eqdc_ellipsoid)
  174. BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_INIT_BEGIN(eqdc_init)
  175. {
  176. BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_INIT_ENTRY(eqdc, eqdc_entry);
  177. }
  178. } // namespace detail
  179. #endif // doxygen
  180. } // namespace projections
  181. }} // namespace boost::geometry
  182. #endif // BOOST_GEOMETRY_PROJECTIONS_EQDC_HPP