For each query descriptor, finds the training descriptors not farther than the specified distance

matches = matcher.radiusMatch(queryDescriptors, trainDescriptors, maxDistance)
matches = matcher.radiusMatch(queryDescriptors, maxDistance)
[...] = matcher.radiusMatch(..., 'OptionName', optionValue, ...)

Input

• queryDescriptors Query set of descriptors.
• trainDescriptors Train set of descriptors. This set is not added to the train descriptors collection stored in the class object.
• maxDistance Threshold for the distance between matched descriptors. Distance here means metric distance (e.g. Hamming distance), not the distance between coordinates (which is measured in Pixels)!

Output

• matches Found matches. A cell array of length size(queryDescriptors,1), each cell is a structure array that has the following fields:
  • queryIdx query descriptor index (zero-based index)
  • trainIdx train descriptor index (zero-based index)
  • imgIdx train image index (zero-based index)
  • distance distance between descriptors (scalar)

Options

• Mask default empty
  • In the first form, mask specifying permissible matches between an input query and train matrices of descriptors. Matrix of size [size(queryDescriptors,1),size(trainDescriptors,1)].
  • In the second form, set of masks. Each masks{i} specifies permissible matches between the input query descriptors and stored train descriptors from the i-th image trainDescCollection{i}. Cell array of length length(trainDescriptors), each a matrix of size [size(queryDescriptors,1),size(trainDescriptors{i},1)].
• CompactResult Parameter used when the mask (or masks) is not empty. If CompactResult is false, the matches vector has the same size as queryDescriptors rows. If CompactResult is true, the matches vector does not contain matches for fully masked-out query descriptors. default false

For each query descriptor, the methods find such training descriptors that the distance between the query descriptor and the training descriptor is equal or smaller than maxDistance. Found matches are returned in the distance increasing order.