oea.hpp 8.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198
  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_OEA_HPP
  31. #define BOOST_GEOMETRY_PROJECTIONS_OEA_HPP
  32. #include <boost/math/special_functions/hypot.hpp>
  33. #include <boost/geometry/srs/projections/impl/aasincos.hpp>
  34. #include <boost/geometry/srs/projections/impl/base_static.hpp>
  35. #include <boost/geometry/srs/projections/impl/base_dynamic.hpp>
  36. #include <boost/geometry/srs/projections/impl/factory_entry.hpp>
  37. #include <boost/geometry/srs/projections/impl/pj_param.hpp>
  38. #include <boost/geometry/srs/projections/impl/projects.hpp>
  39. namespace boost { namespace geometry
  40. {
  41. namespace projections
  42. {
  43. #ifndef DOXYGEN_NO_DETAIL
  44. namespace detail { namespace oea
  45. {
  46. template <typename T>
  47. struct par_oea
  48. {
  49. T theta;
  50. T m, n;
  51. T two_r_m, two_r_n, rm, rn, hm, hn;
  52. T cp0, sp0;
  53. };
  54. // template class, using CRTP to implement forward/inverse
  55. template <typename T, typename Parameters>
  56. struct base_oea_spheroid
  57. : public base_t_fi<base_oea_spheroid<T, Parameters>, T, Parameters>
  58. {
  59. par_oea<T> m_proj_parm;
  60. inline base_oea_spheroid(const Parameters& par)
  61. : base_t_fi<base_oea_spheroid<T, Parameters>, T, Parameters>(*this, par)
  62. {}
  63. // FORWARD(s_forward) sphere
  64. // Project coordinates from geographic (lon, lat) to cartesian (x, y)
  65. inline void fwd(T const& lp_lon, T const& lp_lat, T& xy_x, T& xy_y) const
  66. {
  67. T Az, M, N, cp, sp, cl, shz;
  68. cp = cos(lp_lat);
  69. sp = sin(lp_lat);
  70. cl = cos(lp_lon);
  71. Az = aatan2(cp * sin(lp_lon), this->m_proj_parm.cp0 * sp - this->m_proj_parm.sp0 * cp * cl) + this->m_proj_parm.theta;
  72. shz = sin(0.5 * aacos(this->m_proj_parm.sp0 * sp + this->m_proj_parm.cp0 * cp * cl));
  73. M = aasin(shz * sin(Az));
  74. N = aasin(shz * cos(Az) * cos(M) / cos(M * this->m_proj_parm.two_r_m));
  75. xy_y = this->m_proj_parm.n * sin(N * this->m_proj_parm.two_r_n);
  76. xy_x = this->m_proj_parm.m * sin(M * this->m_proj_parm.two_r_m) * cos(N) / cos(N * this->m_proj_parm.two_r_n);
  77. }
  78. // INVERSE(s_inverse) sphere
  79. // Project coordinates from cartesian (x, y) to geographic (lon, lat)
  80. inline void inv(T const& xy_x, T const& xy_y, T& lp_lon, T& lp_lat) const
  81. {
  82. T N, M, xp, yp, z, Az, cz, sz, cAz;
  83. N = this->m_proj_parm.hn * aasin(xy_y * this->m_proj_parm.rn);
  84. M = this->m_proj_parm.hm * aasin(xy_x * this->m_proj_parm.rm * cos(N * this->m_proj_parm.two_r_n) / cos(N));
  85. xp = 2. * sin(M);
  86. yp = 2. * sin(N) * cos(M * this->m_proj_parm.two_r_m) / cos(M);
  87. cAz = cos(Az = aatan2(xp, yp) - this->m_proj_parm.theta);
  88. z = 2. * aasin(0.5 * boost::math::hypot(xp, yp));
  89. sz = sin(z);
  90. cz = cos(z);
  91. lp_lat = aasin(this->m_proj_parm.sp0 * cz + this->m_proj_parm.cp0 * sz * cAz);
  92. lp_lon = aatan2(sz * sin(Az),
  93. this->m_proj_parm.cp0 * cz - this->m_proj_parm.sp0 * sz * cAz);
  94. }
  95. static inline std::string get_name()
  96. {
  97. return "oea_spheroid";
  98. }
  99. };
  100. // Oblated Equal Area
  101. template <typename Params, typename Parameters, typename T>
  102. inline void setup_oea(Params const& params, Parameters& par, par_oea<T>& proj_parm)
  103. {
  104. if (((proj_parm.n = pj_get_param_f<T, srs::spar::n>(params, "n", srs::dpar::n)) <= 0.) ||
  105. ((proj_parm.m = pj_get_param_f<T, srs::spar::m>(params, "m", srs::dpar::m)) <= 0.)) {
  106. BOOST_THROW_EXCEPTION( projection_exception(error_invalid_m_or_n) );
  107. } else {
  108. proj_parm.theta = pj_get_param_r<T, srs::spar::theta>(params, "theta", srs::dpar::theta);
  109. proj_parm.sp0 = sin(par.phi0);
  110. proj_parm.cp0 = cos(par.phi0);
  111. proj_parm.rn = 1./ proj_parm.n;
  112. proj_parm.rm = 1./ proj_parm.m;
  113. proj_parm.two_r_n = 2. * proj_parm.rn;
  114. proj_parm.two_r_m = 2. * proj_parm.rm;
  115. proj_parm.hm = 0.5 * proj_parm.m;
  116. proj_parm.hn = 0.5 * proj_parm.n;
  117. par.es = 0.;
  118. }
  119. }
  120. }} // namespace detail::oea
  121. #endif // doxygen
  122. /*!
  123. \brief Oblated Equal Area projection
  124. \ingroup projections
  125. \tparam Geographic latlong point type
  126. \tparam Cartesian xy point type
  127. \tparam Parameters parameter type
  128. \par Projection characteristics
  129. - Miscellaneous
  130. - Spheroid
  131. \par Projection parameters
  132. - n (real)
  133. - m (real)
  134. - theta: Theta (degrees)
  135. \par Example
  136. \image html ex_oea.gif
  137. */
  138. template <typename T, typename Parameters>
  139. struct oea_spheroid : public detail::oea::base_oea_spheroid<T, Parameters>
  140. {
  141. template <typename Params>
  142. inline oea_spheroid(Params const& params, Parameters const& par)
  143. : detail::oea::base_oea_spheroid<T, Parameters>(par)
  144. {
  145. detail::oea::setup_oea(params, this->m_par, this->m_proj_parm);
  146. }
  147. };
  148. #ifndef DOXYGEN_NO_DETAIL
  149. namespace detail
  150. {
  151. // Static projection
  152. BOOST_GEOMETRY_PROJECTIONS_DETAIL_STATIC_PROJECTION(srs::spar::proj_oea, oea_spheroid, oea_spheroid)
  153. // Factory entry(s)
  154. BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_ENTRY_FI(oea_entry, oea_spheroid)
  155. BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_INIT_BEGIN(oea_init)
  156. {
  157. BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_INIT_ENTRY(oea, oea_entry)
  158. }
  159. } // namespace detail
  160. #endif // doxygen
  161. } // namespace projections
  162. }} // namespace boost::geometry
  163. #endif // BOOST_GEOMETRY_PROJECTIONS_OEA_HPP