include/vrvUtil/DtUtmCoordinateConverter.h

Go to the documentation of this file.

/****************************************************************************** 
** Copyright (c) 2007 MAK Technologies, Inc. 
** All rights reserved. 
******************************************************************************/ 
/*********************************************************************
** $RCSfile: DtUtmCoordinateConverter.h,v $ $Revision: 1.13 $ $State: Exp $
*********************************************************************/


#ifndef DtUtmCoordinateConverter_H_
#define DtUtmCoordinateConverter_H_

#include <vrvUtil/DtCoordinateConverter.h>

namespace makVrv
{

class DT_DLL_VRVUTIL DtUtmCoordinateConverter : public DtCoordinateConverter
{
public:

   DtUtmCoordinateConverter();

   virtual ~DtUtmCoordinateConverter();

   virtual DtCoordinateConverter* clone() const;

   virtual void init(double lat, double lon, long zone = 0, int useStandardOffsets = 0);

   virtual void init(double lat, double lon, double z, long zone = 0, int useStandardOffsets = 0);

   virtual void init(const DtGeodeticCoord& origin, long zone = 0, int useStandardOffsets = 0);

   virtual void init(DtDegMinSec lat, DtDegMinSec lon, long zone = 0, int useStandardOffsets = 0);

   virtual void init(DtDegMinSec lat, DtDegMinSec lon, double z, long zone = 0, int useStandardOffsets = 0);

   virtual void init(long zone, char hemisphere = 'N', bool useMpiDefaultOrigin = true);

   virtual void init(double falseOriginX, double falseOriginY, double falseOriginZ,
      long zone, char hemisphere = 'N', bool useMpiDefaultOrigin = true);

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

   virtual std::string stringRep();

   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;

   virtual const DtUtmReferencePoint* referencePoint() const;

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

   virtual void setupTopoFrame(const DtVector& truth);
   
protected:

   std::string parseUtm( DtDegMinSec lat, 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 );

   // Useful functions for dealing with vrlink Utm Ref Point routines that use DtDegMinSec
   static void setLatDtDegMinSecFromDegrees(DtDegMinSec& dmslat, double deg);
   static void setLonDtDegMinSecFromDegrees(DtDegMinSec& dmslon, double deg);
   
   // 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 );

protected:

   // Used by setLatDtDegMinSecFromDegrees and setLonDtDegMinSecFromDegrees
   static void setDtDegMinSecFromDegrees(DtDegMinSec& dms, double deg);

   
private:

   DtUtmCoordinateConverter(const DtUtmCoordinateConverter& orig);

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

   mutable DtUtmReferencePoint myReferencePoint;

   bool myUseStandardOffsets;
};

}

#endif