# NAME

extract_match_positions_1 - The function extracts the (x,y) coordinates of the VLFeat keypoints
# 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 extract_match_positions_1
(
Matrix **target_pos_mpp,
Matrix **candidate_pos_mpp,
const Keypoint_vector *target_kvp,
const Keypoint_vector *candidate_kvp,
const Int_matrix *mask_imp,
const int num_matches,
Int_matrix **kpt_idx_impp
);

# DESCRIPTION

based on the values stored in the mask_mp. If mask_mp[i] is < 0, then the
value in the keypoint vector at position i will not be stored into the
pos_mpp matrix. In the resulting matrix, the keypoint location of each element
of the target_pos_mp matches the corresponding element's location of the
candidate_pos_mp, i.e. target_pos_mp[0] is matched to candidate_pos_mp[0], etc.
Input parameters:
Matrix** target_pos_mpp - stores the position of the target image keypoints
Matrix** candidate_pos_mpp - stores the position of the candidate matches' keypoints
Keypoint_vector *target_kvp - contains target image keypoints and descriptors
Keypoint_vector *candidate_kvp - contains matched keypoints and descriptors
Int_matrix *mask_imp - a 2-column matrix that stores the indices of the matched
Keypoint_vector elements (first column - target indices,
second column - corresponding candidate indices) that need
to be copied. If the index value == NOT_SET, then the
keypoint is ignored.
int num_matches - the number of elements in the mask_imp matrix whose value is >=0.
If num_matches is set to something that's less than 0, then mask_imp
is used to calculate the value internally.
Int_matrix *kpt_idx_imp - keeps track of the indices to which keypoints in _pos_mp belong.
Very similar to mask_imp, except there are no NOT_SET values.
# RETURNS

an error code.
# 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
,
get_putative_matches_3
,
extract_match_positions
,
extract_match_positions_2
,
get_constrained_keypoint_match
,
print_keypoint_parameters