DtUtmCoordinateConverter.h

Go to the documentation of this file.

/****************************************************************************** 
** Copyright (c) 2024 MAK Technologies, Inc. 
** All rights reserved. 
******************************************************************************/ 


#ifndef DtUtmCoordinateConverter_H_
#define DtUtmCoordinateConverter_H_

#include <vrvUtil/DtCoordinateConverter.h>
#include <limits>

namespace makVrv
{

class DT_DLL_VRVUTIL DtUtmCoordinateConverter : public DtCoordinateConverter
{
public:

   DtUtmCoordinateConverter();

   virtual ~DtUtmCoordinateConverter();

   virtual DtCoordinateConverter* clone() const override;

   virtual void init(double lat, double lon, long zone = 0, int useStandardOffsets = 0, char hemisphere = 'N', double falseNorthingCrossover = std::numeric_limits<double>::max());

   virtual void init(double lat, double lon, double z, long zone = 0, int useStandardOffsets = 0, char hemisphere = 'N', double falseNorthingCrossover = std::numeric_limits<double>::max());

   virtual void init(const DtGeodeticCoord& origin, long zone = 0, int useStandardOffsets = 0, double falseNorthingCrossover = std::numeric_limits<double>::max());

   virtual void init(const DtDegMinSec& lat, const DtDegMinSec& lon, long zone = 0, int useStandardOffsets = 0, double falseNorthingCrossover = std::numeric_limits<double>::max());

   virtual void init(const DtDegMinSec& lat, const DtDegMinSec& lon, double z, long zone = 0, int useStandardOffsets = 0, double falseNorthingCrossover = std::numeric_limits<double>::max());

   virtual void init(long zone, char hemisphere = 'N', bool useMpiDefaultOrigin = true, double falseNorthingCrossover = std::numeric_limits<double>::max());

   virtual void init(double falseOriginX, double falseOriginY, double falseOriginZ,
      long zone, char hemisphere = 'N', bool useMpiDefaultOrigin = true, double falseNorthingCrossover = std::numeric_limits<double>::max());

   virtual bool init(const std::string& originstring) override;

   virtual std::string stringRep() override;

   virtual const DtGeodeticCoord& origin() const;

   virtual bool useStandardOffsets() const;

   virtual long zone() const;
   virtual void setZone(long zone);

   virtual DtDegMinSec latRef() const;
   virtual DtDegMinSec longRef() const;

   /********************* Conversions *****************************/
   virtual void geocToCig(const DtVector& geoc, DtVector& out) const override;

   virtual void cigToGeoc(const DtVector& in, DtVector& geoc) const override;

   virtual void setupTopoFrame(const DtVector& truth) override;

   virtual DtUtmReferencePoint* referencePoint() const;

protected:

   std::string parseUtm( const DtDegMinSec& lat, const DtDegMinSec& lng, bool bUseStandardOffsets, long zone);

public:

   static DtCoordinateConverter* create();
   static double calculateUtmLongitudeOrigin(double zone, bool useMpiDefaultOrigin = true);
   
   static void calculateUtmLatLonOrigin(double zone, double falseOriginX, double falseOriginY,
      double& latitude, double& longitude, bool useMpiDefaultOrigin = true);
      
   static int utmGridZoneFromLatLon( double latitudeInDegrees, double longitudeInDegrees );
   
   // Get a utm reference point initialized to the zone center and equator for specified
   // geodetic coordinates.
   static void initUtmReferencePointForZone( double longitude, bool standardOffsets,
      const DtMapDatum& datum, DtUtmReferencePoint& refToInitialized );
      
   // returns the zone's central meridian, in degrees
   static double utmZoneToCentralMeridian( int zone );
   
private:

   DtUtmCoordinateConverter(const DtUtmCoordinateConverter& orig) = delete;

   DtUtmCoordinateConverter& operator=(const DtUtmCoordinateConverter& orig) = delete;
   
protected:

   mutable DtUtmReferencePoint myReferencePoint;

   bool myUseStandardOffsets;
};

}

#endif