ossimTieGptSet Class Reference

storage class for a set of geographic tie points, between master and slave images More...

#include <ossimTieGptSet.h>

Public Member Functions
	ossimTieGptSet ()
	ossimTieGptSet (const ossimTieGptSet &aSet)
	~ossimTieGptSet ()
const ossimTieGptSet &	operator= (const ossimTieGptSet &)
void	setTiePoints (const vector< ossimRefPtr< ossimTieGpt > > &aTieSet)
const vector< ossimRefPtr< ossimTieGpt > > &	getTiePoints () const
vector< ossimRefPtr< ossimTieGpt > > &	refTiePoints ()
void	setMasterPath (const ossimString &aPath)
const ossimString &	getMasterPath () const
void	setSlavePath (const ossimString &aPath)
const ossimString &	getSlavePath () const
void	setImageCov (const NEWMAT::SymmetricMatrix &aCovMat)
const NEWMAT::SymmetricMatrix &	getImageCov () const
NEWMAT::SymmetricMatrix &	refImageCov ()
void	setGroundCov (const NEWMAT::SymmetricMatrix &aCovMat)
const NEWMAT::SymmetricMatrix &	getGroundCov () const
NEWMAT::SymmetricMatrix &	refGroundCov ()
void	getSlaveMasterPoints (std::vector< ossimDpt > &imv, std::vector< ossimGpt > &gdv) const
unsigned int	size () const
void	addTiePoint (ossimRefPtr< ossimTieGpt > aTiePt)
	operations More...
void	clearTiePoints ()
void	getGroundBoundaries (ossimGpt &gBoundInf, ossimGpt &gBoundSup) const
std::ostream &	printTab (std::ostream &os) const
	text output : header + tab separated tie points More...
ossimRefPtr< ossimXmlNode >	exportAsGmlNode (ossimString aGmlVersion="2.1.2") const
	GML features (XML) serialization. More...
bool	importFromGmlNode (ossimRefPtr< ossimXmlNode > aGmlNode, ossimString aGmlVersion="2.1.2")

Static Public Attributes
static const char *	TIEPTSET_TAG = "TiePointSet"
	Public data members. More...

Protected Member Functions
ossimString	symMatrixToText (const NEWMAT::SymmetricMatrix &sym, const ossimString &el_sep=" ", const ossimString &row_sep=";") const
	ground error covariance matrix More...
NEWMAT::SymmetricMatrix	textToSymMatrix (const ossimString &text, unsigned int dim, const ossimString &seps=" ;\\) const

Protected Attributes
std::vector< ossimRefPtr< ossimTieGpt > >	theTies
	Protected data members. More...
ossimString	theMasterPath
ossimString	theSlavePath
	full or relative path to master dataset More...
NEWMAT::SymmetricMatrix	theImageCov
	full or relative path to slave dataset More...
NEWMAT::SymmetricMatrix	theGroundCov
	image error covariance matrix More...

Detailed Description

storage class for a set of geographic tie points, between master and slave images

• GML (OGC) serialization

NOTES master points are stored on the ground ground SRS is EPSG:4326 only (WGS84) + height in meters above ellispoid

slave points are stored as image positions

general ground/image accuracy values are stored

TODO :

Definition at line 27 of file ossimTieGptSet.h.

Constructor & Destructor Documentation

ossimTieGptSet() [1/2]

ossimTieGptSet::ossimTieGptSet ( )

inline

Definition at line 31 of file ossimTieGptSet.h.

{}

ossimTieGptSet() [2/2]

ossimTieGptSet::ossimTieGptSet ( const ossimTieGptSet &  aSet )

inline

Definition at line 33 of file ossimTieGptSet.h.

      :
      theTies(aSet.getTiePoints()),
      theMasterPath(aSet.getMasterPath()),
      theSlavePath(aSet.getSlavePath()),
      theImageCov(aSet.getImageCov()),
      theGroundCov(aSet.getGroundCov())
   {}

~ossimTieGptSet()

ossimTieGptSet::~ossimTieGptSet ( )

inline

Definition at line 42 of file ossimTieGptSet.h.

{}

Member Function Documentation

addTiePoint()

void ossimTieGptSet::addTiePoint

(

ossimRefPtr< ossimTieGpt >

aTiePt

)

operations

Definition at line 26 of file ossimTieGptSet.cpp.

Referenced by ossimGeoTiff::getTieSet(), and ossimTiffInfo::getTieSets().

{
   theTies.push_back(aTiePt);
}

clearTiePoints()

void ossimTieGptSet::clearTiePoints

(

)

Definition at line 32 of file ossimTieGptSet.cpp.

{
   theTies.clear();
}

exportAsGmlNode()

ossimRefPtr< ossimXmlNode > ossimTieGptSet::exportAsGmlNode

(

ossimString

aGmlVersion = "2.1.2"

)

const

GML features (XML) serialization.

Definition at line 66 of file ossimTieGptSet.cpp.

References ossimXmlNode::addAttribute(), ossimXmlNode::addChildNode(), ossimRefPtr< T >::get(), GROUNDCOV_TAG, IMAGECOV_TAG, MASTERPATH_TAG, ossimXmlNode::setTag(), and SLAVEPATH_TAG.

{   
   ossimRefPtr<ossimXmlNode> node(new ossimXmlNode);

   node->setTag(TIEPTSET_TAG);
   node->addAttribute("xmlns:gml","""http://www.opengis.net/gml"""); //namespace definition

   //add header information : general accuracy + path
   node->addChildNode(MASTERPATH_TAG,getMasterPath());
   node->addChildNode(SLAVEPATH_TAG,getSlavePath());
   node->addChildNode(IMAGECOV_TAG ,symMatrixToText(getImageCov()));
   node->addChildNode(GROUNDCOV_TAG,symMatrixToText(getGroundCov()));

   //add all tiepoints
   for(vector<ossimRefPtr<ossimTieGpt> >::const_iterator it = theTies.begin(); it != theTies.end(); ++it)
   {
      ossimRefPtr<ossimXmlNode> tienode = (*it)->exportAsGmlNode(aGmlVersion);
      node->addChildNode(tienode.get());
      //TBD : add attribute / counter?
   }

   return node;
}

getGroundBoundaries()

void ossimTieGptSet::getGroundBoundaries	(	ossimGpt &	gBoundInf,
		ossimGpt &	gBoundSup
	)		const

Definition at line 262 of file ossimTieGptSet.cpp.

References ossimGpt::hgt, ossim::isnan(), ossimGpt::lat, ossimGpt::lon, OSSIM_DEFAULT_MAX_PIX_DOUBLE, and OSSIM_DEFAULT_MIN_PIX_DOUBLE.

Referenced by ossimPolynomProjection::optimizeFit().

{
   //init
   gBoundInf.lat = gBoundInf.lon = gBoundInf.hgt = OSSIM_DEFAULT_MAX_PIX_DOUBLE;
   gBoundSup.lat = gBoundSup.lon = gBoundSup.hgt = OSSIM_DEFAULT_MIN_PIX_DOUBLE;

   //return image and/or ground bounds
   for(vector<ossimRefPtr<ossimTieGpt> >::const_iterator it = theTies.begin(); it != theTies.end(); ++it)
   {
      const ossimTieGpt& gp = *(*it);
      if (gp.lon > gBoundSup.lon) gBoundSup.lon = gp.lon;
      if (gp.lon < gBoundInf.lon) gBoundInf.lon = gp.lon;
      if (gp.lat > gBoundSup.lat) gBoundSup.lat = gp.lat;
      if (gp.lat < gBoundInf.lat) gBoundInf.lat = gp.lat;
      if (ossim::isnan(gp.hgt) == false)
      {
         if (gp.hgt > gBoundSup.hgt) gBoundSup.hgt = gp.hgt;
         if (gp.hgt < gBoundInf.hgt) gBoundInf.hgt = gp.hgt;
      } 
   }
}

getGroundCov()

const NEWMAT::SymmetricMatrix& ossimTieGptSet::getGroundCov ( ) const

inline

Definition at line 62 of file ossimTieGptSet.h.

Referenced by operator=().

{ return theGroundCov; }

getImageCov()

const NEWMAT::SymmetricMatrix& ossimTieGptSet::getImageCov ( ) const

inline

Definition at line 58 of file ossimTieGptSet.h.

Referenced by operator=().

{ return theImageCov; }

getMasterPath()

const ossimString& ossimTieGptSet::getMasterPath ( ) const

inline

Definition at line 52 of file ossimTieGptSet.h.

Referenced by operator=().

{ return theMasterPath; }

getSlaveMasterPoints()

void ossimTieGptSet::getSlaveMasterPoints	(	std::vector< ossimDpt > &	imv,
		std::vector< ossimGpt > &	gdv
	)		const

Definition at line 242 of file ossimTieGptSet.cpp.

Referenced by ossimBilinearProjection::optimizeFit(), and ossimRpcProjection::optimizeFit().

{
   //re-dim
   imv.resize(theTies.size());
   gdv.resize(theTies.size());

   //fill
   std::vector<ossimDpt>::iterator imvit = imv.begin();
   std::vector<ossimGpt>::iterator gdvit = gdv.begin();

   for(vector<ossimRefPtr<ossimTieGpt> >::const_iterator it = theTies.begin(); it != theTies.end(); ++it,++imvit,++gdvit)
   {
      *imvit = (*it)->getImagePoint();
      *gdvit = (*it)->getGroundPoint();
   }
}

getSlavePath()

const ossimString& ossimTieGptSet::getSlavePath ( ) const

inline

Definition at line 55 of file ossimTieGptSet.h.

Referenced by operator=().

{ return theSlavePath; }

getTiePoints()

const vector<ossimRefPtr<ossimTieGpt> >& ossimTieGptSet::getTiePoints ( ) const

inline

Definition at line 48 of file ossimTieGptSet.h.

Referenced by ossimRpcProjection::buildNormalEquation(), ossimSensorModel::buildNormalEquation(), ossimRpcProjection::getResidue(), ossimSensorModel::getResidue(), operator=(), and ossimPolynomProjection::optimizeFit().

{ return theTies; }

importFromGmlNode()

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

Definition at line 92 of file ossimTieGptSet.cpp.

References ossimXmlNode::findChildNodes(), ossimXmlNode::findFirstNode(), ossimXmlNode::getText(), GROUNDCOV_TAG, IMAGECOV_TAG, ossimTieGpt::importFromGmlNode(), MASTERPATH_TAG, ossimNotify(), ossimNotifyLevel_WARN, SLAVEPATH_TAG, TIEPOINTS_TAG, and ossimRefPtr< T >::valid().

{
   clearTiePoints();
   //load master path
   ossimRefPtr<ossimXmlNode> mpn = aGmlNode->findFirstNode(MASTERPATH_TAG);
   if (mpn.valid())
   {
      setMasterPath(mpn->getText());
   } else {
      ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGptSet::importFromGmlNode no "<<MASTERPATH_TAG<<" tag found\n";
      //not an error
      setMasterPath("");
   }
   //load slave path
   ossimRefPtr<ossimXmlNode> spn = aGmlNode->findFirstNode(SLAVEPATH_TAG);
   if (spn.valid())
   {
      setSlavePath(spn->getText());
   } else {
      ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGptSet::importFromGmlNode no "<<SLAVEPATH_TAG<<" tag found\n";
      //not an error
      setSlavePath("");
   }

   //load image covariance
   ossimRefPtr<ossimXmlNode> icn = aGmlNode->findFirstNode(IMAGECOV_TAG);
   if (icn.valid())
   {
      NEWMAT::SymmetricMatrix icm = textToSymMatrix(icn->getText(),2);
      if (icm.Nrows()==2)
      {
         setImageCov(icm);
      } else {
         ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGptSet::importFromGmlNode bad image covariance matrix\n";
         return false;
      }
   } else {
      ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGptSet::importFromGmlNode tag "<<IMAGECOV_TAG<<" not found\n";
      //not an error
      setImageCov(NEWMAT::SymmetricMatrix(2)); //maybe use no matrix at all when no info ? TBC
   }

   //load ground covariance
   ossimRefPtr<ossimXmlNode> gcn = aGmlNode->findFirstNode(GROUNDCOV_TAG);
   if (gcn.valid())
   {
      NEWMAT::SymmetricMatrix gcm = textToSymMatrix(gcn->getText(),3);
      if (gcm.Nrows()==3)
      {
         setGroundCov(gcm);
      } else {
         ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGptSet::importFromGmlNode bad ground covariance matrix\n";
         return false;
      }
   } else {
      ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGptSet::importFromGmlNode tag "<<GROUNDCOV_TAG<<" not found\n";
      //not an error
      setGroundCov(NEWMAT::SymmetricMatrix(3)); //TBC : is it 0 matrix / should we use no matrix?
   }

   //load all tie points (skip errors but report them)
   vector< ossimRefPtr< ossimXmlNode > > tienodes;
   aGmlNode->findChildNodes(TIEPOINTS_TAG, tienodes);
   if (tienodes.size() <= 0)
   {
      ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGptSet::importFromGmlNode no tag "<<TIEPOINTS_TAG<<" found\n";
      return false;
   }
   
   int badtiecount=0;
   
   for(vector< ossimRefPtr< ossimXmlNode > >::iterator it=tienodes.begin(); it!=tienodes.end(); ++it)
   {
      ossimRefPtr<ossimTieGpt> temp(new ossimTieGpt);
      if (temp->importFromGmlNode(*it,aGmlVersion)) //pointer hacks nor beautiful nor direct
      {
         addTiePoint(temp);
      } else {
         badtiecount++;
      }
   }
   if (badtiecount>0)
   {
      ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGptSet::importFromGmlNode failed to import "<<badtiecount<<" tie point(s)\n";
   }
   return true;
}

operator=()

const ossimTieGptSet & ossimTieGptSet::operator=

(

const ossimTieGptSet &

aSet

)

Definition at line 12 of file ossimTieGptSet.cpp.

References getGroundCov(), getImageCov(), getMasterPath(), getSlavePath(), and getTiePoints().

{
   if (this != &aSet)
   {
      theTies       = aSet.getTiePoints();
      theMasterPath = aSet.getMasterPath();
      theSlavePath  = aSet.getSlavePath();
      theImageCov   = aSet.getImageCov();
      theGroundCov  = aSet.getGroundCov();
   }
   return *this;
}

printTab()

std::ostream & ossimTieGptSet::printTab

(

std::ostream &

os

)

const

text output : header + tab separated tie points

Definition at line 37 of file ossimTieGptSet.cpp.

{
   os<<"MasterPath: "<<getMasterPath()<<endl;
   os<<"SlavePath: "<<getSlavePath()<<endl;
   os<< std::setiosflags(std::ios::fixed) << std::setprecision(15);
   os<<"ImageCov: (2) " <<symMatrixToText(getImageCov()) <<endl;
   os<<"GroundCov: (3) "<<symMatrixToText(getGroundCov())<<endl;
   os<<"TiePoints: ("<<endl;
   for(vector<ossimRefPtr<ossimTieGpt> >::const_iterator it = theTies.begin(); it != theTies.end(); ++it)
   {
      (*it)->printTab(os);
      os<<endl;
   }
   os<<")"<<endl;
   return os;
}

refGroundCov()

NEWMAT::SymmetricMatrix& ossimTieGptSet::refGroundCov ( )

inline

Definition at line 63 of file ossimTieGptSet.h.

{ return theGroundCov; }

refImageCov()

NEWMAT::SymmetricMatrix& ossimTieGptSet::refImageCov ( )

inline

Definition at line 59 of file ossimTieGptSet.h.

{ return theImageCov; }

refTiePoints()

vector<ossimRefPtr<ossimTieGpt> >& ossimTieGptSet::refTiePoints ( )

inline

Definition at line 49 of file ossimTieGptSet.h.

{ return theTies; }

setGroundCov()

void ossimTieGptSet::setGroundCov ( const NEWMAT::SymmetricMatrix &  aCovMat )

inline

Definition at line 61 of file ossimTieGptSet.h.

{ theGroundCov = aCovMat; }

setImageCov()

void ossimTieGptSet::setImageCov ( const NEWMAT::SymmetricMatrix &  aCovMat )

inline

Definition at line 57 of file ossimTieGptSet.h.

{ theImageCov = aCovMat; }

setMasterPath()

void ossimTieGptSet::setMasterPath ( const ossimString &  aPath )

inline

Definition at line 51 of file ossimTieGptSet.h.

{ theMasterPath = aPath; }

setSlavePath()

void ossimTieGptSet::setSlavePath ( const ossimString &  aPath )

inline

Definition at line 54 of file ossimTieGptSet.h.

{ theSlavePath = aPath; }

setTiePoints()

void ossimTieGptSet::setTiePoints ( const vector< ossimRefPtr< ossimTieGpt > > &  aTieSet )

inline

Definition at line 47 of file ossimTieGptSet.h.

{ theTies = aTieSet; }

size()

unsigned int ossimTieGptSet::size ( ) const

inline

Definition at line 67 of file ossimTieGptSet.h.

Referenced by ossimRpcProjection::buildNormalEquation(), ossimSensorModel::buildNormalEquation(), ossimRpcProjection::getResidue(), ossimSensorModel::getResidue(), ossimPolynomProjection::optimizeFit(), and ossimSensorModel::optimizeFit().

{ return (unsigned int)theTies.size(); }

symMatrixToText()

ossimString ossimTieGptSet::symMatrixToText ( const NEWMAT::SymmetricMatrix &  sym, const ossimString &  el_sep = " ", const ossimString &  row_sep = ";"  ) const

protected

ground error covariance matrix

Protected methods

Definition at line 181 of file ossimTieGptSet.cpp.

References ossimString::toString().

{
   // write lower half matrix (easier to see than upper half when left justifying)
   // separate elements and rows 
   ossimString res = row_sep;
   for (int i=1;i<=sym.Nrows();++i) //indices start at 1
   {
      for (int j=1;j<=i;++j)
      {
         if (j!=1) res += el_sep;
         res += ossimString::toString(sym(i,j));
      }
      res += row_sep;
   }
   return res;
}

textToSymMatrix()

NEWMAT::SymmetricMatrix ossimTieGptSet::textToSymMatrix ( const ossimString &  text, unsigned int  dim, const ossimString &  seps = " ;\t\r\n"  ) const

protected

Definition at line 203 of file ossimTieGptSet.cpp.

References ossimString::explode(), ossimNotify(), and ossimNotifyLevel_WARN.

{
   //sep can hold multiple possible separators characters
   //we don't know the matrix size yet, so we put everything into a buffer
   vector<double> buffer;

   vector<ossimString> vsv = text.explode(seps);
   for(vector<ossimString>::const_iterator vit=vsv.begin(); vit!=vsv.end(); ++vit)
   {
      if (vit->size() > 0)
      {
         buffer.push_back(vit->toDouble());
      }
   }

   //check number of elements
   if (buffer.size() != (dim*(dim+1))/2)
   {
      ossimNotify(ossimNotifyLevel_WARN) << "WARNING: ossimTieGptSet::textToSymMatrix wrong element number in sym. matrix : " << buffer.size() <<"\n";
      return NEWMAT::SymmetricMatrix();
   }

   //populate lower half sym matrix
   vector<double>::const_iterator it = buffer.begin();
   NEWMAT::SymmetricMatrix sym(dim);
   for(unsigned int i=1;i<=dim;++i)
   {
      for(unsigned int j=1;j<=i;++j)
      {
         sym(i,j) = *(it++);
      }
   }
   return sym;
}

Member Data Documentation

theGroundCov

NEWMAT::SymmetricMatrix ossimTieGptSet::theGroundCov

protected

image error covariance matrix

Definition at line 101 of file ossimTieGptSet.h.

theImageCov

NEWMAT::SymmetricMatrix ossimTieGptSet::theImageCov

protected

full or relative path to slave dataset

Definition at line 100 of file ossimTieGptSet.h.

theMasterPath

ossimString ossimTieGptSet::theMasterPath

protected

Definition at line 98 of file ossimTieGptSet.h.

theSlavePath

ossimString ossimTieGptSet::theSlavePath

protected

full or relative path to master dataset

Definition at line 99 of file ossimTieGptSet.h.

theTies

std::vector<ossimRefPtr<ossimTieGpt> > ossimTieGptSet::theTies

protected

Protected data members.

Definition at line 97 of file ossimTieGptSet.h.

TIEPTSET_TAG

const char * ossimTieGptSet::TIEPTSET_TAG = "TiePointSet"

static

Public data members.

Definition at line 91 of file ossimTieGptSet.h.

---

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

• ossimTieGptSet.h
• ossimTieGptSet.cpp