NAME

get_putative_matches_3 - Extracts putatively matched keypoints using the location threshold.

SYNOPSIS

#include "kpt/putative_match.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int get_putative_matches_3
(
	const Keypoint_vector *target_kvp,
	const Keypoint_vector *candidate_kvp,
	const double strength_threshold,
	const double location_threshold,
	int *num_putative_matches,
	Int_matrix **match_idx_impp
);

DESCRIPTION

This routine looks for a nearest neighbor for each keypoint of target_kvp first based on the location_threshold, which limits how far away in space kpts can be. It then uses the strength_threshold to compare the feature vectors. If the redundance_threshold is not = 0, then the routine removes the redundant keypoint matches.

RETURNS

an error code.

INPUT

const Keypoint_vector *target_kvp - target keypoints for which to find matches const Keypoint_vector *candidate_kvp - candidate keypoints const double strength_threshold - the distance ratio for the NN keypoint descriptor match const double location_threshold - the radius within which to look for matches int *num_putative_matches - the total count of matches. can be NULL, if not needed. Int_matrix **match_idx_impp - a 2-column matrix to store the indices of the matches; can be set to NULL if not interested in the values. The number of rows is equal to the number of keypoints in the target_kvp. Unmatched keypoints are marked as NOT_SET.

RELATED

get_keypoint_match, remove_redundant_matches

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER

Kobus Barnard

SEE ALSO

get_putative_matches , get_putative_matches_2 , extract_match_positions , extract_match_positions_1 , extract_match_positions_2 , get_constrained_keypoint_match , print_keypoint_parameters