feature key SURF_v0.1
The feature-key-SURF offers a front-end to the OpenCV SURF algorithm implementation. Given a input image, the software generates a list of keypoints. The list is then exported in a keypoints file.
Grayscale images are expected by the software. If color images are given as input, the OpenCV image reader convert it automatically into grayscale images.
The feature-key-SURF software expects the following arguments and parameters. Starting with the stream arguments and parameters :
--input -i
Path of the input image.
--output -o
Path of the output keypoints file.
OpenCV SURF implementation arguments and parameters :
--extended -t (OpenCV : extended)
--upright -u (OpenCV : upright)
--layer -l (OpenCV : nOctaveLayers)
--octave -a (OpenCV : nOctaves)
--hessian -s (OpenCV : hessianThreshold)
OpenCV SURF parameters. Please see OpenCV documentation for
more information.
Prefiltering arguments and parameters :
--edge-x -x, --edge-y -y
Size, in pixels, of the image edges. Keypoints that are detected
outside of those edges are not exported in the output file.
Taking the following image extracted from a panorama taken using an Eyesis4Pi in Geneva :
and after grayscale conversion, the image is send to the software. The generated keypoints list is overimposed on the grayscale image :
Changing the value of the hessian parameter, the number of generated keypoints can be augmented or reduced :
The two last images are generated using the feature-key-view software.
The software binary can be build using its specific makefile by simply typing in its base directory :
$ make clean && make
The binary is placed in the local bin directory and is not copied in the feature-suite main bin directory. To generate the documentation, use the command :
$ make documentation
When documentation is generated, the previous one is preliminary removed.