flatEarthCS.h

Go to the documentation of this file.

/*********************************************************************
** Copyright (c) 2025 MAK Technologies, Inc.
** All rights reserved.
*********************************************************************/
/*********************************************************************
** $RCSfile: flatEarthCrdSys.h,v $ $Revision: 1.14 $ $State: Exp $
*********************************************************************/
#ifndef flatEarthCS_H_
#define flatEarthCS_H_

//
// \file flatEarthCrdSys.h Contains the flat earth coordinate system class declaration.
// 

#include "terrainCS/terrainCSDefines.h"
#include "terrainCS/coordSystem.h"

//
// Instances of DtFlatEarthCS are used by the terrain objects
// for performing coordinate conversions from geocentric to flat earth.
class DT_DLL_terrainCS DtFlatEarthCS : public Coordinate_System
{
public:
   // constructor
   DtFlatEarthCS(double refLatitude,
      double refLongitude, bool setUseDynamicSceneOrigin = false,
      double dynamicSceneOriginDeadband = 0.0);

   DtFlatEarthCS(bool setUseDynamicSceneOrigin = false,
      double dynamicSceneOriginDeadband = 0.0);

   // copy constructor
   DtFlatEarthCS(const DtFlatEarthCS& orig);

   // destructor
   virtual ~DtFlatEarthCS() override;

   // assignment operator
   DtFlatEarthCS& operator=(const DtFlatEarthCS& orig);

   // Clone operator
   virtual Coordinate_System *clone() const override;

   // coordinates in the local (i.e., projected) coordinate system only
   // consist of X and Y, but we use a three element vector to store them so a
   // programmer can use the Z value for height above terrain.
   virtual void dis2local(const DtVector &in, DtVector &out) const override;
   virtual void local2dis(const DtVector &in, DtVector &out) const override;

   virtual DtVector down(const DtVector &location) const override;
   virtual void topoToLocal(const DtVector &localPosition,
                            DtDcm &topoToLocal) const override;
   virtual void localToTopo(const DtVector &localPosition,
                            DtDcm &localToTopo) const override;

   // Returns the geodetic coordinate for a given local position.
   virtual void localToGeodetic(const DtVector &localPosition,
                   DtGeodeticCoord &geodeticPosition) const override;

   // Returns the local coordinate for a given geodetic position.
   virtual void geodeticToLocal(const DtGeodeticCoord &geodeticPosition,
                                DtVector &localPosition) const override;

   virtual void initFromLatLon(double latRadians, double lonRadians);

   virtual void init();

   // Returns name of coordinate system
   virtual DtString coordinateSystemName() const override;
   virtual void setOrigin(const DtGeodeticCoord &c) override;

   // Override as UTM grid declination calculations should not be used for this
   virtual DtDcm topoToUtmMatrix(const DtVector& geocLoc) const;
   virtual DtDcm utmToTopoMatrix(const DtVector& geocLoc) const;

protected:
   double myRefLatitude;
   double myRefLongitude;

public:
   // Radius of the earth used in the Multigen Flat Earth projection.
   // (defined to be 6366707.02 meters).
   // This value was taken from the SRM_EOR_MFE enumerant in the 
   // SRM_Ellipsoid_Of_Revolution table on the SEDRIS web site 
   // (www.sedris.org).
   static const double theMultigenFlatEarthRadius;
};

#endif