From fe7b48aa8f0cbbef4a969511f51f74b5474102a1 Mon Sep 17 00:00:00 2001 From: Vadim Pisarevsky Date: Tue, 12 Aug 2014 00:29:56 +0400 Subject: [PATCH] removed the stuff that's now in xfeatures2d; temporarily added dummy definition of SIFT to make doc builder pass (will remove it later) --- ...on_interfaces_of_descriptor_extractors.rst | 2 +- .../doc/feature_detection_and_description.rst | 78 +++---------------- modules/features2d/doc/features2d.rst | 1 - 3 files changed, 10 insertions(+), 71 deletions(-) diff --git a/modules/features2d/doc/common_interfaces_of_descriptor_extractors.rst b/modules/features2d/doc/common_interfaces_of_descriptor_extractors.rst index e910addcf..746953da2 100644 --- a/modules/features2d/doc/common_interfaces_of_descriptor_extractors.rst +++ b/modules/features2d/doc/common_interfaces_of_descriptor_extractors.rst @@ -86,4 +86,4 @@ The current implementation supports the following types of a descriptor extracto * ``"BRISK"`` -- :ocv:class:`BRISK` * ``"ORB"`` -- :ocv:class:`ORB` - + \ No newline at end of file diff --git a/modules/features2d/doc/feature_detection_and_description.rst b/modules/features2d/doc/feature_detection_and_description.rst index 4aa7dd349..bfb93d157 100644 --- a/modules/features2d/doc/feature_detection_and_description.rst +++ b/modules/features2d/doc/feature_detection_and_description.rst @@ -36,38 +36,6 @@ Detects corners using the FAST algorithm by [Rosten06]_. .. [Rosten06] E. Rosten. Machine Learning for High-speed Corner Detection, 2006. - -BriefDescriptorExtractor ------------------------- -.. ocv:class:: BriefDescriptorExtractor : public DescriptorExtractor - -Class for computing BRIEF descriptors described in a paper of Calonder M., Lepetit V., -Strecha C., Fua P. *BRIEF: Binary Robust Independent Elementary Features* , -11th European Conference on Computer Vision (ECCV), Heraklion, Crete. LNCS Springer, September 2010. :: - - class BriefDescriptorExtractor : public DescriptorExtractor - { - public: - static const int PATCH_SIZE = 48; - static const int KERNEL_SIZE = 9; - - // bytes is a length of descriptor in bytes. It can be equal 16, 32 or 64 bytes. - BriefDescriptorExtractor( int bytes = 32 ); - - virtual void read( const FileNode& ); - virtual void write( FileStorage& ) const; - virtual int descriptorSize() const; - virtual int descriptorType() const; - virtual int defaultNorm() const; - protected: - ... - }; - -.. note:: - - * A complete BRIEF extractor sample can be found at opencv_source_code/samples/cpp/brief_match_test.cpp - - MSER ---- .. ocv:class:: MSER : public FeatureDetector @@ -213,43 +181,6 @@ Finds keypoints in an image and computes their descriptors :param useProvidedKeypoints: If it is true, then the method will use the provided vector of keypoints instead of detecting them. -FREAK ------ -.. ocv:class:: FREAK : public DescriptorExtractor - -Class implementing the FREAK (*Fast Retina Keypoint*) keypoint descriptor, described in [AOV12]_. The algorithm propose a novel keypoint descriptor inspired by the human visual system and more precisely the retina, coined Fast Retina Key- point (FREAK). A cascade of binary strings is computed by efficiently comparing image intensities over a retinal sampling pattern. FREAKs are in general faster to compute with lower memory load and also more robust than SIFT, SURF or BRISK. They are competitive alternatives to existing keypoints in particular for embedded applications. - -.. [AOV12] A. Alahi, R. Ortiz, and P. Vandergheynst. FREAK: Fast Retina Keypoint. In IEEE Conference on Computer Vision and Pattern Recognition, 2012. CVPR 2012 Open Source Award Winner. - -.. note:: - - * An example on how to use the FREAK descriptor can be found at opencv_source_code/samples/cpp/freak_demo.cpp - -FREAK::FREAK ------------- -The FREAK constructor - -.. ocv:function:: FREAK::FREAK( bool orientationNormalized=true, bool scaleNormalized=true, float patternScale=22.0f, int nOctaves=4, const vector& selectedPairs=vector() ) - - :param orientationNormalized: Enable orientation normalization. - :param scaleNormalized: Enable scale normalization. - :param patternScale: Scaling of the description pattern. - :param nOctaves: Number of octaves covered by the detected keypoints. - :param selectedPairs: (Optional) user defined selected pairs indexes, - -FREAK::selectPairs ------------------- -Select the 512 best description pair indexes from an input (grayscale) image set. FREAK is available with a set of pairs learned off-line. Researchers can run a training process to learn their own set of pair. For more details read section 4.2 in: A. Alahi, R. Ortiz, and P. Vandergheynst. FREAK: Fast Retina Keypoint. In IEEE Conference on Computer Vision and Pattern Recognition, 2012. - -We notice that for keypoint matching applications, image content has little effect on the selected pairs unless very specific what does matter is the detector type (blobs, corners,...) and the options used (scale/rotation invariance,...). Reduce corrThresh if not enough pairs are selected (43 points --> 903 possible pairs) - -.. ocv:function:: vector FREAK::selectPairs(const vector& images, vector >& keypoints, const double corrThresh = 0.7, bool verbose = true) - - :param images: Grayscale image input set. - :param keypoints: Set of detected keypoints - :param corrThresh: Correlation threshold. - :param verbose: Prints pair selection informations. - KAZE ---- .. ocv:class:: KAZE : public Feature2D @@ -312,3 +243,12 @@ The AKAZE constructor :param octaves: Maximum octave evolution of the image :param sublevels: Default number of sublevels per scale level :param diffusivity: Diffusivity type. DIFF_PM_G1, DIFF_PM_G2, DIFF_WEICKERT or DIFF_CHARBONNIER + +SIFT +---- + +.. ocv:class:: SIFT : public Feature2D + +The SIFT algorithm has been moved to opencv_contrib/xfeatures2d module. + + diff --git a/modules/features2d/doc/features2d.rst b/modules/features2d/doc/features2d.rst index 781f1ddea..2f1b39faf 100644 --- a/modules/features2d/doc/features2d.rst +++ b/modules/features2d/doc/features2d.rst @@ -11,6 +11,5 @@ features2d. 2D Features Framework common_interfaces_of_feature_detectors common_interfaces_of_descriptor_extractors common_interfaces_of_descriptor_matchers - common_interfaces_of_generic_descriptor_matchers drawing_function_of_keypoints_and_matches object_categorization