Awesome
Adaptive Superpixels
Copyright 2012-2014 by David Weikersdorfer
Adaptive Superpixels is a collection of superpixel algorithms for non-constant density functions.
Algorithms:
- Adaptive Superpixels for color images with a user-defined density function
- Depth-Adaptive Superpixels for RGB-D images
- SLIC for color images -- see ivrg.epfl.ch/research/superpixels
Examples
Adaptive Superpixels
(left: color image, middle: user defined density function, right: ASP superpixels)
Depth-Adaptive Superpixels
(left: color image, middle: depth image from Kinect, right: DASP superpixels)
Installation
asp was tested under Ubuntu 14.04.
asp uses C++11 and requires an up to date compiler like GCC 4.8.x.
Requirements
- Build essential:
sudo apt-get install build-essential g++ cmake cmake-qt-gui
- Eigen 3.x:
sudo apt-get install libeigen3-dev
- slimage: Clone from https://github.com/Danvil/slimage (header only - no build required)
- OpenCV:
sudo apt-get install libopencv-dev
libasp itself does not require Qt or OpenCV, however the provided executable uses OpenCV to load and display images.
Installation instructions (Linux)
git clone git://github.com/Danvil/asp.git
cd asp; mkdir build; cd build
cmake-gui ..
- Press 'Configure', select 'Unix Makefiles' and press 'Finish'. Change
CMAKE_BUILD_TYPE
toRelease
! Adapt the other variables accordingly. Press 'Generate' and close the cmake gui. make
Things to try
bin/asp --method SLIC --color ../examples/toy_color.png
bin/asp --method ASP --color ../examples/toy_color.png --density ../examples/density_squares.pgm
bin/asp --method DASP --color ../examples/toy_color.png --depth ../examples/toy_depth.pgm
Scientific publications
David Weikersdorfer, Efficiency by Sparsity: Depth-Adaptive Superpixels and Event-based SLAM (pdf). Technische Universität München, 2014.
David Weikersdorfer, David Gossow, Michael Beetz, Depth-Adaptive Superpixels (pdf). 21-st International Conference on Patter Recognition (ICPR), 2012.
I want to contribute
Contact me on GitHub
License
asp is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
asp is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with asp. If not, see www.gnu.org/licenses.