// Boost.Geometry - gis-projections (based on PROJ4) // Copyright (c) 2008-2015 Barend Gehrels, Amsterdam, the Netherlands. // This file was modified by Oracle on 2017, 2018, 2019. // Modifications copyright (c) 2017-2019, Oracle and/or its affiliates. // Contributed and/or modified by Adam Wulkiewicz, on behalf of Oracle. // Use, modification and distribution is subject to the Boost Software License, // Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at // http://www.boost.org/LICENSE_1_0.txt) // This file is converted from PROJ4, http://trac.osgeo.org/proj // PROJ4 is originally written by Gerald Evenden (then of the USGS) // PROJ4 is maintained by Frank Warmerdam // PROJ4 is converted to Boost.Geometry by Barend Gehrels // Last updated version of proj: 5.0.0 // Original copyright notice: // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // The above copyright notice and this permission notice shall be included // in all copies or substantial portions of the Software. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL // THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. #ifndef BOOST_GEOMETRY_PROJECTIONS_GN_SINU_HPP #define BOOST_GEOMETRY_PROJECTIONS_GN_SINU_HPP #include #include #include #include #include #include #include #include namespace boost { namespace geometry { namespace projections { #ifndef DOXYGEN_NO_DETAIL namespace detail { namespace gn_sinu { static const double epsilon10 = 1e-10; static const int max_iter = 8; static const double loop_tol = 1e-7; template struct par_gn_sinu_e { detail::en en; }; template struct par_gn_sinu_s { T m, n, C_x, C_y; }; /* Ellipsoidal Sinusoidal only */ template struct base_gn_sinu_ellipsoid { par_gn_sinu_e m_proj_parm; // FORWARD(e_forward) ellipsoid // Project coordinates from geographic (lon, lat) to cartesian (x, y) inline void fwd(Parameters const& par, T const& lp_lon, T const& lp_lat, T& xy_x, T& xy_y) const { T s, c; xy_y = pj_mlfn(lp_lat, s = sin(lp_lat), c = cos(lp_lat), this->m_proj_parm.en); xy_x = lp_lon * c / sqrt(1. - par.es * s * s); } // INVERSE(e_inverse) ellipsoid // Project coordinates from cartesian (x, y) to geographic (lon, lat) inline void inv(Parameters const& par, T const& xy_x, T const& xy_y, T& lp_lon, T& lp_lat) const { static const T half_pi = detail::half_pi(); T s; if ((s = fabs(lp_lat = pj_inv_mlfn(xy_y, par.es, this->m_proj_parm.en))) < half_pi) { s = sin(lp_lat); lp_lon = xy_x * sqrt(1. - par.es * s * s) / cos(lp_lat); } else if ((s - epsilon10) < half_pi) lp_lon = 0.; else BOOST_THROW_EXCEPTION( projection_exception(error_tolerance_condition) ); } /* General spherical sinusoidals */ static inline std::string get_name() { return "gn_sinu_ellipsoid"; } }; template struct base_gn_sinu_spheroid { par_gn_sinu_s m_proj_parm; // FORWARD(s_forward) sphere // Project coordinates from geographic (lon, lat) to cartesian (x, y) inline void fwd(Parameters const& , T const& lp_lon, T lp_lat, T& xy_x, T& xy_y) const { if (this->m_proj_parm.m == 0.0) lp_lat = this->m_proj_parm.n != 1. ? aasin(this->m_proj_parm.n * sin(lp_lat)): lp_lat; else { T k, V; int i; k = this->m_proj_parm.n * sin(lp_lat); for (i = max_iter; i ; --i) { lp_lat -= V = (this->m_proj_parm.m * lp_lat + sin(lp_lat) - k) / (this->m_proj_parm.m + cos(lp_lat)); if (fabs(V) < loop_tol) break; } if (!i) { BOOST_THROW_EXCEPTION( projection_exception(error_tolerance_condition) ); } } xy_x = this->m_proj_parm.C_x * lp_lon * (this->m_proj_parm.m + cos(lp_lat)); xy_y = this->m_proj_parm.C_y * lp_lat; } // INVERSE(s_inverse) sphere // Project coordinates from cartesian (x, y) to geographic (lon, lat) inline void inv(Parameters const& , T const& xy_x, T xy_y, T& lp_lon, T& lp_lat) const { xy_y /= this->m_proj_parm.C_y; lp_lat = (this->m_proj_parm.m != 0.0) ? aasin((this->m_proj_parm.m * xy_y + sin(xy_y)) / this->m_proj_parm.n) : ( this->m_proj_parm.n != 1. ? aasin(sin(xy_y) / this->m_proj_parm.n) : xy_y ); lp_lon = xy_x / (this->m_proj_parm.C_x * (this->m_proj_parm.m + cos(xy_y))); } static inline std::string get_name() { return "gn_sinu_spheroid"; } }; template inline void setup(Parameters& par, par_gn_sinu_s& proj_parm) { par.es = 0; proj_parm.C_x = (proj_parm.C_y = sqrt((proj_parm.m + 1.) / proj_parm.n))/(proj_parm.m + 1.); } // General Sinusoidal Series template inline void setup_gn_sinu(Params const& params, Parameters& par, par_gn_sinu_s& proj_parm) { if (pj_param_f(params, "n", srs::dpar::n, proj_parm.n) && pj_param_f(params, "m", srs::dpar::m, proj_parm.m)) { if (proj_parm.n <= 0 || proj_parm.m < 0) BOOST_THROW_EXCEPTION( projection_exception(error_invalid_m_or_n) ); } else BOOST_THROW_EXCEPTION( projection_exception(error_invalid_m_or_n) ); setup(par, proj_parm); } // Sinusoidal (Sanson-Flamsteed) template inline void setup_sinu(Parameters const& par, par_gn_sinu_e& proj_parm) { proj_parm.en = pj_enfn(par.es); } // Sinusoidal (Sanson-Flamsteed) template inline void setup_sinu(Parameters& par, par_gn_sinu_s& proj_parm) { proj_parm.n = 1.; proj_parm.m = 0.; setup(par, proj_parm); } // Eckert VI template inline void setup_eck6(Parameters& par, par_gn_sinu_s& proj_parm) { proj_parm.m = 1.; proj_parm.n = 2.570796326794896619231321691; setup(par, proj_parm); } // McBryde-Thomas Flat-Polar Sinusoidal template inline void setup_mbtfps(Parameters& par, par_gn_sinu_s& proj_parm) { proj_parm.m = 0.5; proj_parm.n = 1.785398163397448309615660845; setup(par, proj_parm); } }} // namespace detail::gn_sinu #endif // doxygen /*! \brief General Sinusoidal Series projection \ingroup projections \tparam Geographic latlong point type \tparam Cartesian xy point type \tparam Parameters parameter type \par Projection characteristics - Pseudocylindrical - Spheroid \par Projection parameters - m (real) - n (real) \par Example \image html ex_gn_sinu.gif */ template struct gn_sinu_spheroid : public detail::gn_sinu::base_gn_sinu_spheroid { template inline gn_sinu_spheroid(Params const& params, Parameters & par) { detail::gn_sinu::setup_gn_sinu(params, par, this->m_proj_parm); } }; /*! \brief Sinusoidal (Sanson-Flamsteed) projection \ingroup projections \tparam Geographic latlong point type \tparam Cartesian xy point type \tparam Parameters parameter type \par Projection characteristics - Pseudocylindrical - Spheroid - Ellipsoid \par Example \image html ex_sinu.gif */ template struct sinu_ellipsoid : public detail::gn_sinu::base_gn_sinu_ellipsoid { template inline sinu_ellipsoid(Params const& , Parameters & par) { detail::gn_sinu::setup_sinu(par, this->m_proj_parm); } }; /*! \brief Sinusoidal (Sanson-Flamsteed) projection \ingroup projections \tparam Geographic latlong point type \tparam Cartesian xy point type \tparam Parameters parameter type \par Projection characteristics - Pseudocylindrical - Spheroid - Ellipsoid \par Example \image html ex_sinu.gif */ template struct sinu_spheroid : public detail::gn_sinu::base_gn_sinu_spheroid { template inline sinu_spheroid(Params const& , Parameters & par) { detail::gn_sinu::setup_sinu(par, this->m_proj_parm); } }; /*! \brief Eckert VI projection \ingroup projections \tparam Geographic latlong point type \tparam Cartesian xy point type \tparam Parameters parameter type \par Projection characteristics - Pseudocylindrical - Spheroid \par Example \image html ex_eck6.gif */ template struct eck6_spheroid : public detail::gn_sinu::base_gn_sinu_spheroid { template inline eck6_spheroid(Params const& , Parameters & par) { detail::gn_sinu::setup_eck6(par, this->m_proj_parm); } }; /*! \brief McBryde-Thomas Flat-Polar Sinusoidal projection \ingroup projections \tparam Geographic latlong point type \tparam Cartesian xy point type \tparam Parameters parameter type \par Projection characteristics - Pseudocylindrical - Spheroid \par Example \image html ex_mbtfps.gif */ template struct mbtfps_spheroid : public detail::gn_sinu::base_gn_sinu_spheroid { template inline mbtfps_spheroid(Params const& , Parameters & par) { detail::gn_sinu::setup_mbtfps(par, this->m_proj_parm); } }; #ifndef DOXYGEN_NO_DETAIL namespace detail { // Static projection BOOST_GEOMETRY_PROJECTIONS_DETAIL_STATIC_PROJECTION_FI(srs::spar::proj_gn_sinu, gn_sinu_spheroid) BOOST_GEOMETRY_PROJECTIONS_DETAIL_STATIC_PROJECTION_FI2(srs::spar::proj_sinu, sinu_spheroid, sinu_ellipsoid) BOOST_GEOMETRY_PROJECTIONS_DETAIL_STATIC_PROJECTION_FI(srs::spar::proj_eck6, eck6_spheroid) BOOST_GEOMETRY_PROJECTIONS_DETAIL_STATIC_PROJECTION_FI(srs::spar::proj_mbtfps, mbtfps_spheroid) // Factory entry(s) BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_ENTRY_FI(gn_sinu_entry, gn_sinu_spheroid) BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_ENTRY_FI2(sinu_entry, sinu_spheroid, sinu_ellipsoid) BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_ENTRY_FI(eck6_entry, eck6_spheroid) BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_ENTRY_FI(mbtfps_entry, mbtfps_spheroid) BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_INIT_BEGIN(gn_sinu_init) { BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_INIT_ENTRY(gn_sinu, gn_sinu_entry); BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_INIT_ENTRY(sinu, sinu_entry); BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_INIT_ENTRY(eck6, eck6_entry); BOOST_GEOMETRY_PROJECTIONS_DETAIL_FACTORY_INIT_ENTRY(mbtfps, mbtfps_entry); } } // namespace detail #endif // doxygen } // namespace projections }} // namespace boost::geometry #endif // BOOST_GEOMETRY_PROJECTIONS_GN_SINU_HPP