include/vrvUtil/DtCoordinateConverter.h

Go to the documentation of this file.

/*********************************************************************
** Copyright (c) 1999 MaK Technologies, Inc.
** All rights reserved.
*********************************************************************/
/*********************************************************************
** $RCSfile: DtCoordinateConverter.h,v $ $Revision: 1.16 $ $State: Exp $
*********************************************************************/


#ifndef DtCoordinateConverter_H_
#define DtCoordinateConverter_H_

#include <vrvUtil/vrvUtil.h>

#include <matrix/geodCoord.h>
#include <matrix/utmRefPt.h>
#include <matrix/vlDcm.h>
#include <matrix/vlVector.h>
#include <string>

namespace makVrv
{

class DT_DLL_VRVUTIL DtCoordinateConverter
{
public:

   static const char* NoOp;       
   static const char* Geocentric; 

   static const char* UTM;        
   static const char* Lambert;    
   static const char* FlatEarth;  
   static const char* Cartesian;  

public:

   typedef DtCoordinateConverter* (*CreatorFn)();

public:

   virtual ~DtCoordinateConverter();

   virtual const std::string& type() const;

   virtual DtCoordinateConverter* clone() const = 0;

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

   virtual std::string stringRep() = 0;

   virtual bool zIsAlt() const;

   virtual bool usesOffsetFile() const;

   virtual DtGeodeticCoord databaseOrigin() const;

   virtual void setGeocOriginOffset(const DtVector& offset){};

   virtual void reset();

   /* inspectors/mutators for DCM's */
   virtual const DtDcm& nedToCigDcm() const;

   virtual const DtDcm& cigToNedDcm() const;

   virtual const DtDcm& geocToCigDcm() const;

   virtual const DtDcm& cigToGeocDcm() const;

   virtual const DtDcm& geocToNedDcm() const;

   
   virtual const DtDcm& cigToEnuDcm() const;

   virtual const DtDcm& nedToGeocDcm() const;

   /*************************** conversions **********************************/
   virtual void geocToCig(const DtVector& geoc, DtVector& out) const = 0;
   virtual void cigToGeoc(const DtVector& in, DtVector& geoc) const = 0;
   
   virtual void setupTopoFrame(const DtVector& truth);

   virtual void cigToEnu_coordTrans(const DtVector& cigPos,
      DtVector& enuPos) const;

   virtual void cigToEnu_vecTrans(const DtVector& cigVec,
      DtVector& enuVec) const;

   virtual void enuToCig_coordTrans(const DtVector& enuPos,
      DtVector& cigPos) const;

   virtual void enuToCig_vecTrans(const DtVector& enuVec,
      DtVector& cigVec) const;

   virtual DtVector& enuToCig_vecTrans(const DtVector& origin,
      const DtVector& offset) const;

   virtual const DtTaitBryan& nedToCig_EulerTrans(
      const DtTaitBryan& topo) const;
  
   /* ---------------------- Utilities ---------------------------- */
   virtual DtVector up(const DtVector& orig) const;

   virtual void topoSurface(const DtVector& o, DtVector& surface) const;

public:

   static double convertToDouble(const std::string& str);
   static double convertToDouble(const DtDegMinSec& dms);
   static DtDegMinSec convertToDmsLat(double deg);
   static DtDegMinSec convertToDmsLon(double deg);

   static bool isCoordinateSystemProjected( const std::string& csType );

protected:

   DtCoordinateConverter(const std::string& t);

   std::string polarDirectionToStr(int dir);

   std::string parseLatLng( DtDegMinSec lat, DtDegMinSec lng);

private:

   DtCoordinateConverter(const DtCoordinateConverter& orig);

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

   std::string myType;
   bool myUsesWarbreaker;
   bool myZAlt;

   DtGeodeticCoord myGeodOrigin;

   DtDcm myNedToGeocDcm;
   DtDcm myGeocToNedDcm;

   DtDcm myNedToCigDcm;
   DtDcm myCigToNedDcm;

   DtDcm myGeocToCigDcm;
   DtDcm myCigToGeocDcm;

   DtDcm myCigToEnuDcm;
   const DtDcm myNedToEnuDcm;

   DtDcm myNed2CigEulerDcm;

   DtVector myLastLocation;
};

void DT_DLL_VRVUTIL DtQuaternionToEulerDeg(const double x, const double y, const double z, 
   const double w, double& yawOut, double& pitchOut, double& rollOut);

void DT_DLL_VRVUTIL DtQuaternionToEulerRad(const double x, const double y, const double z, 
   const double w, double& yawOut, double& pitchOut, double& rollOut);

void DT_DLL_VRVUTIL DtEulerToQuaternionDeg(const double yaw, const double pitch , const double roll, 
   double& xOut, double& yOut, double& zOut, double& wOut);

void DT_DLL_VRVUTIL DtEulerToQuaternionRad(const double yaw, const double pitch , const double roll, 
   double& xOut, double& yOut, double& zOut, double& wOut);

}

#endif