ossimEcefVector.h

Go to the documentation of this file.

//*****************************************************************************
// FILE: ossimEcefVector.h
//
// License:  See top level LICENSE.txt file.
//
// DESCRIPTION:
//   Contains declaration of a 3D vector object in the Earth-centered, earth
//   fixed (ECEF) coordinate system.
//
//   NOTE: There is no associated ossimEcefVector.cc file. All methods are
//         inlined here
//
// SOFTWARE HISTORY:
//>
//   08Aug2001  Oscar Kramer
//              Initial coding.
//<
//*****************************************************************************
//  $Id: ossimEcefVector.h 20043 2011-09-06 15:00:55Z oscarkramer $

#ifndef ossimEcefVector_HEADER
#define ossimEcefVector_HEADER

#include <cmath>
#include <ossim/base/ossimCommon.h>
#include <ossim/base/ossimColumnVector3d.h>
#include <ossim/base/ossimEcefPoint.h>
#include <ossim/base/ossimString.h>
#include <ossim/matrix/newmat.h>

class ossimGpt;

//*****************************************************************************
//  CLASS: ossimEcefVector
//
//*****************************************************************************
class OSSIMDLLEXPORT ossimEcefVector
{
public:
   ossimEcefVector()
      : theData(0,0,0) {}
      
   ossimEcefVector(const ossimEcefVector& copy_this)
      : theData (copy_this.theData) {}

   ossimEcefVector(const NEWMAT::ColumnVector& assign_this)
      : theData (assign_this) {}

   ossimEcefVector(const ossimEcefPoint& from,
                   const ossimEcefPoint& to)
      : theData (to.data() - from.data()) {}
   
   ossimEcefVector(const ossimGpt& from,
                   const ossimGpt& to)
      : theData ((ossimEcefPoint(to) - ossimEcefPoint(from)).data()) {}

   ossimEcefVector(const double& x,
                   const double& y,
                   const double& z)
      : theData(x, y, z) {}

   ossimEcefVector(const ossimColumnVector3d& assign_this)
      : theData(assign_this) {}


   void makeNan()
   {
      theData[0] = ossim::nan();
      theData[1] = ossim::nan();
      theData[2] = ossim::nan();
   }
   
   bool hasNans()const
   {
      return ( ossim::isnan(theData[0]) ||
               ossim::isnan(theData[1]) ||
               ossim::isnan(theData[2]) );
   }
   
   bool isNan()const
   {
      return ( ossim::isnan(theData[0]) &&
               ossim::isnan(theData[1]) &&
               ossim::isnan(theData[2]) );
   }

   inline ossimEcefVector        operator- () const; 
   inline ossimEcefVector        operator+ (const ossimEcefVector&) const;
   inline ossimEcefVector        operator- (const ossimEcefVector&) const;
   inline ossimEcefPoint         operator+ (const ossimEcefPoint&)  const;
   inline ossimEcefVector        operator* (const double&)          const;
   inline ossimEcefVector        operator/ (const double&)          const;
   inline bool                   operator==(const ossimEcefVector&) const;
   inline bool                   operator!=(const ossimEcefVector&) const;
   inline const ossimEcefVector& operator= (const ossimEcefVector&);

   inline double          dot    (const ossimEcefVector&) const;
   inline double          angleTo(const ossimEcefVector&) const; // degrees
   inline ossimEcefVector cross  (const ossimEcefVector&) const;
   inline ossimEcefVector unitVector()                    const;
   inline double          magnitude()                     const; // meters
   inline double          norm2()                         const; // squared meters
   inline double length() const;
   inline double          normalize();
   
   double    x() const { return theData[0]; }
   double&   x()       { return theData[0]; }
   double    y() const { return theData[1]; }
   double&   y()       { return theData[1]; }
   double    z() const { return theData[2]; }
   double&   z()       { return theData[2]; }
   double& operator [](int idx){return theData[idx];}
   const double& operator [](int idx)const{return theData[idx];}

   const ossimColumnVector3d& data() const { return theData; }
   ossimColumnVector3d&       data()       { return theData; }

   ossimString toString(ossim_uint32 precision=15) const;

   void toPoint(const std::string& s);

   NEWMAT::ColumnVector toVector() const
   {
      NEWMAT::ColumnVector v (3);
      v(0) = theData[0];
      v(1) = theData[1];
      v(2) = theData[2];
      return v;
   }

   void print(ostream& os = ossimNotify(ossimNotifyLevel_INFO)) const
      {  os << "(ossimEcefVector) " << theData; }

   friend ostream& operator<< (ostream& os , const ossimEcefVector& instance)
      { instance.print(os); return os; }

protected:
   ossimColumnVector3d theData;
};

//================== BEGIN DEFINITIONS FOR INLINE METHODS =====================

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::operator-()
//  Reverses direction of vector.
//*****************************************************************************
inline ossimEcefVector ossimEcefVector::operator-() const
{
   return ossimEcefVector(-theData);
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::operator+(const ossimEcefVector&)
//*****************************************************************************
inline ossimEcefVector
ossimEcefVector::operator+(const ossimEcefVector& v) const
{
   return ossimEcefVector(theData + v.theData);
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::operator-(const ossimEcefVector&)
//*****************************************************************************
inline ossimEcefVector
ossimEcefVector::operator-(const ossimEcefVector& v) const
{
   return ossimEcefVector(theData - v.theData);
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::operator+(const ossimEcefPoint&) 
//*****************************************************************************
inline  ossimEcefPoint
ossimEcefVector::operator+(const ossimEcefPoint& p) const
{
   return ossimEcefPoint(theData + p.data());
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::operator*(const double&)
//*****************************************************************************
inline ossimEcefVector ossimEcefVector::operator*(const double& scalar) const
{
   return ossimEcefVector(theData*scalar);
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::operator/(const double&)
//*****************************************************************************
inline ossimEcefVector ossimEcefVector::operator/(const double& scalar) const
{
   return ossimEcefVector(theData/scalar);
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::operator==(const ossimEcefVector&)
//*****************************************************************************
inline bool ossimEcefVector::operator==(const ossimEcefVector& v) const
{
   return (theData == v.theData);
}
   
//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::operator!=(const ossimEcefVector&)
//*****************************************************************************
inline bool ossimEcefVector::operator!=(const ossimEcefVector& v) const
{
   return (theData != v.theData);
}
   
//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::operator=
//*****************************************************************************
inline const ossimEcefVector&
ossimEcefVector::operator=(const ossimEcefVector& v)
{
   theData = v.theData;
   return *this;
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::dot()
//  Computes the scalar product.
//*****************************************************************************
inline double ossimEcefVector::dot(const ossimEcefVector& v) const
{
   return theData.dot(v.theData);
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::angleTo()
//  Returns the angle subtended (in DEGREES) between this and arg vector
//*****************************************************************************
inline double ossimEcefVector::angleTo(const ossimEcefVector& v) const
{
   double mag_product = theData.magnitude() * v.theData.magnitude();
   return ossim::acosd(theData.dot(v.theData)/mag_product);
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::cross()
//  Computes the cross product.
//*****************************************************************************
inline ossimEcefVector ossimEcefVector::cross(const ossimEcefVector& v) const
{
   return ossimEcefVector(theData.cross(v.theData));
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::unitVector()
//  Returns a unit vector parallel to this.
//*****************************************************************************
inline ossimEcefVector ossimEcefVector::unitVector() const
{
   return ossimEcefVector(theData/theData.magnitude());
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::magnitude()
//*****************************************************************************
inline double ossimEcefVector::magnitude() const
{
   return theData.magnitude();
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::norm2()
//*****************************************************************************
inline double ossimEcefVector::norm2() const
{
   return theData.norm2();
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::length()
//*****************************************************************************
inline double ossimEcefVector::length() const
{
   return theData.magnitude();
}

//*****************************************************************************
//  INLINE METHOD: ossimEcefVector::normalize()
//  Normalizes this vector.
//*****************************************************************************
inline double ossimEcefVector::normalize()
{
   double result = theData.magnitude();
   if(result > 1e-15)
   {
      theData /= result;
   }

   return result;
}
#endif