storage class for tie point between ground and image based on ossimGpt More...

#include <ossimTieGpt.h>

Inheritance diagram for ossimTieGpt:

Public Member Functions
	ossimTieGpt ()

	ossimTieGpt (const ossimGpt &aPt, const ossimDpt &aTie, const ossim_float64 &aScore)

	ossimTieGpt (const ossimTieGpt &tpt)

	~ossimTieGpt ()

const ossimTieGpt &	operator= (const ossimTieGpt &)

void	setGroundPoint (const ossimGpt &mPt)

const ossimGpt &	getGroundPoint () const

ossimGpt &	refGroundPoint ()

void	setImagePoint (const ossimDpt &sPt)

const ossimDpt &	getImagePoint () const

ossimDpt &	refImagePoint ()

void	setScore (const ossim_float64 &s)

const ossim_float64 &	getScore () const

ossim_float64 &	refScore ()

void	makeNan ()

bool	hasNans () const

bool	isNan () const

std::ostream &	print (std::ostream &os) const
	text serialization More...

std::ostream &	printTab (std::ostream &os) const

ossimRefPtr< ossimXmlNode >	exportAsGmlNode (ossimString aGmlVersion="2.1.2") const
	GML feauture (XML) serialization. More...

bool	importFromGmlNode (ossimRefPtr< ossimXmlNode > aGmlNode, ossimString aGmlVersion="2.1.2")

Public Member Functions inherited from ossimReferenced
	ossimReferenced ()

	ossimReferenced (const ossimReferenced &)

ossimReferenced &	operator= (const ossimReferenced &)

void	ref () const
	increment the reference count by one, indicating that this object has another pointer which is referencing it. More...

void	unref () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

void	unref_nodelete () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

int	referenceCount () const

Public Member Functions inherited from ossimGpt
	ossimGpt (const double alat=0, const double alon=0, const double ahgt=0, const ossimDatum *aDatum=ossimDatumFactory::instance() ->wgs84())
	Constructor. More...

	ossimGpt (const ossimGpt &src)
	Copy Constructor: More...

	ossimGpt (const ossimEcefPoint &aPt, const ossimDatum *aDatum=ossimDatumFactory::instance() ->wgs84())
	Constructor. More...

	ossimGpt (const ossimDpt3d &aPt)
	Argument aPt (x, y, z) is understood to represent (lon, lat, hgt) relative to WGS84 datum. More...

double	latr () const
	latr(). More...

void	latr (double radianValue)
	Returns the latitude in radian measure. More...

double	lonr () const
	Returns the longitude in radian measure. More...

void	lonr (double radianValue)
	Assumes the value being passed in is in radians. More...

double	latd () const
	Will convert the radian measure to degrees. More...

void	latd (double degreeValue)
	Assumes the passed in value is in degrees. More...

double	lond () const
	Will convert the radian measure to degrees. More...

void	lond (double degreeValue)
	Assumes the passed in value is in degrees. More...

double	height () const

double	heightMSL () const

void	height (double height)
	Sets the "hgt" data member to height. More...

void	heightMSL (double heightMSL)
	Sets the "hgt" data member to heightMsl adding any geiod offset. More...

void	makeNan ()

bool	isNan () const

bool	hasNans () const

bool	isLatNan () const

bool	isLonNan () const

bool	isLonLatNan () const

bool	isLatLonNan () const

bool	isHgtNan () const

std::ostream &	print (std::ostream &os, ossim_uint32 precision=15) const

ossimString	toString (ossim_uint32 precision=15) const

void	toPoint (const std::string &s)
	Initializes this point from string. More...

const ossimDatum *	datum () const
	datum(). More...

void	datum (const ossimDatum *aDatum)
	Note: this will not do a shift. More...

void	changeDatum (const ossimDatum *datum)
	This will actually perform a shift. More...

const ossimGpt &	operator= (const ossimGpt &aPt)

bool	operator== (const ossimGpt &gpt) const

bool	operator!= (const ossimGpt &gpt) const

void	limitLonTo180 ()
	METHOD: limitLonTo180() Converts the lon data member to a value between -180 and +180: More...

void	wrap ()
	Wrap method to maintain longitude between -180 and +180 and latitude between -90 and +90. More...

void	clampLon (double low, double high)

void	clampLat (double low, double high)

void	clampHgt (double low, double high)

double	distanceTo (const ossimGpt &arg_gpt) const
	METHOD: distanceTo(ossimGpt) Computes straight-line distance in meters between this and arg gpt: More...

double	azimuthTo (const ossimGpt &arg_gpt) const
	METHOD: azimuthTo(ossimGpt) Computes the great-circle starting azimuth (i.e., at this gpt) to the argument gpt in degrees. More...

ossimDpt	metersPerDegree () const

ossimString	toDmsString () const

bool	isEqualTo (const ossimGpt &rhs, ossimCompareType compareType=OSSIM_COMPARE_FULL) const

Public Attributes
ossimDpt	tie
	Public data members. More...

ossim_float64	score

Public Attributes inherited from ossimGpt
ossim_float64	lat

ossim_float64	lon

ossim_float64	hgt
	Height in meters above the ellipsiod. More...

Friends
OSSIMDLLEXPORT std::ostream &	operator<< (std::ostream &os, const ossimTieGpt &pt)

OSSIMDLLEXPORT std::istream &	operator>> (std::istream &is, ossimTieGpt &pt)
	Method to input the formatted string of the "operator<<". More...

Additional Inherited Members
Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Detailed Description

storage class for tie point between ground and image based on ossimGpt

GML feature (OGC) serialization

NOTES accuracy is not stored here (need to derive object if need a per-point accuracy) GML storage is WGS84 only, it stores above ellipsoid height (m)

TODO : -support other datum (easy) / ground projection (big change in OSSIM) -unify with ossimTDpt

Definition at line 24 of file ossimTieGpt.h.

Constructor & Destructor Documentation

◆ ossimTieGpt() [1/3]

ossimTieGpt::ossimTieGpt ( )

inline

Definition at line 30 of file ossimTieGpt.h.

                         : 
       ossimReferenced(),
       ossimGpt(),
       tie(),
       score(0.0)
       {}

◆ ossimTieGpt() [2/3]

ossimTieGpt::ossimTieGpt	(	const ossimGpt &	aPt,
		const ossimDpt &	aTie,
		const ossim_float64 &	aScore
	)

inline

Definition at line 37 of file ossimTieGpt.h.

                                                                                               : 
       ossimReferenced(),
       ossimGpt(aPt),
       tie(aTie),
       score(aScore)
       {}

◆ ossimTieGpt() [3/3]

ossimTieGpt::ossimTieGpt ( const ossimTieGpt & tpt )

inline

Definition at line 44 of file ossimTieGpt.h.

                                               : 
       ossimReferenced(tpt),
       ossimGpt(tpt),
       tie(tpt.tie),
       score(tpt.score)
       {}

◆ ~ossimTieGpt()

ossimTieGpt::~ossimTieGpt ( )

inline

Definition at line 50 of file ossimTieGpt.h.

50 {}

Member Function Documentation

◆ exportAsGmlNode()

ossimRefPtr< ossimXmlNode > ossimTieGpt::exportAsGmlNode ( ossimString aGmlVersion = "2.1.2" ) const

GML feauture (XML) serialization.

Definition at line 111 of file ossimTieGpt.cpp.

References ossimXmlNode::addChildNode(), ossimXmlNode::addNode(), COORD_GML2, ossimGpt::datum(), GROUND_GML2, ossimDpt::hasNans(), ossimGpt::height(), IMAGE_GML2, ossimDatumFactory::instance(), ossimGpt::isHgtNan(), ossimGpt::isLatNan(), ossimGpt::isLonNan(), ossimGpt::latd(), ossimGpt::lond(), ossimNotify(), ossimNotifyLevel_WARN, score, SCORE_GML2, ossimXmlNode::setTag(), tie, ossimString::toString(), ossimDpt::x, and ossimDpt::y.

 {   
    ossimRefPtr<ossimXmlNode> node(new ossimXmlNode);
    // check datum to be WGS84
    if ( !(datum()->operator==(*(ossimDatumFactory::instance()->wgs84()))) )
    {
       ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::exportAsGmlNode datum must be WGS84\n";
       return node;
    }
    // check nans in lon/lat and in tie
    if (isLatNan() || isLonNan() || tie.hasNans())
    {
       ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::exportAsGmlNode positions have nan\n";
       return node;
    }
    if (aGmlVersion[static_cast<std::string::size_type>(0)] == '2')
    {
       node->setTag("SimpleTiePoint");
       // note: no "fid" attribute (feature id")
       //store Ground Point WGS84 + height above ellipsoid in meters
       ossimRefPtr<ossimXmlNode> gcoord =  node->addNode(ossimString(GROUND_GML2) + "/" + COORD_GML2 );
       gcoord->addChildNode("X",ossimString::toString(lond()));
       gcoord->addChildNode("Y",ossimString::toString(latd()));
       if (!isHgtNan())
       {
         gcoord->addChildNode("Z",ossimString::toString(height())); //above ellipsoid
       }
 
       // store image tie point
       ossimRefPtr<ossimXmlNode> tcoord =  node->addNode(ossimString(IMAGE_GML2) + "/" + COORD_GML2);
       tcoord->addChildNode("X",ossimString::toString(tie.x));
       tcoord->addChildNode("Y",ossimString::toString(tie.y));
 
       //store score (change name to confidence?)
       node->addNode(SCORE_GML2,ossimString::toString(score));
    } else {
       ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::exportAsGmlNode Unsupported GML version : " << aGmlVersion <<"\n";
    }
    return node;
 }

◆ getGroundPoint()

const ossimGpt& ossimTieGpt::getGroundPoint ( ) const

inline

Definition at line 55 of file ossimTieGpt.h.

55 { return *this; }

◆ getImagePoint()

const ossimDpt& ossimTieGpt::getImagePoint ( ) const

inline

Definition at line 59 of file ossimTieGpt.h.

59 { return tie; }

ossimTieGpt::tie

ossimDpt tie

Public data members.

Definition: ossimTieGpt.h:108

◆ getScore()

const ossim_float64& ossimTieGpt::getScore ( ) const

inline

Definition at line 63 of file ossimTieGpt.h.

63 { return score; }

ossimTieGpt::score

ossim_float64 score

Definition: ossimTieGpt.h:109

◆ hasNans()

bool ossimTieGpt::hasNans ( ) const

inline

Definition at line 73 of file ossimTieGpt.h.

References ossimGpt::hasNans(), and ossim::isnan().

    {
       return (ossimGpt::hasNans() || tie.hasNans() || (ossim::isnan(score)));
    }

◆ importFromGmlNode()

bool ossimTieGpt::importFromGmlNode	(	ossimRefPtr< ossimXmlNode >	aGmlNode,
		ossimString	aGmlVersion = `"2.1.2"`
	)

Definition at line 153 of file ossimTieGpt.cpp.

References COORD_GML2, ossimXmlNode::findFirstNode(), ossimXmlNode::getText(), GROUND_GML2, ossimGpt::height(), IMAGE_GML2, ossimGpt::latd(), ossimGpt::lond(), ossimDpt::makeNan(), makeNan(), ossimNotify(), ossimNotifyLevel_WARN, score, SCORE_GML2, tie, ossimRefPtr< T >::valid(), ossimDpt::x, and ossimDpt::y.

Referenced by ossimTieGptSet::importFromGmlNode().

 {
    //assuming datum is EPSG:4326 (aka WGS84)
    //feature has to be a SimpleTiePoint feature
    //TBD : add support for coord instead of coordinates
    //TBD : more robust type checks (for X,Y,Z and score) - create extra protected function
 
    //clear data
    makeNan();
    tie.makeNan();
    score = 0;
 
    if (aGmlVersion[static_cast<std::string::size_type>(0)] == '2')
    {
       //read ground point
       ossimRefPtr<ossimXmlNode> gn = aGmlNode->findFirstNode(GROUND_GML2);
       ossimRefPtr<ossimXmlNode> gcoord = gn->findFirstNode(COORD_GML2);
       if (gcoord.valid())
       {
          //read coord
          ossimRefPtr<ossimXmlNode> gx = gcoord->findFirstNode("X");
          if (gx.valid())
          {
             lond(ossimString(gx->getText()).toDouble());
          } else {
             ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::importFromGmlNode no ground X found in coord\n";
             return false;
          }
          ossimRefPtr<ossimXmlNode> gy = gcoord->findFirstNode("Y");
          if (gy.valid())
          {
             latd(ossimString(gy->getText()).toDouble());
          } else {
             ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::importFromGmlNode no ground Y found in coord\n";
             return false;
          }
          ossimRefPtr<ossimXmlNode> gz = gcoord->findFirstNode("Z");
          if (gz.valid())
          {
             height(ossimString(gz->getText()).toDouble());
          } // no Z value is possible
       }
       else {
          //try to read coordinates
          //TBD
          ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::importFromGmlNode gml:coordinates not developed yet for ground\n";
          return false;
       }
 
       //read image point
       ossimRefPtr<ossimXmlNode> in = aGmlNode->findFirstNode(IMAGE_GML2);
       ossimRefPtr<ossimXmlNode> icoord = in->findFirstNode(COORD_GML2);
       if (icoord.valid())
       {
          //read coord
          ossimRefPtr<ossimXmlNode> ix = icoord->findFirstNode("X");
          if (ix.valid())
          {
             tie.x = ossimString(ix->getText()).toDouble();
          } else {
             ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::importFromGmlNode no image X found in coord\n";
             return false;
          }
          ossimRefPtr<ossimXmlNode> iy = icoord->findFirstNode("Y");
          if (iy.valid())
          {
             tie.y = ossimString(iy->getText()).toDouble();
          } else {
             ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::importFromGmlNode no image Y found in coord\n";
             return false;
          }
          //don't read Z value (shouldn't be any)
       }
       else {
          //try to read coordinates
          //TBD
          ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::importFromGmlNode gml:coordinates not developed yet for image\n";
          return false;
       }
 
       //read score
       ossimRefPtr<ossimXmlNode> scoren = aGmlNode->findFirstNode(SCORE_GML2);
       if (scoren.valid())
       {
          score = ossimString(scoren->getText()).toDouble();
       } else {
          score = 0.0;
       }
       return true;
    } else {
       ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGpt::importFromGmlNode Unsupported GML version : " << aGmlVersion <<"\n";
       return false;
    }
 }

◆ isNan()

bool ossimTieGpt::isNan ( ) const

inline

Definition at line 78 of file ossimTieGpt.h.

References ossim::isnan(), and ossimGpt::isNan().

    {
       return (ossimGpt::isNan() && tie.isNan() && (ossim::isnan(score)));
    }

◆ makeNan()

void ossimTieGpt::makeNan ( )

inline

Definition at line 66 of file ossimTieGpt.h.

References ossimGpt::makeNan(), and ossim::nan().

Referenced by importFromGmlNode(), and operator>>().

       {
        ossimGpt::makeNan();
        tie.makeNan();
        score=ossim::nan();
       }

◆ operator=()

const ossimTieGpt & ossimTieGpt::operator= ( const ossimTieGpt & pt )

inline

Definition at line 112 of file ossimTieGpt.h.

References ossimReferenced::operator=(), ossimGpt::operator=(), score, and tie.

 {
    if (this != &pt)
    {
       ossimReferenced::operator=(pt);
       ossimGpt::operator=(pt);
       tie   = pt.tie;
       score = pt.score;
    }
    
    return *this;
 }

◆ print()

std::ostream & ossimTieGpt::print ( std::ostream & os ) const

text serialization

Definition at line 11 of file ossimTieGpt.cpp.

References ossim::isnan(), score, and tie.

Referenced by operator<<().

 {
    os << "( ";
    os << dynamic_cast<const ossimGpt&>(*this);
    os << ", ";
    os << tie;
    os << ", ";
    if (ossim::isnan(score) == false)
    {
       os << std::setiosflags(std::ios::fixed) << std::setprecision(15);
       os << score;
    } else {
       os << "nan";
    }
    os << " )";
 
    return os;
 }

◆ printTab()

std::ostream & ossimTieGpt::printTab ( std::ostream & os ) const

Definition at line 30 of file ossimTieGpt.cpp.

References ossimGpt::height(), ossimGpt::latd(), ossimGpt::lond(), score, tie, ossimDpt::x, and ossimDpt::y.

 {
    os << std::setiosflags(std::ios::fixed) << std::setprecision(15);
    os<< lond() ;
    os<<"\t"<< latd();
    os<<"\t"<< height();
    os<<"\t"<< tie.x;
    os<<"\t"<< tie.y;
    os<<"\t"<< score;
 
    return os;
 }

◆ refGroundPoint()

ossimGpt& ossimTieGpt::refGroundPoint ( )

inline

Definition at line 56 of file ossimTieGpt.h.

56 { return *this; }

◆ refImagePoint()

ossimDpt& ossimTieGpt::refImagePoint ( )

inline

Definition at line 60 of file ossimTieGpt.h.

60 { return tie; }

ossimTieGpt::tie

ossimDpt tie

Public data members.

Definition: ossimTieGpt.h:108

◆ refScore()

ossim_float64& ossimTieGpt::refScore ( )

inline

Definition at line 64 of file ossimTieGpt.h.

64 { return score; }

ossimTieGpt::score

ossim_float64 score

Definition: ossimTieGpt.h:109

◆ setGroundPoint()

void ossimTieGpt::setGroundPoint ( const ossimGpt & mPt )

inline

Definition at line 54 of file ossimTieGpt.h.

References ossimGpt::operator=().

54 { ossimGpt::operator=(mPt); }

ossimGpt::operator=

const ossimGpt & operator=(const ossimGpt &aPt)

Definition: ossimGpt.h:285

◆ setImagePoint()

void ossimTieGpt::setImagePoint ( const ossimDpt & sPt )

inline

Definition at line 58 of file ossimTieGpt.h.

58 { tie=sPt; }

ossimTieGpt::tie

ossimDpt tie

Public data members.

Definition: ossimTieGpt.h:108

◆ setScore()

void ossimTieGpt::setScore ( const ossim_float64 & s )

inline

Definition at line 62 of file ossimTieGpt.h.

62 { score=s; }

ossimTieGpt::score

ossim_float64 score

Definition: ossimTieGpt.h:109

Friends And Related Function Documentation

◆ operator<<

OSSIMDLLEXPORT std::ostream& operator<<	(	std::ostream &	os,
		const ossimTieGpt &	pt
	)

friend

Definition at line 43 of file ossimTieGpt.cpp.

 {
    return pt.print(os);
 }

◆ operator>>

OSSIMDLLEXPORT std::istream& operator>>	(	std::istream &	is,
		ossimTieGpt &	pt
	)

friend

Method to input the formatted string of the "operator<<".

Expected format: ( ( ossimGpt ), ( ossimDpt ), 0.50000000000000 ) –*this-— , -—tie--—, —score-----—

Definition at line 48 of file ossimTieGpt.cpp.

 {
    //---
    // Expected input format:
    // ( (ossimDPt), (ossimDpt), score )
    // score is real or nan
    //---
 
    // Start with a nan point.
    pt.makeNan();
    // Check the stream.
    if (!is) return is;
 
    ossimString tempString;
 
    // Gobble the "(".
    is >> tempString;
 
    //get the first point
    is>>dynamic_cast<ossimGpt&>(pt);
 
    // Eat the ",".
    char c;
    is.get(c);
 
    //get the second point
    is>>pt.tie;
 
    // Eat the second ",".
    is.get(c);
 
    // Get the score
    const int SZ = 64; // real number buffer size
    char tempChars[SZ];
    is.get(tempChars, SZ, ',');
    if (!is) return is;
    tempChars[SZ-1] = '\0';
    tempString = tempChars;
    tempString.trim();
    if (tempString == "nan")
    {
       pt.score = ossim::nan();
    }
    else
    {
       pt.score = tempString.toDouble();
    }
 
    // Gobble the trailing ")".
    is >> tempString;
    
    // Finished
    return is;
 }

Member Data Documentation

◆ score

ossim_float64 ossimTieGpt::score

Definition at line 109 of file ossimTieGpt.h.

Referenced by exportAsGmlNode(), importFromGmlNode(), operator=(), operator>>(), print(), and printTab().

◆ tie

ossimDpt ossimTieGpt::tie

Public data members.

Definition at line 108 of file ossimTieGpt.h.

Referenced by exportAsGmlNode(), importFromGmlNode(), operator=(), operator>>(), print(), and printTab().

The documentation for this class was generated from the following files:

Public Member Functions

Public Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ossimTieGpt() [1/3]

◆ ossimTieGpt() [2/3]

◆ ossimTieGpt() [3/3]

◆ ~ossimTieGpt()

Member Function Documentation

◆ exportAsGmlNode()

◆ getGroundPoint()

◆ getImagePoint()

◆ getScore()

◆ hasNans()

◆ importFromGmlNode()

◆ isNan()

◆ makeNan()

◆ operator=()

◆ print()

◆ printTab()

◆ refGroundPoint()

◆ refImagePoint()

◆ refScore()

◆ setGroundPoint()

◆ setImagePoint()

◆ setScore()

Friends And Related Function Documentation

◆ operator<<

◆ operator>>

Member Data Documentation

◆ score

◆ tie