UTMUPS.hpp

Go to the documentation of this file.

#if !defined(GEOGRAPHICLIB_UTMUPS_HPP)
#define GEOGRAPHICLIB_UTMUPS_HPP 1

#include <GeographicLib/Constants.hpp>

namespace GeographicLib {

  class GEOGRAPHICLIB_EXPORT UTMUPS {
  private:
    typedef Math::real real;
    static const int falseeasting_[4];
    static const int falsenorthing_[4];
    static const int mineasting_[4];
    static const int maxeasting_[4];
    static const int minnorthing_[4];
    static const int maxnorthing_[4];
    static const int epsg01N = 32601; // EPSG code for UTM 01N
    static const int epsg60N = 32660; // EPSG code for UTM 60N
    static const int epsgN   = 32661; // EPSG code for UPS   N
    static const int epsg01S = 32701; // EPSG code for UTM 01S
    static const int epsg60S = 32760; // EPSG code for UTM 60S
    static const int epsgS   = 32761; // EPSG code for UPS   S
    static real CentralMeridian(int zone)
    { return real(6 * zone - 183); }
    // Throw an error if easting or northing are outside standard ranges.  If
    // throwp = false, return bool instead.
    static bool CheckCoords(bool utmp, bool northp, real x, real y,
                            bool msgrlimits = false, bool throwp = true);
    UTMUPS();                   // Disable constructor

  public:

    enum zonespec {
      MINPSEUDOZONE = -4,
      INVALID = -4,
      MATCH = -3,
      UTM = -2,
      STANDARD = -1,
      MAXPSEUDOZONE = -1,
      MINZONE = 0,
      UPS = 0,
      MINUTMZONE = 1,
      MAXUTMZONE = 60,
      MAXZONE = 60,
    };

    static int StandardZone(real lat, real lon, int setzone = STANDARD);

    static void Forward(real lat, real lon,
                        int& zone, bool& northp, real& x, real& y,
                        real& gamma, real& k,
                        int setzone = STANDARD, bool mgrslimits = false);

    static void Reverse(int zone, bool northp, real x, real y,
                        real& lat, real& lon, real& gamma, real& k,
                        bool mgrslimits = false);

    static void Forward(real lat, real lon,
                        int& zone, bool& northp, real& x, real& y,
                        int setzone = STANDARD, bool mgrslimits = false) {
      real gamma, k;
      Forward(lat, lon, zone, northp, x, y, gamma, k, setzone, mgrslimits);
    }

    static void Reverse(int zone, bool northp, real x, real y,
                        real& lat, real& lon, bool mgrslimits = false) {
      real gamma, k;
      Reverse(zone, northp, x, y, lat, lon, gamma, k, mgrslimits);
    }

    static void Transfer(int zonein, bool northpin, real xin, real yin,
                         int zoneout, bool northpout, real& xout, real& yout,
                         int& zone);

    static void DecodeZone(const std::string& zonestr,
                           int& zone, bool& northp);

    static std::string EncodeZone(int zone, bool northp, bool abbrev = true);

    static void DecodeEPSG(int epsg, int& zone, bool& northp);

    static int EncodeEPSG(int zone, bool northp);

    static Math::real UTMShift();


    static Math::real MajorRadius()
    { return Constants::WGS84_a(); }

    static Math::real Flattening()
    { return Constants::WGS84_f(); }

  };

} // namespace GeographicLib

#endif  // GEOGRAPHICLIB_UTMUPS_HPP