Class cv::detail::AffineBestOf2NearestMatcher#

Features matcher similar to cv::detail::BestOf2NearestMatcher which finds two best matches for each feature and leaves the best one only if the ratio between descriptor distances is greater than the threshold match_conf. View details

#include <opencv2/stitching/detail/matchers.hpp>

Collaboration diagram for cv::detail::AffineBestOf2NearestMatcher:

cv::detail::AffineBestOf2NearestMatcher Node1 cv::detail::AffineBestOf2 NearestMatcher   + AffineBestOf2NearestMatcher() # match() Node2 cv::detail::BestOf2Nearest Matcher   + BestOf2NearestMatcher() + collectGarbage() + create() # match() Node2->Node1 Node3 cv::detail::FeaturesMatcher   + ~FeaturesMatcher() + collectGarbage() + isThreadSafe() + operator()() + operator()() # FeaturesMatcher() # match() # match() Node3->Node2 Node4 bool     Node4->Node1 #full_affine_ Node4->Node3 #is_thread_safe_ Node5 int     Node5->Node2 #num_matches_thresh1 _ #num_matches_thresh2_ Node6 double     Node6->Node2 #matches_confidence _thresh_ Node7 Ptr< cv::detail::Features Matcher >     Node7->Node2 #impl_

cv::detail::AffineBestOf2NearestMatcher Node1 cv::detail::AffineBestOf2 NearestMatcher   + AffineBestOf2NearestMatcher() # match() Node2 cv::detail::BestOf2Nearest Matcher   + BestOf2NearestMatcher() + collectGarbage() + create() # match() Node2->Node1 Node3 cv::detail::FeaturesMatcher   + ~FeaturesMatcher() + collectGarbage() + isThreadSafe() + operator()() + operator()() # FeaturesMatcher() # match() # match() Node3->Node2 Node4 bool     Node4->Node1 #full_affine_ Node4->Node3 #is_thread_safe_ Node5 int     Node5->Node2 #num_matches_thresh1 _ #num_matches_thresh2_ Node6 double     Node6->Node2 #matches_confidence _thresh_ Node7 Ptr< cv::detail::Features Matcher >     Node7->Node2 #impl_

Public Member Functions#

Public Member Functions inherited from cv::detail::BestOf2NearestMatcher

Return

Name

Description

BestOf2NearestMatcher(
    bool try_use_gpu = false,
    float match_conf = 0.3f,
    int num_matches_thresh1 = 6,
    int num_matches_thresh2 = 6,
    double matches_confidence_thresh = 3. )

Constructs a “best of 2 nearest” matcher.

void

collectGarbage()

Frees unused memory allocated before if there is any.
Public Member Functions inherited from cv::detail::FeaturesMatcher

Return

Name

Description

~FeaturesMatcher()

void

collectGarbage()

Frees unused memory allocated before if there is any.

bool

isThreadSafe()

void

operator()(
    const ImageFeatures & features1,
    const ImageFeatures & features2,
    MatchesInfo & matches_info )

void

operator()(
    const std::vector< ImageFeatures > & features,
    std::vector< MatchesInfo > & pairwise_matches,
    const cv::UMat & mask = cv::UMat() )

Performs images matching.

Static Public Member Functions#

Static Public Member Functions inherited from cv::detail::BestOf2NearestMatcher

Return

Name

Description

static Ptr< BestOf2NearestMatcher >

create(
    bool try_use_gpu = false,
    float match_conf = 0.3f,
    int num_matches_thresh1 = 6,
    int num_matches_thresh2 = 6,
    double matches_confidence_thresh = 3. )

Additional Inherited Members#

Protected Member Functions inherited from cv::detail::BestOf2NearestMatcher

Return

Name

Description

void

match(
    const ImageFeatures & features1,
    const ImageFeatures & features2,
    MatchesInfo & matches_info )

This method must implement matching logic in order to make the wrappers detail::FeaturesMatcher::operator()_ work.
Protected Member Functions inherited from cv::detail::FeaturesMatcher

Return

Name

Description

FeaturesMatcher(bool is_thread_safe = false)

void

match(
    const ImageFeatures & features1,
    const ImageFeatures & features2,
    MatchesInfo & matches_info )

This method must implement matching logic in order to make the wrappers detail::FeaturesMatcher::operator()_ work.

void

match(
    const std::vector< ImageFeatures > & features,
    std::vector< MatchesInfo > & pairwise_matches,
    const cv::UMat & mask = cv::UMat() )

This method implements logic to match features between arbitrary number of features. By default this checks every pair of inputs in the input, but the behaviour can be changed by subclasses.
Protected Attributes inherited from cv::detail::BestOf2NearestMatcher

Return

Name

Description

Ptr< FeaturesMatcher >

impl_

double

matches_confidence_thresh_

int

num_matches_thresh1_

int

num_matches_thresh2_

Protected Attributes inherited from cv::detail::FeaturesMatcher

Return

Name

Description

bool

is_thread_safe_

Detailed Description#

Features matcher similar to cv::detail::BestOf2NearestMatcher which finds two best matches for each feature and leaves the best one only if the ratio between descriptor distances is greater than the threshold match_conf.

Unlike cv::detail::BestOf2NearestMatcher this matcher uses affine transformation (affine transformation estimate will be placed in matches_info).

See also

cv::detail::FeaturesMatcher cv::detail::BestOf2NearestMatcher

Examples
samples/cpp/stitching_detailed.cpp.

Constructor & Destructor Documentation#

AffineBestOf2NearestMatcher()#

cv::detail::AffineBestOf2NearestMatcher::AffineBestOf2NearestMatcher(
bool full_affine = false,
bool try_use_gpu = false,
float match_conf = 0.3f,
int num_matches_thresh1 = 6 )

Python:

cv.detail.AffineBestOf2NearestMatcher([, full_affine[, try_use_gpu[, match_conf[, num_matches_thresh1]]]]) -> <detail_AffineBestOf2NearestMatcher object>

Constructs a “best of 2 nearest” matcher that expects affine transformation between images.

See also

cv::estimateAffine2D cv::estimateAffinePartial2D

Parameters

  • full_affine — whether to use full affine transformation with 6 degress of freedom or reduced transformation with 4 degrees of freedom using only rotation, translation and uniform scaling

  • try_use_gpu — Should try to use GPU or not

  • match_conf — Match distances ration threshold

  • num_matches_thresh1 — Minimum number of matches required for the 2D affine transform estimation used in the inliers classification step

Member Function Documentation#

match()#

void cv::detail::AffineBestOf2NearestMatcher::match(
const ImageFeatures & features1,
const ImageFeatures & features2,
MatchesInfo & matches_info )

This method must implement matching logic in order to make the wrappers detail::FeaturesMatcher::operator()_ work.

Parameters

  • features1 — first image features

  • features2 — second image features

  • matches_info — found matches

Member Data Documentation#

full_affine_#

bool cv::detail::AffineBestOf2NearestMatcher::full_affine_

Source file#

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