oea.hpp 7.7 KB

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