te::gm::GTFilter Class Reference

2D Geometric transformation tie-points filter (outliers remotion). More...

#include <GTFilter.h>

Inheritance diagram for te::gm::GTFilter:

Classes

class  ApplyRansacThreadEntryThreadParams
 Parameters used by the GTFilter::applyRansacThreadEntry method. More...
 

Public Types

typedef long double RansacFloatCounterT
 RANSAC floating point counter type. More...
 
typedef unsigned long int RansacIntegerCounterT
 RANSAC integer counter type. More...
 

Public Member Functions

bool applyRansac (const std::string &transfName, const GTParameters &inputParams, const double maxDirectMapError, const double maxInverseMapError, const RansacIntegerCounterT &maxIterations, const double &assurance, const bool enableMultiThread, const std::vector< double > &tiePointsWeights, std::vector< te::gm::GTParameters::TiePoint > &outTiePoints, std::auto_ptr< GeometricTransformation > &outTransf)
 Apply a RANSAC based outliers remotion strategy. More...
 
 GTFilter ()
 Default constructor. More...
 
 ~GTFilter ()
 Destructor. More...
 

Static Private Member Functions

static void applyRansacThreadEntry (te::gm::GTFilter::ApplyRansacThreadEntryThreadParams *paramsPtr)
 Surf locator thread entry. More...
 
static double getPt1ConvexHullArea (const std::vector< GTParameters::TiePoint > &tiePoints)
 Returns the tie-points convex hull area (GTParameters::TiePoint::first). More...
 

Detailed Description

2D Geometric transformation tie-points filter (outliers remotion).

Definition at line 52 of file GTFilter.h.

Member Typedef Documentation

RANSAC floating point counter type.

Definition at line 60 of file GTFilter.h.

typedef unsigned long int te::gm::GTFilter::RansacIntegerCounterT

RANSAC integer counter type.

Definition at line 57 of file GTFilter.h.

Constructor & Destructor Documentation

te::gm::GTFilter::GTFilter ( )

Default constructor.

te::gm::GTFilter::~GTFilter ( )

Destructor.

Member Function Documentation

bool te::gm::GTFilter::applyRansac ( const std::string &  transfName,
const GTParameters inputParams,
const double  maxDirectMapError,
const double  maxInverseMapError,
const RansacIntegerCounterT maxIterations,
const double &  assurance,
const bool  enableMultiThread,
const std::vector< double > &  tiePointsWeights,
std::vector< te::gm::GTParameters::TiePoint > &  outTiePoints,
std::auto_ptr< GeometricTransformation > &  outTransf 
)

Apply a RANSAC based outliers remotion strategy.

Parameters
transfNameTransformation name (see te::gm::GTFactory dictionary for reference).
inputParamsInput transformation parameters.
maxDirectMapErrorThe maximum allowed direct mapping error.
maxInverseMapErrorThe maximum allowed inverse mapping error.
maxIterationsThe maximum number of iterations (Use 0-zero to let this number be automatically found).
assuranceThe error-free selection assurance - valid range (0-1) - Use Lower values for good tie-points sets - Higher values may increase the number of iterations.
enableMultiThreadEnable multi-threaded processing (good for multi-processor or multi-core systems).
outTransfThe generated output transformation (with the base mininum required tie-points set).
tiePointsWeightsOptional tie-points weights (only positive values) or an empty vector if no weights must be used.
outTiePointsThe filtered output tie-points (non-outliers) in agreenment with the generated transformation.
Returns
true if OK, false on errors.
Note
Reference: Martin A. Fischler and Robert C. Bolles, Random Sample Consensus: A Paradigm for Model Fitting with Applications to Image Analysis and Automated Cartography, Communications of the ACM archive, Volume 24, Issue 6 (June 1981).
static void te::gm::GTFilter::applyRansacThreadEntry ( te::gm::GTFilter::ApplyRansacThreadEntryThreadParams paramsPtr)
staticprivate

Surf locator thread entry.

Parameters
paramsPtrA pointer to the thread parameters.
static double te::gm::GTFilter::getPt1ConvexHullArea ( const std::vector< GTParameters::TiePoint > &  tiePoints)
staticprivate

Returns the tie-points convex hull area (GTParameters::TiePoint::first).

Parameters
tiePointsTie points.
Returns
The tie-points convex hull area

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