ossim::GroundControlPoint Class Reference

Class for representing a ground control point. More...

#include <GroundControlPoint.h>

Inheritance diagram for ossim::GroundControlPoint:

Public Member Functions
	GroundControlPoint (const Json::Value &image_json_node)
	Creates new GCP from JSON object. More...
virtual	~GroundControlPoint ()
const std::string &	getId () const
const ossimEcefPoint &	getECF () const
const NEWMAT::SymmetricMatrix &	getCovariance () const
virtual void	loadJSON (const Json::Value &json)
virtual void	saveJSON (Json::Value &json) const
Public Member Functions inherited from ossim::JsonInterface
	JsonInterface ()
virtual	~JsonInterface ()

Private Member Functions
	GroundControlPoint ()

Private Attributes
std::string	m_id
ossimEcefPoint	m_gcp
NEWMAT::SymmetricMatrix	m_covariance

Detailed Description

Class for representing a ground control point.

TODO: mplement cross-correlation between GCPs

Definition at line 22 of file GroundControlPoint.h.

Constructor & Destructor Documentation

GroundControlPoint() [1/2]

ossim::GroundControlPoint::GroundControlPoint

(

const Json::Value &

image_json_node

)

Creates new GCP from JSON object.

The ground point (GCP) coordinates are specified in either ECF or geographic. The associated covariance must be in the same coordinate system. If correlations exist to other GCPs, those GCPs must share the same coordinate system. TBD: Perhaps the GCP information, including coordinates, covariances and cross-covariances can be ingested prior and accessed from the database with only GCP ID. Id so, the remainder of this message is not needed.

The JSON Format: { "id": <string>, "ecf": [ <X>, <Y>, <Z> ], OR "geo": [ <lat>, <lon>, <hgt_msl> ], "covariance": [ c11, c22, c33, c12, c13, c23 ], "crossCovariances": [ (Can be excluded if no correlation information available) { "id": <string>, The other GCP’s ID "crossCovariance": [ c11, c22, c33, c12, c13, c23 ] } ] }

Definition at line 20 of file GroundControlPoint.cpp.

References loadJSON(), and m_covariance.

:  m_covariance (3)
{
   m_covariance.ReSize(3);
   loadJSON(json_node);
}

~GroundControlPoint()

ossim::GroundControlPoint::~GroundControlPoint ( )

virtual

Definition at line 28 of file GroundControlPoint.cpp.

{

}

GroundControlPoint() [2/2]

ossim::GroundControlPoint::GroundControlPoint ( )

private

Definition at line 15 of file GroundControlPoint.cpp.

{

}

Member Function Documentation

getCovariance()

const NEWMAT::SymmetricMatrix& ossim::GroundControlPoint::getCovariance ( ) const

inline

Definition at line 58 of file GroundControlPoint.h.

References m_covariance.

{return m_covariance;}

getECF()

const ossimEcefPoint& ossim::GroundControlPoint::getECF ( ) const

inline

Definition at line 56 of file GroundControlPoint.h.

References m_gcp.

{ return m_gcp; }

getId()

const std::string& ossim::GroundControlPoint::getId ( ) const

inline

Definition at line 55 of file GroundControlPoint.h.

References m_id.

{ return m_id; }

loadJSON()

void ossim::GroundControlPoint::loadJSON ( const Json::Value &  json )

virtual

Implements ossim::JsonInterface.

Definition at line 33 of file GroundControlPoint.cpp.

References ossimGpt::hgt, ossimGpt::lat, ossimGpt::lon, m_covariance, m_gcp, m_id, ossimNotify(), ossimNotifyLevel_WARN, ossimEcefPoint::x(), ossimEcefPoint::y(), and ossimEcefPoint::z().

Referenced by GroundControlPoint().

{
   ostringstream xmsg;
   xmsg<<__FILE__<<": ";

   m_id = json_node["gcpId"].asString();
   if (m_id.empty())
      m_id = json_node["pointId"].asString();

   if (json_node.isMember("lat") && json_node.isMember("lon") && json_node.isMember("hgt"))
   {
      ossimGpt refGpt;
      refGpt.lat = json_node["lat"].asDouble();
      refGpt.lon = json_node["lon"].asDouble();
      refGpt.hgt = json_node["hgt"].asDouble();
      m_gcp = ossimEcefPoint(refGpt);
   }
   else if (json_node.isMember("x") && json_node.isMember("y") && json_node.isMember("z"))
   {
      m_gcp.x() = json_node["x"].asDouble();
      m_gcp.y() = json_node["y"].asDouble();
      m_gcp.z() = json_node["z"].asDouble();
   }
   else
   {
      xmsg<<"Ground point coordinates JSON not correct. JSON: \n"<<json_node.toStyledString()<<endl;
      throw ossimException(xmsg.str());
   }

   const Json::Value& covariance = json_node["covariance"];
   unsigned int covSize = covariance.size();
   if ((covSize != 6) || (covSize != 9))
   {
      xmsg<<"No covariance information in JSON or not correctly formatted (must be 6 or 9 element array)";
      throw ossimException(xmsg.str());
   }

   // TODO: Covariance in proper coordinate system. ENU -> ECF conversion needed here?
   if (covSize == 6)
   {
      m_covariance(0,0) = covariance[0].asDouble();
      m_covariance(1,1) = covariance[1].asDouble();
      m_covariance(2,2) = covariance[2].asDouble();
      m_covariance(0,1) = covariance[3].asDouble();
      m_covariance(0,2) = covariance[4].asDouble();
      m_covariance(1,2) = covariance[5].asDouble();
   }
   else
   {
      m_covariance(0,0) = covariance[0].asDouble();
      m_covariance(0,1) = covariance[1].asDouble();
      m_covariance(0,2) = covariance[2].asDouble();
      m_covariance(1,0) = covariance[3].asDouble();
      m_covariance(1,1) = covariance[4].asDouble();
      m_covariance(1,2) = covariance[5].asDouble();
      m_covariance(2,0) = covariance[6].asDouble();
      m_covariance(2,1) = covariance[7].asDouble();
      m_covariance(2,2) = covariance[8].asDouble();
   }

   // TODO: Implement GCP cross-correlation
   if (json_node.isMember("crossCovariances") || json_node.isMember("gpCrossCovList"))
   {
      ossimNotify(ossimNotifyLevel_WARN)<<"GCP cross covariances are specified in the JSON, but the"
         " capability is not yet implemented!"<<endl;
   }
}

saveJSON()

void ossim::GroundControlPoint::saveJSON ( Json::Value &  json ) const

virtual

Implements ossim::JsonInterface.

Definition at line 101 of file GroundControlPoint.cpp.

References m_covariance, m_gcp, m_id, ossimEcefPoint::x(), ossimEcefPoint::y(), and ossimEcefPoint::z().

{
   // ID
   json_node["gcpId"] = m_id;

   // ECF
   json_node["X"] = m_gcp.x();
   json_node["Y"] = m_gcp.y();
   json_node["Z"] = m_gcp.z();

   Json::Value covJson (Json::arrayValue);
   covJson[0] = m_covariance(1,1);
   covJson[1] = m_covariance(2,2);
   covJson[2] = m_covariance(3,3);
   covJson[3] = m_covariance(1,2);
   covJson[4] = m_covariance(1,3);
   covJson[5] = m_covariance(2,3);

   json_node["covariance"] = covJson;
}

Member Data Documentation

m_covariance

NEWMAT::SymmetricMatrix ossim::GroundControlPoint::m_covariance

private

Definition at line 77 of file GroundControlPoint.h.

Referenced by getCovariance(), GroundControlPoint(), loadJSON(), and saveJSON().

m_gcp

ossimEcefPoint ossim::GroundControlPoint::m_gcp

private

Definition at line 76 of file GroundControlPoint.h.

Referenced by getECF(), loadJSON(), and saveJSON().

m_id

std::string ossim::GroundControlPoint::m_id

private

Definition at line 75 of file GroundControlPoint.h.

Referenced by getId(), loadJSON(), and saveJSON().

---

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

• GroundControlPoint.h
• GroundControlPoint.cpp