Class for representing a single tiepoint on two or more images. More...

#include <TiePoint.h>

Inheritance diagram for ossim::TiePoint:

Public Types
enum	Type { UNASSIGNED, MANUAL, AUTO, GCP }

Public Member Functions
	TiePoint ()

	TiePoint (const TiePoint &copy)

	TiePoint (const Json::Value &tp_json_node)
	Creates new tiepoint from JSON object formatted as: { "id": <unsigned int>="">, // may be ignored if not valid "type": "M"\|"A"\|"G" For “manual”, “auto”, or “GCP-associated” "imagePoints: [ { "imageId": <string>, "x": <double>, "y": <double>, "covariance": [ cxx, cyy, cxy ], "gcpId": <string> Only if associated with a GCP } ] }. More...

virtual	~TiePoint ()

unsigned int	getImageCount () const

const std::string &	getTiePointId () const

void	setTiePointId (const std::string &id)

void	getImagePoint (unsigned int index, std::string &imageId, ossimDpt &imagePoint, NEWMAT::SymmetricMatrix &cov) const
	Fetches the image point coordinates along with image ID and GCP ID if available. More...

void	setImagePoint (std::shared_ptr< Image > image, const ossimDpt &imagePoint, const NEWMAT::SymmetricMatrix &cov)
	Sets image point value and associated measurement covariance for specified image ID. More...

Type	getType () const

void	setType (Type t)

const std::string &	getGcpId () const

void	setGcpId (const std::string &id)

virtual void	loadJSON (const Json::Value &json)

virtual void	saveJSON (Json::Value &json) const

virtual std::ostream &	print (std::ostream &out) const

Public Member Functions inherited from ossim::JsonInterface
	JsonInterface ()

virtual	~JsonInterface ()

Protected Attributes
Type	m_type

std::string	m_tiePointId

std::vector< std::shared_ptr< Image > >	m_images

std::vector< ossimDpt >	m_imagePoints

std::vector< NEWMAT::SymmetricMatrix >	m_covariances

double	m_gsd

std::string	m_gcpId

Static Protected Attributes
static int	s_runningId = 1

Friends
std::ostream &	operator<< (std::ostream &out, const TiePoint &tp)

Detailed Description

Class for representing a single tiepoint on two or more images.

It also represents image-points associated with a ground control point.

Definition at line 28 of file TiePoint.h.

Member Enumeration Documentation

◆ Type

enum ossim::TiePoint::Type

Enumerator
UNASSIGNED
MANUAL
AUTO
GCP

Definition at line 32 of file TiePoint.h.

              {
       UNASSIGNED,
       MANUAL,  //> The point was created or edited manually and contains at least a pair of image points
       AUTO,    //> Result of auto tie point generation and contains at least a pair of image points
       GCP      //> point is associated with a manually-entered ground control. Possibly multiple image points
    };

Constructor & Destructor Documentation

◆ TiePoint() [1/3]

ossim::TiePoint::TiePoint ( )

Definition at line 18 of file TiePoint.cpp.

 :  m_type (UNASSIGNED),
    m_gsd (0.0)
 {
 
 }

◆ TiePoint() [2/3]

ossim::TiePoint::TiePoint ( const TiePoint & copy )

Definition at line 25 of file TiePoint.cpp.

References m_covariances, m_imagePoints, and m_images.

 :  m_type (copy.m_type),
    m_gsd (copy.m_gsd),
    m_gcpId (copy.m_gcpId)
 {
    for (size_t i=0; i<copy.m_images.size(); ++i)
       m_images.push_back(copy.m_images[i]);
 
    for (size_t i=0; i<copy.m_imagePoints.size(); ++i)
       m_imagePoints.push_back(copy.m_imagePoints[i]);
 
    for (size_t i=0; i<copy.m_covariances.size(); ++i)
       m_covariances.push_back(copy.m_covariances[i]);
 }

◆ TiePoint() [3/3]

ossim::TiePoint::TiePoint ( const Json::Value & tp_json_node )

Creates new tiepoint from JSON object formatted as: { "id": <unsigned int>="">, // may be ignored if not valid "type": "M"|"A"|"G" For “manual”, “auto”, or “GCP-associated” "imagePoints: [ { "imageId": <string>, "x": <double>, "y": <double>, "covariance": [ cxx, cyy, cxy ], "gcpId": <string> Only if associated with a GCP } ] }.

Definition at line 40 of file TiePoint.cpp.

References loadJSON().

 :  m_type (UNASSIGNED),
    m_gsd (0.0)
 {
    loadJSON(json_node);
 }

◆ ~TiePoint()

ossim::TiePoint::~TiePoint ( )

virtual

Definition at line 47 of file TiePoint.cpp.

References m_covariances, m_imagePoints, and m_images.

 {
    m_images.clear();
    m_imagePoints.clear();
    m_covariances.clear();
 }

Member Function Documentation

◆ getGcpId()

const std::string& ossim::TiePoint::getGcpId ( ) const

inline

Definition at line 92 of file TiePoint.h.

References m_gcpId.

92 { return m_gcpId; }

ossim::TiePoint::m_gcpId

std::string m_gcpId

Definition: TiePoint.h:119

◆ getImageCount()

unsigned int ossim::TiePoint::getImageCount ( ) const

inline

Definition at line 63 of file TiePoint.h.

References m_images.

63 { return m_images.size(); }

ossim::TiePoint::m_images

std::vector< std::shared_ptr< Image > > m_images

Definition: TiePoint.h:115

◆ getImagePoint()

void ossim::TiePoint::getImagePoint	(	unsigned int	index,
		std::string &	imageId,
		ossimDpt &	imagePoint,
		NEWMAT::SymmetricMatrix &	cov
	)		const

Fetches the image point coordinates along with image ID and GCP ID if available.

Parameters

index	Inout index into the list of images containing this tiepoint
imageId	Output image ID for the ccorresponding image point
imagePoint	image coordinates
cov	image point measurement covariance in (x, y) coordinates

Definition at line 70 of file TiePoint.cpp.

References m_covariances, m_imagePoints, m_images, and ossimDpt::makeNan().

 {
    // Search the PB index list for entry:
    imagePoint.makeNan();
    imageId.clear();
 
    if (index >= m_images.size())
       return;
 
    imageId = m_images[index]->getImageId();
    imagePoint = m_imagePoints[index];
    if (m_covariances.size() > index)
       cov = m_covariances[index];
 }

◆ getTiePointId()

const std::string& ossim::TiePoint::getTiePointId ( ) const

inline

Definition at line 65 of file TiePoint.h.

References m_tiePointId.

65 { return m_tiePointId; }

ossim::TiePoint::m_tiePointId

std::string m_tiePointId

Definition: TiePoint.h:114

◆ getType()

Type ossim::TiePoint::getType ( ) const

inline

Definition at line 89 of file TiePoint.h.

References m_type.

89 { return m_type; }

ossim::TiePoint::m_type

Type m_type

Definition: TiePoint.h:113

◆ loadJSON()

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

virtual

Implements ossim::JsonInterface.

Definition at line 126 of file TiePoint.cpp.

References AUTO, GCP, m_covariances, m_gcpId, m_imagePoints, m_images, m_type, MANUAL, and setTiePointId().

Referenced by TiePoint().

 {
    ostringstream xmsg;
    xmsg<<__FILE__<<": TiePoint(JSON) --";
 
    // ID
    setTiePointId(json_node["id"].asString());
 
    // Type
    string tpType = json_node["type"].asString();
    switch (tpType[0])
    {
    case 'M':
       m_type = TiePoint::MANUAL;
       break;
    case 'A':
       m_type = TiePoint::AUTO;
       break;
    case 'G':
       m_type = TiePoint::GCP;
       break;
    default:
       xmsg<<"Tiepoint JSON field \"type\" must be specified as 'M', 'A', or 'G'.";
       throw ossimException(xmsg.str());
    }
 
    // Read the GCP ID if present:
    if (m_type == TiePoint::GCP)
       m_gcpId = json_node["gcpId"].asString();
 
    // Image points
    const Json::Value& imagePoints = json_node["imagePoints"];
    if (!imagePoints || (imagePoints.size() < 1))
    {
       xmsg<<"Tiepoint JSON field \"imagePoints\" not found or is empty!";
       throw ossimException(xmsg.str());
    }
 
    // Loop over points on each image:
    for (int i=0; i<imagePoints.size(); ++i)
    {
       const Json::Value& p = imagePoints[i];
       if (!p || !(p["imageId"].isString()) || !(p["x"]) || !(p["y"]))
       {
          xmsg<<"Tiepoint JSON field \"imagePoints\" entry is ill-formed or not complete:\n"
                <<p.toStyledString()<<endl;
          throw ossimException(xmsg.str());
       }
 
       string imageId = p["imageId"].asString();
       string filename = p["filename"].asString();
       shared_ptr<Image> image (new Image(imageId, filename));
       m_images.push_back(image);
 
       ossimDpt xy(p["x"].asDouble(), p["y"].asDouble());
       m_imagePoints.push_back(xy);
 
       const Json::Value& covariance = p["covariance"];
       if (covariance.size() == 3)
       {
          NEWMAT::SymmetricMatrix c(2);
          c(1, 1) = covariance[0].asDouble();
          c(2, 2) = covariance[1].asDouble();
          c(1, 2) = covariance[2].asDouble();
          m_covariances.push_back(c);
       }
    }
 }

◆ print()

std::ostream & ossim::TiePoint::print ( std::ostream & out ) const

virtual

Reimplemented in ATP::AutoTiePoint.

Definition at line 239 of file TiePoint.cpp.

References saveJSON().

 {
    Json::Value node;
    saveJSON(node);
    out << node.toStyledString();
    return out;
 }

◆ saveJSON()

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

virtual

Implements ossim::JsonInterface.

Reimplemented in ATP::AutoTiePoint.

Definition at line 195 of file TiePoint.cpp.

References AUTO, GCP, m_covariances, m_imagePoints, m_images, m_tiePointId, m_type, and MANUAL.

Referenced by print().

 {
    // ID
    json_node["id"] = m_tiePointId;
 
    // Type
    string tpType = json_node["type"].asString();
    switch (m_type)
    {
    case TiePoint::MANUAL:
       json_node["type"] = "M";
       break;
    case TiePoint::AUTO:
       json_node["type"] = "A";
       break;
    case TiePoint::GCP:
       json_node["type"] = "G";
       break;
    default:
       json_node["type"] = "UNNASSIGNED";
    }
 
    // Image points
    Json::Value jsonList (Json::arrayValue);
    // Loop over points on each image:
    for (int i=0; i<m_imagePoints.size(); ++i)
    {
       jsonList[i]["filename"] = m_images[i]->getFilename();
       jsonList[i]["imageId"] = m_images[i]->getImageId();
       jsonList[i]["x"] = m_imagePoints[i].x;
       jsonList[i]["y"] = m_imagePoints[i].y;
 
       if (i<m_covariances.size())
       {
          Json::Value covJson (Json::arrayValue);
          covJson[0] = m_covariances[i](1,1);
          covJson[1] = m_covariances[i](2,2);
          covJson[2] = m_covariances[i](1,2);
          jsonList[i]["covariance"] = covJson;
       }
    }
    json_node["imagePoints"] = jsonList;
 }

◆ setGcpId()

void ossim::TiePoint::setGcpId ( const std::string & id )

Definition at line 120 of file TiePoint.cpp.

References GCP, m_gcpId, and m_type.

 {
    m_gcpId = id;
    m_type = GCP;
 }

◆ setImagePoint()

void ossim::TiePoint::setImagePoint	(	std::shared_ptr< Image >	image,
		const ossimDpt &	imagePoint,
		const NEWMAT::SymmetricMatrix &	cov
	)

Sets image point value and associated measurement covariance for specified image ID.

If the image ID is not found, it will be added as new observation.

Definition at line 88 of file TiePoint.cpp.

References m_covariances, m_imagePoints, and m_images.

 {
    bool found = false;
 
    // Possible edit of existing point?
    for (size_t i=0; i<m_images.size(); ++i)
    {
       if (m_images[i]->getImageId().compare(image->getImageId()) == 0)
       {
          found = true;
          if (i >= m_imagePoints.size())
          {
             // This shouldn't happen, but go ahead and resize for this image:
             m_imagePoints.resize(i+1);
             m_covariances.resize(i+1);
          }
          m_imagePoints[i] = imagePoint;
          m_covariances[i] = cov;
          break;
       }
    }
 
    if (!found)
    {
       m_images.push_back(image);
       m_imagePoints.push_back(imagePoint);
       m_covariances.push_back(cov);
    }
 }

◆ setTiePointId()

void ossim::TiePoint::setTiePointId ( const std::string & id )

Definition at line 54 of file TiePoint.cpp.

References m_tiePointId, and s_runningId.

Referenced by loadJSON().

 {
    if (id.empty())
    {
       // Generate ID based on date/time:
       ostringstream tp1;
       tp1<<"TP"<<s_runningId++;
       m_tiePointId = tp1.str();
    }
    else
    {
       // Only accept if there is no ID existing:
       m_tiePointId = id;
    }
 }

◆ setType()

void ossim::TiePoint::setType ( Type t )

inline

Definition at line 90 of file TiePoint.h.

References m_type.

90 { m_type = t; }

ossim::TiePoint::m_type

Type m_type

Definition: TiePoint.h:113

Friends And Related Function Documentation

◆ operator<<

std::ostream& operator<<	(	std::ostream &	out,
		const TiePoint &	tp
	)

friend

Definition at line 108 of file TiePoint.h.

109 { return tp.print(out); }

Member Data Documentation

◆ m_covariances

std::vector<NEWMAT::SymmetricMatrix> ossim::TiePoint::m_covariances

protected

Definition at line 117 of file TiePoint.h.

Referenced by getImagePoint(), loadJSON(), saveJSON(), setImagePoint(), TiePoint(), and ~TiePoint().

◆ m_gcpId

std::string ossim::TiePoint::m_gcpId

protected

Definition at line 119 of file TiePoint.h.

Referenced by getGcpId(), loadJSON(), and setGcpId().

◆ m_gsd

double ossim::TiePoint::m_gsd

protected

Definition at line 118 of file TiePoint.h.

◆ m_imagePoints

std::vector<ossimDpt> ossim::TiePoint::m_imagePoints

protected

Definition at line 116 of file TiePoint.h.

Referenced by ATP::AutoTiePoint::addImageMatch(), ATP::AutoTiePoint::getCmpImagePoint(), getImagePoint(), ATP::AutoTiePoint::getRefImagePoint(), loadJSON(), ATP::AutoTiePoint::print(), ATP::AutoTiePoint::recomputeResidual(), saveJSON(), setImagePoint(), ATP::AutoTiePoint::setRefImagePt(), ATP::AutoTiePoint::setRefViewPt(), TiePoint(), and ~TiePoint().

◆ m_images

std::vector< std::shared_ptr<Image> > ossim::TiePoint::m_images

protected

Definition at line 115 of file TiePoint.h.

Referenced by getImageCount(), getImagePoint(), loadJSON(), saveJSON(), setImagePoint(), TiePoint(), and ~TiePoint().

◆ m_tiePointId

std::string ossim::TiePoint::m_tiePointId

protected

Definition at line 114 of file TiePoint.h.

Referenced by getTiePointId(), ATP::AutoTiePoint::print(), saveJSON(), and setTiePointId().

◆ m_type

Type ossim::TiePoint::m_type

protected

Definition at line 113 of file TiePoint.h.

Referenced by getType(), loadJSON(), saveJSON(), setGcpId(), and setType().

◆ s_runningId

int ossim::TiePoint::s_runningId = 1

staticprotected

Definition at line 120 of file TiePoint.h.

Referenced by setTiePointId().

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

Public Types

Public Member Functions

Protected Attributes

Static Protected Attributes

Friends

Detailed Description

Member Enumeration Documentation

◆ Type

Constructor & Destructor Documentation

◆ TiePoint() [1/3]

◆ TiePoint() [2/3]

◆ TiePoint() [3/3]

◆ ~TiePoint()

Member Function Documentation

◆ getGcpId()

◆ getImageCount()

◆ getImagePoint()

◆ getTiePointId()

◆ getType()

◆ loadJSON()

◆ print()

◆ saveJSON()

◆ setGcpId()

◆ setImagePoint()

◆ setTiePointId()

◆ setType()

Friends And Related Function Documentation

◆ operator<<

Member Data Documentation

◆ m_covariances

◆ m_gcpId

◆ m_gsd

◆ m_imagePoints

◆ m_images

◆ m_tiePointId

◆ m_type

◆ s_runningId