boost/geometry/srs/projections/impl/projects.hpp

   1 // Boost.Geometry (aka GGL, Generic Geometry Library)
   2 // This file is manually converted from PROJ4 (projects.h)
   3
   4 // Copyright (c) 2008-2012 Barend Gehrels, Amsterdam, the Netherlands.
   5
   6 // This file was modified by Oracle on 2017, 2018.
   7 // Modifications copyright (c) 2017-2018, Oracle and/or its affiliates.
   8 // Contributed and/or modified by Adam Wulkiewicz, on behalf of Oracle
   9
  10 // Use, modification and distribution is subject to the Boost Software License,
  11 // Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
  12 // http://www.boost.org/LICENSE_1_0.txt)
  13
  14 // This file is converted from PROJ4, http://trac.osgeo.org/proj
  15 // PROJ4 is originally written by Gerald Evenden (then of the USGS)
  16 // PROJ4 is maintained by Frank Warmerdam
  17 // PROJ4 is converted to Geometry Library by Barend Gehrels (Geodan, Amsterdam)
  18
  19 // Original copyright notice:
  20
  21 // Permission is hereby granted, free of charge, to any person obtaining a
  22 // copy of this software and associated documentation files (the "Software"),
  23 // to deal in the Software without restriction, including without limitation
  24 // the rights to use, copy, modify, merge, publish, distribute, sublicense,
  25 // and/or sell copies of the Software, and to permit persons to whom the
  26 // Software is furnished to do so, subject to the following conditions:
  27
  28 // The above copyright notice and this permission notice shall be included
  29 // in all copies or substantial portions of the Software.
  30
  31 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  32 // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  33 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  34 // THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  35 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  36 // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  37 // DEALINGS IN THE SOFTWARE.
  38
  39 #ifndef BOOST_GEOMETRY_PROJECTIONS_IMPL_PROJECTS_HPP
  40 #define BOOST_GEOMETRY_PROJECTIONS_IMPL_PROJECTS_HPP
  41
  42
  43 #include <cstring>
  44 #include <string>
  45 #include <vector>
  46
  47 #include <boost/config.hpp>
  48 #include <boost/geometry/srs/projections/constants.hpp>
  49 #include <boost/geometry/srs/projections/dpar.hpp>
  50 #include <boost/geometry/srs/projections/spar.hpp>
  51 #include <boost/mpl/if.hpp>
  52 #include <boost/type_traits/is_pod.hpp>
  53
  54
  55 namespace boost { namespace geometry { namespace projections
  56 {
  57
  58 #ifndef DOXYGEN_NO_DETAIL
  59 namespace detail
  60 {
  61
  62 /* datum_type values */
  63 enum datum_type
  64 {
  65     datum_unknown   = 0,
  66     datum_3param    = 1,
  67     datum_7param    = 2,
  68     datum_gridshift = 3,
  69     datum_wgs84     = 4  /* WGS84 (or anything considered equivelent) */
  70 };
  71
  72 // Originally defined in proj_internal.h
  73 //enum pj_io_units {
  74 //    pj_io_units_whatever  = 0,  /* Doesn't matter (or depends on pipeline neighbours) */
  75 //    pj_io_units_classic   = 1,  /* Scaled meters (right), projected system */
  76 //    pj_io_units_projected = 2,  /* Meters, projected system */
  77 //    pj_io_units_cartesian = 3,  /* Meters, 3D cartesian system */
  78 //    pj_io_units_angular   = 4   /* Radians */
  79 //};
  80
  81 // Originally defined in proj_internal.h
  82 /* Maximum latitudinal overshoot accepted */
  83 //static const double pj_epsilon_lat = 1e-12;
  84
  85 template <typename T>
  86 struct pj_consts
  87 {
  88     // E L L I P S O I D     P A R A M E T E R S
  89
  90     T a;                            /* semimajor axis (radius if eccentricity==0) */
  91     T ra;                           /* 1/a */
  92
  93     T e;                            /* first  eccentricity */
  94     T es;                           /* first  eccentricity squared */
  95     T one_es;                       /* 1 - e^2 */
  96     T rone_es;                      /* 1/one_es */
  97
  98     T es_orig, a_orig;              /* es and a before any +proj related adjustment */
  99
 100     // C A R T O G R A P H I C       O F F S E T S
 101
 102     T lam0, phi0;                   /* central longitude, latitude */
 103     T x0, y0/*, z0, t0*/;           /* false easting and northing (and height and time) */
 104
 105     // S C A L I N G
 106
 107     T k0;                           /* general scaling factor */
 108     T to_meter, fr_meter;           /* cartesian scaling */
 109     T vto_meter, vfr_meter;         /* Vertical scaling. Internal unit [m] */
 110
 111     // D A T U M S   A N D   H E I G H T   S Y S T E M S
 112
 113     T from_greenwich;               /* prime meridian offset (in radians) */
 114     T long_wrap_center;             /* 0.0 for -180 to 180, actually in radians*/
 115
 116     srs::detail::towgs84<T> datum_params; /* Parameters for 3PARAM and 7PARAM */
 117     srs::detail::nadgrids nadgrids;       /* Names of horozontal grid files. */
 118     detail::datum_type datum_type;        /* PJD_UNKNOWN/3PARAM/7PARAM/GRIDSHIFT/WGS84 */
 119
 120     bool is_long_wrap_set;
 121
 122     // C O O R D I N A T E   H A N D L I N G
 123
 124     bool over;                       /* over-range flag */
 125     bool geoc;                       /* geocentric latitude flag */
 126     bool is_latlong;                 /* proj=latlong ... not really a projection at all */
 127     bool is_geocent;                 /* proj=geocent ... not really a projection at all */
 128     //bool need_ellps;                 /* 0 for operations that are purely cartesian */
 129
 130     //enum pj_io_units left;          /* Flags for input/output coordinate types */
 131     //enum pj_io_units right;
 132
 133     // Initialize all variables
 134     pj_consts()
 135         : a(0), ra(0)
 136         , e(0), es(0), one_es(0), rone_es(0)
 137         , es_orig(0), a_orig(0)
 138         , lam0(0), phi0(0)
 139         , x0(0), y0(0)/*, z0(0), t0(0)*/
 140         , k0(0) , to_meter(0), fr_meter(0), vto_meter(0), vfr_meter(0)
 141         , from_greenwich(0), long_wrap_center(0)
 142         , datum_type(datum_unknown)
 143         , is_long_wrap_set(false)
 144         , over(false), geoc(false), is_latlong(false), is_geocent(false)
 145         //, need_ellps(true)
 146         //, left(PJ_IO_UNITS_ANGULAR), right(PJ_IO_UNITS_CLASSIC)
 147     {}
 148 };
 149
 150 // PROJ4 complex. Might be replaced with std::complex
 151 template <typename T>
 152 struct pj_complex { T r, i; };
 153
 154 } // namespace detail
 155 #endif // DOXYGEN_NO_DETAIL
 156
 157 /*!
 158     \brief parameters, projection parameters
 159     \details This structure initializes all projections
 160     \ingroup projection
 161 */
 162 template <typename T>
 163 struct parameters : public detail::pj_consts<T>
 164 {
 165     typedef T type;
 166
 167     struct proj_id
 168     {
 169         proj_id()
 170             : id(srs::dpar::proj_unknown)
 171         {}
 172
 173         proj_id(srs::dpar::value_proj i)
 174             : id(i)
 175         {}
 176
 177         proj_id(std::string const& s)
 178             : id(srs::dpar::proj_unknown)
 179             , name(s)
 180         {}
 181
 182         bool is_unknown() const
 183         {
 184             return id == srs::dpar::proj_unknown && name.empty();
 185         }
 186
 187         // Either one of these is set:
 188         srs::dpar::value_proj id; // id of projection
 189         std::string name; // name of projection
 190     };
 191
 192     proj_id id;
 193 };
 194
 195 }}} // namespace boost::geometry::projections
 196 #endif // BOOST_GEOMETRY_PROJECTIONS_IMPL_PROJECTS_HPP