Package org.opencv.features2d
Class BOWImgDescriptorExtractor
java.lang.Object
org.opencv.features2d.BOWImgDescriptorExtractor
Class to compute an image descriptor using the *bag of visual words*.
Such a computation consists of the following steps:
1. Compute descriptors for a given image and its keypoints set.
2. Find the nearest visual words from the vocabulary for each keypoint descriptor.
3. Compute the bag-of-words image descriptor as is a normalized histogram of vocabulary words
encountered in the image. The i-th bin of the histogram is a frequency of i-th word of the
vocabulary in the given image.
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic BOWImgDescriptorExtractor__fromPtr__(long addr) voidcompute(Mat image, MatOfKeyPoint keypoints, Mat imgDescriptor) intReturns an image descriptor size if the vocabulary is set.intReturns an image descriptor type.protected voidfinalize()longReturns the set vocabulary.voidsetVocabulary(Mat vocabulary) Sets a visual vocabulary.
-
Field Details
-
nativeObj
protected final long nativeObj
-
-
Constructor Details
-
BOWImgDescriptorExtractor
protected BOWImgDescriptorExtractor(long addr)
-
-
Method Details
-
getNativeObjAddr
public long getNativeObjAddr() -
__fromPtr__
-
setVocabulary
Sets a visual vocabulary.- Parameters:
vocabulary- Vocabulary (can be trained using the inheritor of BOWTrainer ). Each row of the vocabulary is a visual word (cluster center).
-
getVocabulary
Returns the set vocabulary.- Returns:
- automatically generated
-
compute
- Parameters:
image- automatically generatedkeypoints- automatically generatedimgDescriptor- Computed output image descriptor. pointIdxsOfClusters[i] are keypoint indices that belong to the i -th cluster (word of vocabulary) returned if it is non-zero.
-
descriptorSize
public int descriptorSize()Returns an image descriptor size if the vocabulary is set. Otherwise, it returns 0.- Returns:
- automatically generated
-
descriptorType
public int descriptorType()Returns an image descriptor type.- Returns:
- automatically generated
-
finalize
-