Finds auto-tie-points using the corss-correlation-based matching algorithm. More...

#include <ossimCorrelationSource.h>

Inheritance diagram for ATP::ossimCorrelationSource:

Public Member Functions
	ossimCorrelationSource ()

	ossimCorrelationSource (ossimConnectableObject::ConnectableObjectList &inputSources)

	ossimCorrelationSource (AtpGenerator *generator)

virtual	~ossimCorrelationSource ()

virtual void	initialize ()

virtual ossimRefPtr< ossimImageData >	getTile (const ossimIrect &origin, ossim_uint32 rLevel=0)
	Derived classes implement their particular tiepoint matching algorithms for the requested tile. More...

unsigned int	getNominalCmpPatchSize () const
	For engineering use in annotating CMP image. More...

Public Member Functions inherited from ATP::AtpTileSource
	AtpTileSource (AtpGenerator *generator)

virtual	~AtpTileSource ()

AtpList &	getTiePoints ()
	This list resets with every getTile() call , so make sure tiepoints from previous getTile() calls are being accumulated. More...

virtual ossimScalarType	getOutputScalarType () const
	This will be used to query the output pixel type of the tile source. More...

virtual ossim_uint32	getNumberOfOutputBands () const
	Returns the number of bands in a tile returned from this TileSource. More...

void	filterPoints ()

void	setTiePoints (ossim::TiePointList &atpList)
	Used for testing. More...

Public Member Functions inherited from ossimImageCombiner
	ossimImageCombiner ()

	ossimImageCombiner (ossimObject *owner, int numberOfInputs, int numberOfOutputs, bool inputListIsFixedFlag, bool outputListIsFixedFlag)

	ossimImageCombiner (ossimConnectableObject::ConnectableObjectList &inputSources)

virtual ossimIrect	getBoundingRect (ossim_uint32 resLevel=0) const
	This will return the bounding rect of the source. More...

virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=NULL)
	Method to the load (recreate) the state of an object from a keyword list. More...

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=NULL) const
	Method to save the state of an object to a keyword list. More...

virtual void	updateRects ()
	This will go through and precompute the bounding rects of each input image. More...

virtual ossim_uint32	getNumberOfInputBands () const
	Returns the number of bands available from the input. More...

virtual ossim_uint32	getTileWidth () const
	Returns the default processing tile width. More...

virtual ossim_uint32	getTileHeight () const
	Returns the default processing tile height. More...

virtual double	getNullPixelValue (ossim_uint32 band=0) const
	Each band has a null pixel associated with it. More...

virtual double	getMinPixelValue (ossim_uint32 band=0) const
	Returns the min pixel of the band. More...

virtual double	getMaxPixelValue (ossim_uint32 band=0) const
	Returns the max pixel of the band. More...

virtual ossim_uint32	getNumberOfOverlappingImages (const ossimIrect &rect, ossim_uint32 resLevel=0) const
	Used to retrieve the number of overlapping images withint the given rect. More...

virtual void	getOverlappingImages (std::vector< ossim_uint32 > &result, const ossimIrect &rect, ossim_uint32 resLevel=0) const
	Used to populate the result with the index of the overlapping images. More...

virtual ossimRefPtr< ossimImageData >	getNextTile (ossim_uint32 &returnedIdx, const ossim_uint32 startIdx, const ossimIrect &tileRect, ossim_uint32 resLevel=0)

virtual ossimRefPtr< ossimImageData >	getNextTile (ossim_uint32 &returnedIdx, const ossimIrect &tileRect, ossim_uint32 resLevel=0)

virtual bool	getNextTile (ossim_uint32 &returnedIdx, const ossim_uint32 startIdx, ossimImageData *tile, ossim_uint32 resLevel=0)

virtual ossimRefPtr< ossimImageData >	getNextNormTile (ossim_uint32 &returnedIdx, const ossim_uint32 index, const ossimIrect &tileRect, ossim_uint32 resLevel=0)

virtual ossimRefPtr< ossimImageData >	getNextNormTile (ossim_uint32 &returnedIdx, const ossimIrect &tileRect, ossim_uint32 resLevel=0)

virtual bool	canConnectMyInputTo (ossim_int32 inputIndex, const ossimConnectableObject *object) const
	required to be overriden by derived classes More...

virtual void	connectInputEvent (ossimConnectionEvent &event)

virtual void	disconnectInputEvent (ossimConnectionEvent &event)

virtual void	propertyEvent (ossimPropertyEvent &event)

virtual void	refreshEvent (ossimRefreshEvent &event)

virtual bool	hasDifferentInputs () const

Public Member Functions inherited from ossimImageSource
	ossimImageSource (ossimObject *owner=0)

	ossimImageSource (ossimObject *owner, ossim_uint32 inputListSize, ossim_uint32 outputListSize, bool inputListIsFixedFlag=true, bool outputListIsFixedFlag=true)

virtual	~ossimImageSource ()

virtual ossimRefPtr< ossimImageData >	getTile (const ossimIpt &origin, ossim_uint32 resLevel=0)

virtual bool	getTile (ossimImageData *result, ossim_uint32 resLevel=0)
	Method to get a tile. More...

virtual ossimObject *	getObject ()
	For RTTI support. More...

virtual const ossimObject *	getObject () const
	For RTTI support. More...

virtual void	getDecimationFactor (ossim_uint32 resLevel, ossimDpt &result) const
	Will return the decimation factor for the given resolution level. More...

virtual void	getDecimationFactors (std::vector< ossimDpt > &decimations) const
	Will return an array of all decimations for each resolution level. More...

virtual ossim_uint32	getNumberOfDecimationLevels () const
	Will return the number of resolution levels. More...

virtual void	getOutputBandList (std::vector< ossim_uint32 > &bandList) const
	Initializes bandList. More...

virtual void	getBoundingRect (ossimIrect &rect, ossim_uint32 resLevel=0) const
	Gets the bounding rectangle of the source. More...

virtual void	getValidImageVertices (std::vector< ossimIpt > &validVertices, ossimVertexOrdering ordering=OSSIM_CLOCKWISE_ORDER, ossim_uint32 resLevel=0) const
	ordering specifies how the vertices should be arranged. More...

virtual ossimRefPtr< ossimImageGeometry >	getImageGeometry ()
	Returns the image geometry object associated with this tile source or NULL if not defined. More...

virtual void	setImageGeometry (const ossimImageGeometry *geom)
	Default implementation sets geometry of the first input to the geometry specified. More...

virtual void	saveImageGeometry () const
	Default method to call input's saveImageGeometry. More...

virtual void	saveImageGeometry (const ossimFilename &geometry_file) const
	Default method to call input's saveImageGeometry. More...

virtual ossimRefPtr< ossimProperty >	getProperty (const ossimString &name) const

virtual void	setProperty (ossimRefPtr< ossimProperty > property)

virtual void	getPropertyNames (std::vector< ossimString > &propertyNames) const

virtual bool	isIndexedData () const

Public Member Functions inherited from ossimSource
	ossimSource (ossimObject *owner=0)

	ossimSource (ossimObject *owner, ossim_uint32 inputListSize, ossim_uint32 outputListSize, bool inputListIsFixedFlag=true, bool outputListIsFixedFlag=true)

virtual	~ossimSource ()

virtual bool	isSourceEnabled () const

virtual void	enableSource ()

virtual void	disableSource ()

virtual bool	getEnableFlag () const

virtual void	setEnableFlag (bool flag)

virtual bool	isInitialized () const

virtual void	setInitializedFlag (bool flag)

virtual std::ostream &	print (std::ostream &out) const
	Outputs theErrorStatus as an ossimErrorCode and an ossimString. More...

Public Member Functions inherited from ossimConnectableObject
	ossimConnectableObject (ossimObject *owner=0)
	Base constructor of this object. More...

	ossimConnectableObject (ossimObject *owner, ossim_int32 inputListSize, ossim_int32 outputListSize, bool inputListIsFixedFlag=true, bool outputListIsFixedFlag=true)

virtual	~ossimConnectableObject ()

void	setId (const ossimId &id)
	All connectable objects will have id's. More...

const ossimId &	getId () const
	Will allow us to get this object's id. More...

const ossimObject *	getOwner () const
	Fetches the current owner, most likely a container but not limited to one. More...

virtual void	changeOwner (ossimObject *owner)
	Permits changing the object's owner. More...

virtual void	setDescription (const ossimString &description)

virtual ossimString	getDescription () const

virtual bool	isConnected (ossimConnectableObjectDirectionType direction=CONNECTABLE_DIRECTION_INPUT) const
	will check the direction specified to see if all slots are full. More...

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findConnectableObject(const ossimId &id))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findObjectOfType(RTTItypeid typeId, ossimConnectableObjectDirectionType directionType, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findObjectOfType(const ossimString &obj, ossimConnectableObjectDirectionType directionType, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual ossimConnectableObject *findInputObjectOfType(const ossimString &className))

virtual ossim_int32	findInputIndex (const ossimConnectableObject *object)
	Return a valid index of the input list if the passed in object is found else return -1. More...

virtual ossim_int32	findInputIndex (const ossimId &id)
	Return a valid index of the input list if the passed id is found else return -1. More...

virtual ossim_int32	findOutputIndex (const ossimConnectableObject *object)
	Return a valid index of the output list if the passed in object is found else return -1. More...

virtual ossim_int32	findOutputIndex (const ossimId &id)
	Return a valid index of the output list if the passed in object is found else return -1. More...

virtual ossim_int32	getMyInputIndexToConnectTo (ossimConnectableObject *object) const
	Should return the first available index to connect to. More...

virtual ossim_int32	getMyOutputIndexToConnectTo (ossimConnectableObject *object) const
	Should return the first available index to connect to. More...

virtual bool	canConnectMyOutputTo (ossim_int32 myOutputIndex, const ossimConnectableObject *object) const
	default implementation is to allow anyone to connect to us. More...

virtual void	disconnect (ossimConnectableObject *object=0)
	Will disconnect the object passed in. More...

virtual void	disconnect (const ossimId &id)
	Will disconnect the object passed in. More...

virtual ossimRefPtr< ossimConnectableObject >	disconnectMyInput (ossim_int32 inputIndex, bool disconnectOutputFlag=true, bool createEventFlag=true)
	Will disconnect the object at the given input index and generate a connection event. More...

virtual void	disconnectMyInput (ossimConnectableObject *input, bool disconnectOutputFlag=true, bool createEventFlag=true)
	Finds the index of the passed in input and calls disconnectMyInput(inputIndex, disconnectOutputFlag, createEventFlag);. More...

virtual void	disconnectMyInputs (ConnectableObjectList &inputList, bool disconnectOutputFlag=true, bool createEventFlag=true)

virtual ossimRefPtr< ossimConnectableObject >	disconnectMyOutput (ossim_int32 outputIndex, bool disconnectInputFlag=true, bool createEventFlag=true)
	Will disconnect the object at the given output index and generate a connection event. More...

virtual void	disconnectMyOutput (ossimConnectableObject *output, bool disconnectInputFlag=true, bool createEventFlag=true)
	Will disconnect the output object. More...

virtual void	disconnectMyOutputs (ConnectableObjectList &outputList, bool disconnectOutputFlag=true, bool createEventFlag=true)

virtual void	disconnectAllInputs ()
	Will disconnect all of the input objects. More...

virtual void	disconnectAllOutputs ()
	Will disconnect all of the output objects. More...

virtual ossim_int32	connectMyInputTo (ossimConnectableObject *inputObject, bool makeOutputConnection=true, bool createEventFlag=true)
	Will try to connect this objects input to the passed in object. More...

virtual ossim_int32	connectMyInputTo (ossim_int32 inputIndex, ossimConnectableObject *inputObject, bool makeOutputConnection=true, bool createEventFlag=true)
	Will connect the specified input to the passed in object. More...

virtual bool	connectMyInputTo (ConnectableObjectList &inputList, bool makeOutputConnection=true, bool createEventFlag=true)

virtual ossim_int32	connectMyOutputTo (ossimConnectableObject *outputObject, bool makeInputConnection=true, bool createEventFlag=true)
	Will try to connect this objects output to the passed in object. More...

virtual bool	connectMyOutputTo (ConnectableObjectList &outputList, bool makeInputConnection=true, bool createEventFlag=true)

virtual bool	connectInputList (ConnectableObjectList &inputList)
	Will disconnect itself from all inputs and reset to the passed in input list. More...

virtual bool	connectOutputList (ConnectableObjectList &outputList)
	Will disconnect itself from all outputs and reset to the passed in output list. More...

virtual ossim_uint32	getNumberOfInputs () const
	Returns the number of input objects. More...

virtual ossim_uint32	getNumberOfOutputs () const
	Return the number of output objects. More...

ossimConnectableObject *	getInput (ossim_uint32 index=0)
	returns the object at the specified index. More...

const ossimConnectableObject *	getInput (ossim_uint32 index=0) const
	returns the object at the specified index. More...

ossimConnectableObject *	getOutput (ossim_uint32 index=0)
	returns the object at the specified index. More...

const ossimConnectableObject *	getOutput (ossim_uint32 index=0) const
	returns the object at the specified index. More...

virtual void	setNumberOfInputs (ossim_int32 numberOfInputs)
	Will set the number of inputs. More...

virtual bool	getInputListIsFixedFlag () const

virtual bool	getOutputListIsFixedFlag () const

virtual void	setNumberOfOutputs (ossim_int32 numberOfInputs)
	Will set the number of outputs. More...

const ConnectableObjectList &	getInputList () const

const ConnectableObjectList &	getOutputList () const

ConnectableObjectList &	getInputList ()

ConnectableObjectList &	getOutputList ()

	OSSIM_DEPRECATE_METHOD (virtual void findAllObjectsOfType(ConnectableObjectList &result, const RTTItypeid &typeInfo, bool recurse=true))

	OSSIM_DEPRECATE_METHOD (virtual void findAllObjectsOfType(ConnectableObjectList &result, const ossimString &className, bool recurse=true))

virtual void	propagateEventToOutputs (ossimEvent &event)

virtual void	propagateEventToInputs (ossimEvent &event)

virtual void	setProperty (const ossimString &name, const ossimString &value)

virtual ossim_uint32	saveStateOfAllInputs (ossimKeywordlist &kwl, bool saveThisStateFlag=true, ossim_uint32 objectIndex=1, const char *prefix=0) const
	Save the state of all inputs to a keyword list. More...

virtual bool	fillContainer (ossimConnectableContainer &container)
	Inserts this object and all of its children and inputs into the container provided. More...

bool	moveInputUp (const ossimId &id)
	Moves the input connection matching id up one in the connection list. More...

bool	moveInputDown (const ossimId &id)
	Moves the input connection matching id down one in the connection list. More...

bool	moveInputToTop (const ossimId &id)
	Moves the input connection matching id to the top of the connection list. More...

bool	moveInputToBottom (const ossimId &id)
	Moves the input connection matching id to the bottom of the connection list. More...

virtual void	accept (ossimVisitor &visitor)
	We will add a visitor interface for all connectable objects. More...

Public Member Functions inherited from ossimObject
	ossimObject ()

virtual	~ossimObject ()

virtual ossimObject *	dup () const

virtual ossimString	getShortName () const

virtual ossimString	getLongName () const

virtual ossimString	getClassName () const

virtual RTTItypeid	getType () const

virtual bool	canCastTo (ossimObject *obj) const

virtual bool	canCastTo (const RTTItypeid &id) const

virtual bool	canCastTo (const ossimString &parentClassName) const

virtual bool	isEqualTo (const ossimObject &obj, ossimCompareType compareType=OSSIM_COMPARE_FULL) const

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 ossimListenerManager
	ossimListenerManager ()

virtual	~ossimListenerManager ()

virtual void	fireEvent (ossimEvent &event)

virtual bool	addListener (ossimListener *listener)

virtual bool	removeListener (ossimListener *listener)

virtual bool	findListener (ossimListener *listener)

Public Member Functions inherited from ossimPropertyInterface
	ossimPropertyInterface ()

virtual	~ossimPropertyInterface ()

virtual ossimString	getPropertyValueAsString (const ossimString &name) const

void	getPropertyList (std::vector< ossimRefPtr< ossimProperty > > &propertyList) const

void	setProperties (std::vector< ossimRefPtr< ossimProperty > > &propertyList)

Public Member Functions inherited from ossimErrorStatusInterface
	ossimErrorStatusInterface ()

virtual	~ossimErrorStatusInterface ()

virtual ossimErrorCode	getErrorStatus () const

virtual ossimString	getErrorStatusString () const

virtual void	setErrorStatus (ossimErrorCode error_status) const

virtual void	setErrorStatus () const

virtual void	clearErrorStatus () const

bool	hasError () const

Public Member Functions inherited from ossimConnectableObjectListener
	ossimConnectableObjectListener ()

virtual	~ossimConnectableObjectListener ()

virtual void	processEvent (ossimEvent &event)
	ProcessEvent. More...

virtual void	objectDestructingEvent (ossimObjectDestructingEvent &)

virtual void	connectionEvent (ossimConnectionEvent &)

virtual void	disconnectOutputEvent (ossimConnectionEvent &)

virtual void	connectOutputEvent (ossimConnectionEvent &)

virtual void	addObjectEvent (ossimContainerEvent &)

virtual void	removeObjectEvent (ossimContainerEvent &)

virtual void	containerEvent (ossimContainerEvent &)

Public Member Functions inherited from ossimListener
	ossimListener ()

virtual	~ossimListener ()

void	enableListener ()

void	disableListener ()

void	setListenerEnableFlag (bool flag)

bool	isListenerEnabled () const

bool	getListenerEnableFlag () const

Protected Member Functions
void	findFeatures (const ossimImageData *data, std::vector< ossimIpt > &featurePts)
	Given an image tile, locates prominent features in that tile. Use. More...

bool	correlate (std::shared_ptr< AutoTiePoint > atp)

bool	OpenCVCorrelation (std::shared_ptr< AutoTiePoint > atp, const ossimImageData refpatch, const ossimImageData cmppatch)

Protected Member Functions inherited from ATP::AtpTileSource
	AtpTileSource ()

	AtpTileSource (ossimConnectableObject::ConnectableObjectList &inputSources)

virtual void	allocate ()

void	filterWithParallax ()

void	computeParallax ()

void	computeParallaxStatistics ()

void	filterWithoutParallax ()

void	pruneList ()
	Caps the max number of TPs given the list, which is the list of filtered TPs for the tile. More...

void	initializeStaticMembers ()

Protected Member Functions inherited from ossimImageCombiner
virtual	~ossimImageCombiner ()

void	precomputeBounds () const

Protected Member Functions inherited from ossimImageSource
	ossimImageSource (const ossimImageSource &rhs)

const ossimImageSource &	operator= (const ossimImageSource &)

Protected Member Functions inherited from ossimSource
	ossimSource (const ossimSource &rhs)

const ossimSource &	operator= (const ossimSource &rhs)

Protected Member Functions inherited from ossimConnectableObject
ossimConnectableObject *	findObjectOfType (ConnectableObjectList *connectableList, ossimVisitor &visitor)

Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Protected Member Functions inherited from ossimListenerManager
	ossimListenerManager (const ossimListenerManager &rhs)

Protected Attributes
unsigned int	m_nominalCmpPatchSize

Protected Attributes inherited from ATP::AtpTileSource
std::shared_ptr< AtpGenerator >	m_generator

AtpList	m_tiePoints

ossimRefPtr< ossimImageData >	m_tile

ParallaxInfo	m_paxInfo

bool	m_considerParallax

Protected Attributes inherited from ossimImageCombiner
ossim_uint32	theLargestNumberOfInputBands

ossim_uint32	theInputToPassThrough

bool	theHasDifferentInputs

ossimRefPtr< ossimImageData >	theNormTile

std::vector< ossimIrect >	theFullResBounds

bool	theComputeFullResBoundsFlag

ossim_uint32	theCurrentIndex

Protected Attributes inherited from ossimSource
bool	theEnableFlag

bool	theInitializedFlag

Protected Attributes inherited from ossimConnectableObject
ossimId	theId

ossimString	theDescription

ossimObject *	theOwner

bool	theInputListIsFixedFlag
	Indicates whether the theInputObjectList is fixed. More...

bool	theOutputListIsFixedFlag
	Indicates whether the theOutputObjectList is fixed. More...

ConnectableObjectList	theInputObjectList
	Holds a list of input objects. More...

ConnectableObjectList	theOutputObjectList
	Holds a list of output objects. More...

Protected Attributes inherited from ossimListenerManager
std::list< ossimListener * >	theListenerList

bool	theEnabledFlag

std::list< ossimListener * >	theDelayedAdd

std::list< ossimListener * >	theDelayedRemove

bool	theFireEventFlag

Protected Attributes inherited from ossimErrorStatusInterface
ossimErrorCode	theErrorStatus

Protected Attributes inherited from ossimListener
bool	theListenerEnableFlag

Additional Inherited Members
Public Types inherited from ossimConnectableObject
enum	ossimConnectableObjectDirectionType { CONNECTABLE_DIRECTION_NONE = 0, CONNECTABLE_DIRECTION_INPUT = 1, CONNECTABLE_DIRECTION_OUTPUT = 2 }

typedef std::vector< ossimRefPtr< ossimConnectableObject > >	ConnectableObjectList

Static Protected Attributes inherited from ATP::AtpTileSource
static double	s_minVectorResDiff = 0

static double	s_maxDiffRatio = 1.0

static double	s_cosMaxAngleDiff = 0

static double	s_maxPaxDev = 1.0

static double	s_maxPaxPix = 2.0

static unsigned int	s_minNumConsistent = 3

static unsigned int	s_percentConsistent = 50

static unsigned int	s_numTpsPerTile = 2

static bool	s_useRasterMode = false

static bool	s_initialized = false

static unsigned int	s_numFilterIterations = 0

Detailed Description

Finds auto-tie-points using the corss-correlation-based matching algorithm.

Definition at line 21 of file ossimCorrelationSource.h.

Constructor & Destructor Documentation

◆ ossimCorrelationSource() [1/3]

ATP::ossimCorrelationSource::ossimCorrelationSource ( )

Definition at line 19 of file ossimCorrelationSource.cpp.

 : m_nominalCmpPatchSize(0)
 {
    // PRIVATE, SHOULD NEVER BE CALLED. WOULD NEED TO CALL INITIALIZE
 }

◆ ossimCorrelationSource() [2/3]

ATP::ossimCorrelationSource::ossimCorrelationSource ( ossimConnectableObject::ConnectableObjectList & inputSources )

Definition at line 25 of file ossimCorrelationSource.cpp.

References initialize().

 : AtpTileSource(inputSources),
   m_nominalCmpPatchSize(0)
 {
    initialize();
 }

◆ ossimCorrelationSource() [3/3]

ATP::ossimCorrelationSource::ossimCorrelationSource ( AtpGenerator * generator )

Definition at line 32 of file ossimCorrelationSource.cpp.

 : AtpTileSource(generator),
   m_nominalCmpPatchSize(0)
 {
    // PRIVATE, SHOULD NEVER BE CALLED. WOULD NEED TO CALL INITIALIZE
 }

◆ ~ossimCorrelationSource()

ATP::ossimCorrelationSource::~ossimCorrelationSource ( )

virtual

Definition at line 39 of file ossimCorrelationSource.cpp.

40 {

41 }

Member Function Documentation

◆ correlate()

bool ATP::ossimCorrelationSource::correlate ( std::shared_ptr< AutoTiePoint > atp )

protected

Definition at line 275 of file ossimCorrelationSource.cpp.

References ossim::JsonParam::asUint(), CINFO, CWARN, ossim::JsonConfig::diagnosticLevel(), ossim::JsonConfig::getParameter(), ATP::AtpConfig::instance(), ATP::AtpTileSource::m_generator, m_nominalCmpPatchSize, max, min, OpenCVCorrelation(), and OSSIM_FULL.

Referenced by getTile().

 {
    // This method returns TRUE if a match was found
 
    const ossimString MODULE("ossimCorrelationSource::correlate() -- ");
    AtpConfig& config = AtpConfig::instance();
 
    // Establish the REF patch rect centered on the viewpoint and the CMP patch rect sized by image
    // error and offset by prior residuals:
    unsigned int refPatchSize = AtpConfig::instance().getParameter("corrWindowSize").asUint();
    ossimDpt refViewPt;
    atp->getRefViewPoint(refViewPt);
    ossimIrect refPatchRect(refViewPt, refPatchSize, refPatchSize);
    ossimIrect cmpPatchRect(refViewPt, m_nominalCmpPatchSize, m_nominalCmpPatchSize);
 
    // Grab the image patches from the cmp and ref images.
    ossimRefPtr<ossimImageData> refpatch (m_generator->getRefChain()->getTile(refPatchRect, 0));
    if (!refpatch.valid())
    {
       CWARN << MODULE << "Error getting ref patch image data." << endl;
       return false;
    }
 
    if (config.diagnosticLevel(5))
    {
       ossimDpt refImgPt, cmpImgPt;
       m_generator->getRefIVT()->viewToImage(refViewPt, refImgPt);
       m_generator->getCmpIVT()->viewToImage(refViewPt, cmpImgPt);
       CINFO<<"\nFeature view pt: "<<refViewPt
           <<"\n     REF img pt: "<<refImgPt
           <<"\n     CMP img pt: "<<cmpImgPt<<endl;
       refpatch->write("REF_PATCH.RAS");
 
       vector<double> min, max;
       refpatch->computeMinMaxPix(min, max);
       if (min.size() && max.size())
          CINFO<<"   REF min, max: "<<(int)min[0]<<", "<<(int)max[0]<<endl;
    }
 
    ossimDataObjectStatus stat = refpatch->getDataObjectStatus();
    if (stat != OSSIM_FULL)
    {
       if (config.diagnosticLevel(5))
          CINFO<<MODULE << "REF patch contained a null pixel. Skipping this point..."<<endl;
       return false;
    }
 
    ossimRefPtr<ossimImageData> cmppatch (m_generator->getCmpChain()->getTile(cmpPatchRect, 0));
    if (!cmppatch.valid())
    {
       CWARN << MODULE << "Error getting cmp patch image data." << endl;
       return false;
    }
    if (cmppatch->getDataObjectStatus() != OSSIM_FULL)
    {
       if (config.diagnosticLevel(5))
          CINFO<<MODULE << "CMP patch contained a null pixel. Skipping this point..."<<endl;
       return false;
    }
 
    if (config.diagnosticLevel(5))
    {
       cmppatch->write("CMP_PATCH.RAS");
       vector<double> min, max;
       cmppatch->computeMinMaxPix(min, max);
       if (min.size() && max.size())
          CINFO << "   CMP min, max: " << (int) min[0] << ", " << (int) max[0]<< "\n" << endl;
    }
 
    // Invoke the proper correlation code to arive at the peak collection for this TP:
    bool corr_ok;
    corr_ok = OpenCVCorrelation(atp, refpatch.get(), cmppatch.get());
    int numMatches = atp->getNumMatches();
 
    // The peaks for the given patch pair have been established and stored in the TPs.
    if (corr_ok)
    {
       if (config.diagnosticLevel(4))
       {
          if (numMatches)
          {
             double corr_value;
             atp->getConfidenceMeasure(corr_value);
             CINFO<<MODULE<<"Match found for TP "<<atp->getTiePointId()<<" = "<<corr_value<<endl;
          }
         else
             CINFO<<MODULE<<"No match found for TP "<<atp->getTiePointId()<<endl;
       }
    }
    else // Correlation problem occurred
    {
       CWARN << MODULE << "Error encountered during correlation. Aborting correlation." << endl;
       return false;
    }
 
    if (config.diagnosticLevel(5))
    {
       ossimDpt cmpimgpt,refimgpt,refviewpt,cmpviewpt;
       ossimGpt refGpt;
       atp->getRefImagePoint(refimgpt);
       atp->getRefViewPoint(refviewpt);
       atp->getCmpImagePoint(cmpimgpt);
       atp->getCmpViewPoint(cmpviewpt);
       atp->getRefGroundPoint(refGpt);
       if(numMatches>0)
       {
          double val=0;
          ossimDpt residual;
          atp->getConfidenceMeasure(val);
          atp->getVectorResidual(residual);
          CINFO<<"AutoTiePoint: ("<<atp->getTiePointId()<<") has "<<numMatches<<" matches,\n"
                << "  best: (" << val << ") residual: " << residual <<"\n"
                << "  ref gpt:        "<<refGpt<<"\n"
                << "  cmpimg center:  "<<cmpimgpt<<"\n"
                << "  refimg center:  "<<refimgpt<<"\n"
                << "  cmpview center: "<<cmpviewpt<<"\n"
                << "  refview center: "<<refviewpt<<endl;
          CINFO<<endl;
       }
       else {
          CINFO<<"AutoTiePoint: (" << atp->getTiePointId() << ") has no peaks.\n"
                << "  ref gpt:        "<<refGpt<<"\n"
                << "  refimg center:  "<<refimgpt<<"\n"
                << "  refview center: "<<refviewpt<<endl;
       }
    }
 
    if (numMatches)
       return true;
    return false;
 }

◆ findFeatures()

void ATP::ossimCorrelationSource::findFeatures	(	const ossimImageData *	data,
		std::vector< ossimIpt > &	featurePts
	)

protected

Given an image tile, locates prominent features in that tile. Use.

Definition at line 169 of file ossimCorrelationSource.cpp.

References ossim::JsonParam::asBool(), ossim::JsonParam::asFloat(), ossim::JsonParam::asUint(), CFATAL, CINFO, ATP::convertToIpl(), CWARN, ossimDataObject::getDataObjectStatus(), ossimImageData::getImageRectangle(), ossimImageData::getNullPix(), ossim::JsonConfig::getParameter(), ossimImageData::getPix(), ATP::AtpConfig::instance(), OSSIM_EMPTY, OSSIM_PARTIAL, ossimIrect::ul(), x, and y.

Referenced by getTile().

 {
    const char* MODULE = "ossimCorrelationSource::findFeatures() -- ";
 
    feature_points.clear();
    if (!imageChip || (imageChip->getDataObjectStatus() == OSSIM_EMPTY))
    {
       CWARN<<MODULE<<"WARNING: NULL or empty image data passed in."<<endl;
       return;
    }
 
    // THE FOLLOWING ARE CRITICAL VALUES AND MAYBE SHOULD BE READ FROM KWL:
    AtpConfig& config = AtpConfig::instance();
    double refPatchSize = (double) config.getParameter("corrWindowSize").asUint(); // min distance between points
    static const double quality = config.getParameter("minFeatureStrength").asFloat();
    static const int use_harris= (int) config.getParameter("useHarrisCorner").asBool();
    static const double harris_k = config.getParameter("harrisKFactor").asFloat();
    const int averaging_block_size = (int) refPatchSize;
 
 //   imageChip->write("imageChip.ras");//### TODO REMOVE
    IplImage *ipl_image = convertToIpl(imageChip);
    if(!ipl_image)
    {
       CFATAL<<MODULE << "ERROR: Got null IplImage pointer converting from ossimImageData*!";
       return;
    }
 //   cvNamedWindow("ipl_image", 1); //###
 //   cvShowImage("ipl_image", ipl_image); //###
 
    // Need to mask pixels outside of intersection:
    ossimIpt tileUL (imageChip->getImageRectangle().ul());
    IplImage* mask  = 0;
    double null_pixel = imageChip->getNullPix(0);
    if (imageChip->getDataObjectStatus() == OSSIM_PARTIAL)
    {
       CvSize bufsize = cvGetSize(ipl_image);
       mask  = cvCreateImage(bufsize, IPL_DEPTH_8U, 1 );
       ossimDpt pt;
       long offset = 0;
       for (int y=0; y<bufsize.height; y++)
       {
          for (int x=0; x<=bufsize.width-1; x++)
          {
             if (imageChip->getPix(offset) != null_pixel)
                mask->imageData[offset] = (unsigned char) 0xFF;
             else
                mask->imageData[offset] = (unsigned char) 0;
             ++offset;
          }
       }
    }
 
    // Use CV to find features in the patch:
    // Adjust the number of features to look for if we are doing adaptive correlation thresholding
    // (ACT). This would be more appropriate to call "secondary feature consideration":
 //   IplImage* harris  = cvCreateImage(cvGetSize(ipl_image), 32, 1 );
 //   cvCornerHarris(ipl_image, harris, 10, 5);
 //   cvNamedWindow("Harris", CV_WINDOW_AUTOSIZE);
 //   cvShowImage ("Harris", harris);
 //   cvWaitKey();
 
    int num_pts = (int) config.getParameter("numFeaturesPerTile").asUint();
    CvPoint2D32f* points = (CvPoint2D32f*)cvAlloc(num_pts*sizeof(CvPoint2D32f));
    cvGoodFeaturesToTrack(ipl_image, 0, 0, points, &num_pts, quality, refPatchSize, mask,
                          averaging_block_size, use_harris, harris_k);
 
    // Loop over all features found in this patch and assign a feature point at that view
    // point. IMPORTANT NOTE: it is assumed that the ordering of the points[] array is by
    // descending strength of feature.
    unsigned int num_added = 0;
    for(int i=0; i<num_pts; i++)
    {
       // Correct point for the view-space offset of the search patch since points are relative to
       // patch upper left:
       CvPoint pt=cvPointFrom32f(points[i]);
       ossimDpt viewPt (pt.x, pt.y);
       viewPt += tileUL;
 
       // TODO REMOVE
 //      ossimDpt imagePt;
 //      m_generator->getRefIVT()->viewToImage(viewPt, imagePt);
 //      CINFO<<"  Feature REF image point: "<<imagePt<<endl;
 
       // Good feature found, set the feature point's attributes and save to list:
       feature_points.push_back(viewPt);
       ++num_added;
    }
 
    if (AtpConfig::instance().diagnosticLevel(2))
    {
       if (num_added)
          CINFO<<MODULE<<"Number of features found in search patch: "<<num_added<<endl;
       else
          CINFO<<MODULE<<"No features found."<<endl;
    }
 
    // Cleanup mem use:
 //   cvReleaseImage(&harris);
    cvReleaseImage(&mask);
    cvReleaseImage(&ipl_image);
    cvFree((void**)&points);
 
    return;
 }

◆ getNominalCmpPatchSize()

unsigned int ATP::ossimCorrelationSource::getNominalCmpPatchSize ( ) const

inline

For engineering use in annotating CMP image.

Definition at line 35 of file ossimCorrelationSource.h.

35 { return m_nominalCmpPatchSize; }

ATP::ossimCorrelationSource::m_nominalCmpPatchSize

unsigned int m_nominalCmpPatchSize

Definition: ossimCorrelationSource.h:47

◆ getTile()

ossimRefPtr< ossimImageData > ATP::ossimCorrelationSource::getTile	(	const ossimIrect &	origin,
		ossim_uint32	rLevel = `0`
	)

virtual

Derived classes implement their particular tiepoint matching algorithms for the requested tile.

It is not clear what the output tile needs to be, since the product of this filter is the list of tiepoints (available through the getTiePoints() method). Recommend simply passing through the corresponding REF image tile.

Implements ATP::AtpTileSource.

Definition at line 79 of file ossimCorrelationSource.cpp.

References ATP::AtpTileSource::allocate(), ossim::JsonParam::asBool(), ossim::JsonParam::asUint(), CINFO, correlate(), ossim::JsonConfig::diagnosticLevel(), ATP::AtpTileSource::filterPoints(), findFeatures(), ossimRefPtr< T >::get(), ossimDataObject::getDataObjectStatus(), ossimConnectableObject::getNumberOfInputs(), ossim::JsonConfig::getParameter(), ATP::AtpConfig::instance(), ossimIrect::lr(), ATP::AtpTileSource::m_generator, ATP::AtpTileSource::m_tiePoints, ATP::AtpTileSource::m_tile, OSSIM_EMPTY, ossim::JsonConfig::paramExists(), ossimImageData::setImageRectangle(), ossimIrect::ul(), ossimIpt::x, x, ossimIpt::y, and y.

 {
    static const char* MODULE = "ossimCorrelationSource::getTile()  ";
    AtpConfig& config = AtpConfig::instance();
    if (config.diagnosticLevel(2))
       CINFO<<"\n\nossimCorrelationSource::getTile() -- tileRect UL: "<<tileRect.ul()<<endl;
    m_tiePoints.clear();
 
    if(getNumberOfInputs() < 2)
       return 0;
    if (!m_tile)
       allocate();
 
    // The tile rect (in view space) is referenced by the tiepoint filtering code:
    m_tile->setImageRectangle(tileRect);
 
    string sid(""); // Leave blank to have it auto-assigned by AutoTiePoint constructor
    if (!config.getParameter("useRasterMode").asBool())
    {
       m_tile = m_generator->getRefChain()->getTile(tileRect, resLevel);
       if (m_tile->getDataObjectStatus() == OSSIM_EMPTY)
          return m_tile;
 
       // Need to search for features in the REF tile first, then consider only those locations
       // for correlating:
       vector<ossimIpt> featurePoints;
       ossimRefPtr<ossimImageData> tileptr (m_tile);
 
       findFeatures(tileptr.get(), featurePoints);
       if (featurePoints.empty())
          return m_tile;
 
       // Loop over features to perform correlations:
       for (size_t i=0; i<featurePoints.size(); ++i)
       {
          shared_ptr<ATP::AutoTiePoint> atp (new ATP::AutoTiePoint(m_generator, sid));
          atp->setRefViewPt(featurePoints[i]);
 
          // Trick here to keep using the same ID until a good correlation is found:
          if (!correlate(atp))
          {
             sid = atp->getTiePointId();
             //atp->setTiePointId("NP");
             //m_tiePoints.push_back(atp);
          }
          else
          {
             m_tiePoints.push_back(atp);
             sid.clear();
          }
       }
       if (config.diagnosticLevel(2))
          CINFO<<MODULE<<"Before filtering: num matches in tile = "<<m_tiePoints.size()<<endl;
    }
    else // raster mode
    {
      // Scan raster-fashion along REF tile and correlate at intervals:
       unsigned int num_attempts = 0;
       int corrStepSize = 1;
       if (config.paramExists("corrStepSize"))
          corrStepSize = (int) config.getParameter("corrStepSize").asUint();
       for (int y = tileRect.ul().y; y < tileRect.lr().y; y += corrStepSize)
       {
          for (int x = tileRect.ul().x; x < tileRect.lr().x; x += corrStepSize)
          {
             ++num_attempts;
             shared_ptr<AutoTiePoint> atp (new AutoTiePoint(m_generator, sid));
             atp->setRefViewPt(ossimDpt(x,y));
 
              // Trick here to keep using the same ID until a good correlation is found:
             if (!correlate(atp))
                sid = atp->getTiePointId();
             else
             {
                m_tiePoints.push_back(atp);
                sid.clear();
             }
          }
       }
       if (config.diagnosticLevel(2))
          CINFO<<MODULE<<"Tile match ratio: "<<m_tiePoints.size()<<" / "<<num_attempts<<endl;
 
    }
 
    filterPoints();
 
    return m_tile;
 }

◆ initialize()

void ATP::ossimCorrelationSource::initialize ( )

virtual

Reimplemented from ATP::AtpTileSource.

Definition at line 43 of file ossimCorrelationSource.cpp.

References ossim::JsonParam::asUint(), ossimSensorModel::getNominalPosError(), ossim::JsonConfig::getParameter(), ATP::AtpTileSource::initialize(), ATP::AtpConfig::instance(), ATP::AtpTileSource::m_generator, m_nominalCmpPatchSize, ossimDpt::x, and ossimDpt::y.

Referenced by ossimCorrelationSource().

 {
    // The base class sets up the input (image-space) protion of the chain:
    AtpTileSource::initialize();
 
    unsigned int refPatchSize = AtpConfig::instance().getParameter("corrWindowSize").asUint(); // min distance between points
    m_nominalCmpPatchSize = DEFAULT_CMP_PATCH_SIZING_FACTOR*refPatchSize;
    double total_error = 0;
    auto refIVT = m_generator->getRefIVT();
    auto cmpIVT = m_generator->getCmpIVT();
    if (refIVT.valid() && cmpIVT.valid())
    {
       ossimDpt gsd = refIVT->getOutputMetersPerPixel();
       double nominalGsd = (gsd.x + gsd.y)/2.0;
 
       // Fetch the CE90 of both images to determine cmp image search patch size:
       ossimSensorModel* ref_sm = dynamic_cast<ossimSensorModel*>(
               refIVT->getImageGeometry()->getProjection());
       ossimSensorModel* cmp_sm = dynamic_cast<ossimSensorModel*>(
               cmpIVT->getImageGeometry()->getProjection());
       if (ref_sm && cmp_sm)
       {
          double ref_ce = ref_sm->getNominalPosError();
          double cmp_ce = cmp_sm->getNominalPosError();
          total_error = ref_ce + cmp_ce; // meters -- being conservative here and not doing rss
          double searchSizePixels = 2.0 * total_error / nominalGsd;
          m_nominalCmpPatchSize = refPatchSize + searchSizePixels;
       }
       if (total_error == 0)
       {
          double searchSizePixels = 2.0*DEFAULT_NOMINAL_POSITION_ERROR/nominalGsd;
          m_nominalCmpPatchSize = refPatchSize + searchSizePixels;
       }
    }
 }

◆ OpenCVCorrelation()

bool ATP::ossimCorrelationSource::OpenCVCorrelation	(	std::shared_ptr< AutoTiePoint >	atp,
		const ossimImageData *	refpatch,
		const ossimImageData *	cmppatch
	)

protected

Definition at line 407 of file ossimCorrelationSource.cpp.

References ossim::JsonParam::asFloat(), ossim::JsonParam::asUint(), ATP::convertToIpl32(), ATP::copyIpl32ToOid(), ossimImageDataFactory::create(), CWARN, ossim::JsonConfig::diagnosticLevel(), ossimRefPtr< T >::get(), ossimImageData::getImageRectangle(), ossim::JsonConfig::getParameter(), ossimImageData::getWidth(), ossimImageData::initialize(), ATP::AtpConfig::instance(), ossimImageDataFactory::instance(), OSSIM_UINT8, ossim::JsonConfig::paramExists(), ossimIrect::ul(), ossimImageData::write(), ossimIpt::x, and ossimIpt::y.

Referenced by correlate().

 {
    static const char* MODULE = "ossimCorrelationSource::OpenCVCorrelation() -- ";
 
    int ref_patch_size = refpatch->getWidth();
    int refPatchOffset = ref_patch_size / 2; // assumes square patch
 
    IplImage *cmpimage, *refimage, *result;
    int method;
 
    // Convert image data to CV IPL form:
    cmpimage = convertToIpl32(cmppatch);
    refimage = convertToIpl32(refpatch);
    if (!cmpimage || !refimage)
    {
       CWARN << MODULE << "Error encountered creating IPL image tiles. Aborting..." << endl;
       return false;
    }
 
    // Assign the peak threshold depending on whether it is same collect or diff collect:
    AtpConfig& config = AtpConfig::instance();
    double peak_threshold = config.getParameter("peakThreshold").asFloat();
 
    CvSize resdim;
    resdim.height = cmpimage->height - refimage->height + 1;
    resdim.width = cmpimage->width - refimage->width + 1;
    result = cvCreateImage(resdim, IPL_DEPTH_32F, 1);
    if (!result)
    {
       CWARN << MODULE << "Error encountered creating IPL image tile (result). Aborting..." << endl;
       return false;
    }
 
    // Do the actual correlation:
    unsigned int corrMethod = config.getParameter("correlationMethod").asUint();
    cvMatchTemplate(cmpimage, refimage, result, (int) corrMethod);
 
    if (config.diagnosticLevel(5) )
    {
       //refpatch->write("ref.ras");
       //cmppatch->write("cmp.ras");
       ossimRefPtr<ossimImageData> resultPatch =
               ossimImageDataFactory::instance()->create(this, OSSIM_UINT8, 1, resdim.width, resdim.height);
       resultPatch->initialize();
       copyIpl32ToOid(result, resultPatch.get());
       resultPatch->write("CORR.RAS");
    }
    ossimIpt cmpPeakLocV;
    float corrCoef;
 
    // Search through all the peaks and the tiepoint object will track which is best.
    multimap<float /* corr_coef */, ossimIpt /* loc */, greater<float> > peaks_map;
    ossimIpt cmpPatchLocV (cmppatch->getImageRectangle().ul());
    for (int dy = 0; dy < result->height; dy++)
    {
       for (int dx = 0; dx < result->width; dx++)
       {
          // Fetch the pixel's corr coef and insert in map to order by strongest peak:
          corrCoef = ((float*) (result->imageData + result->widthStep * dy))[dx];
          if (corrCoef >= peak_threshold)
          {
             cmpPeakLocV.x = cmpPatchLocV.x + refPatchOffset + dx;
             cmpPeakLocV.y = cmpPatchLocV.y + refPatchOffset + dy;
             peaks_map.insert(pair<float, ossimIpt>(corrCoef, cmpPeakLocV));
          }
       }
    }
 
    if (peaks_map.size() > 0)
    {
       // The peaks are in order by greatest correlation value. Send the best to the CTP:
       multimap<float, ossimIpt, greater<float> >::iterator peak = peaks_map.begin();
       unsigned int maxNumPeaks = AtpConfig::instance().getParameter("maxNumMatchesPerFeature").asUint();
       if (config.paramExists("maxNumPeaksPerFeature")) // support legacy keywords
          maxNumPeaks = config.getParameter("maxNumPeaksPerFeature").asUint();
       for (unsigned int i = 0; (i < maxNumPeaks) && (peak != peaks_map.end()); i++)
       {
          cmpPeakLocV = peak->second;
          corrCoef = peak->first;
          atp->addViewMatch(cmpPeakLocV, corrCoef);
          peak++;
       }
    }
 
    cvReleaseImage(&result);
    cvReleaseImage(&refimage);
    cvReleaseImage(&cmpimage);
 
    return true;
 }

Member Data Documentation

◆ m_nominalCmpPatchSize

unsigned int ATP::ossimCorrelationSource::m_nominalCmpPatchSize

protected

Definition at line 47 of file ossimCorrelationSource.h.

Referenced by correlate(), and initialize().

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

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ossimCorrelationSource() [1/3]

◆ ossimCorrelationSource() [2/3]

◆ ossimCorrelationSource() [3/3]

◆ ~ossimCorrelationSource()

Member Function Documentation

◆ correlate()

◆ findFeatures()

◆ getNominalCmpPatchSize()

◆ getTile()

◆ initialize()

◆ OpenCVCorrelation()

Member Data Documentation

◆ m_nominalCmpPatchSize