• Stars
    star
    352
  • Rank 118,139 (Top 3 %)
  • Language
    C++
  • Created over 7 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

An extensive evaluation and comparison of 28 state-of-the-art superpixel algorithms on 5 datasets.

Superpixels: An Evaluation of the State-of-the-Art

Build Status

This repository contains the source code used for evaluation in [1], a large-scale comparison of state-of-the-art superpixel algorithms.

ArXiv | Project Page | Datasets | Doxygen Documentation

This repository subsumes earlier work on comparing superpixel algorithms: davidstutz/gcpr2015-superpixels, davidstutz/superpixels-revisited.

Please cite the following work if you use this benchmark or the provided tools or implementations:

[1] D. Stutz, A. Hermans, B. Leibe.
    Superpixels: An Evaluation of the State-of-the-Art.
    Computer Vision and Image Understanding, 2018.

Also make also sure to cite additional papers when using datasets or superpixel algorithms.

Updates:

  • An implementation of the average metrics, i.e. Average Boundary Recall (called Average Miss Rate in the updated paper), Average Undersegmentation Error and Average Explained Variation (called Average Unexplained Variation in the updated paper) is provided in lib_eval/evaluation.h and an easy-to-use command line tool is provided, see eval_average_cli and the corresponding documentation and examples in Executables and Examples respectively.
  • As of Mar 29, 2017 the paper was accepted for publication at CVIU.
  • The converted (i.e. pre-processed) NYUV2, SBD and SUNRGBD datasets are now available in the data repository.
  • The source code of MSS has been added.
  • The source code of PF and SEAW has been added.
  • Doxygen documentation is now available here.
  • The presented paper was in preparation for a longer period of time โ€” some recent superpixel algorithms are not included in the comparison. These include SCSP and LRW.

Table of Contents

Introduction

Superpixels group pixels similar in color and other low-level properties. In this respect, superpixels address two problems inherent to the processing of digital images: firstly, pixels are merely a result of discretization; and secondly, the high number of pixels in large images prevents many algorithms from being computationally feasible. Superpixels were introduced as more natural entities - grouping pixels which perceptually belong together while heavily reducing the number of primitives.

This repository can be understood as supplementary material for an extensive evaluation of 28 algorithms on 5 datasets regarding visual quality, performance, runtime, implementation details and robustness - as presented in [1]. To ensure a fair comparison, parameters have been optimized on separate training sets; as the number of generated superpixels heavily influences parameter optimization, we additionally enforced connectivity. Furthermore, to evaluate superpixel algorithms independent of the number of superpixels, we propose to integrate over commonly used metrics such as Boundary Recall, Undersegmentation Error and Explained Variation. Finally, we present a ranking of the superpixel algorithms considering multiple metrics and independent of the number of generated superpixels, as shown below.

Algorithm ranking.

The table shows the average ranks across the 5 datasets, taking into account Average Boundary Recall (ARec) and Average Undersegmentation Error (AUE) - lower is better in both cases, see Benchmark. The confusion matrix shows the rank distribution of the algorithms across the datasets.

Algorithms

The following algorithms were evaluated in [1], and most of them are included in this repository:

Included Algorithm Reference
โ˜‘๏ธ CCS Ref. & Web
Instructions CIS Ref. & Web
โ˜‘๏ธ CRS Ref. & Web
โ˜‘๏ธ CW Ref. & Web
โ˜‘๏ธ DASP Ref. & Web
โ˜‘๏ธ EAMS Ref., Ref., Ref. & Web
โ˜‘๏ธ ERS Ref. & Web
โ˜‘๏ธ FH Ref. & Web
โ˜‘๏ธ MSS Ref.
โ˜‘๏ธ PB Ref. & Web
โ˜‘๏ธ preSLIC Ref. & Web
โ˜‘๏ธ reSEEDS Web
โ˜‘๏ธ SEAW Ref. & Web
โ˜‘๏ธ SEEDS Ref. & Web
โ˜‘๏ธ SLIC Ref. & Web
โ˜‘๏ธ TP Ref. & Web
โ˜‘๏ธ TPS Ref. & Web
โ˜‘๏ธ vlSLIC Web
โ˜‘๏ธ W Web
โ˜‘๏ธ WP Ref. & Web
โ˜‘๏ธ PF Ref. & Web
โ˜‘๏ธ LSC Ref. & Web
โ˜‘๏ธ RW Ref. & Web
โ˜‘๏ธ QS Ref. & Web
โ˜‘๏ธ NC Ref. & Web
โ˜‘๏ธ VCCS Ref. & Web
โ˜‘๏ธ POISE Ref. & Web
โ˜‘๏ธ VC Ref. & Web
โ˜‘๏ธ ETPS Ref. & Web
โ˜‘๏ธ ERGC Ref., Ref. & Web

Submission

To keep the benchmark alive, we encourage authors to make their implementations publicly available and integrate them into this benchmark. We are happy to help with the integration and update the results published in [1] and on the project page. Also see the Documentation for details.

License

Licenses for source code corresponding to:

D. Stutz, A. Hermans, B. Leibe. Superpixels: An Evaluation of the State-of-the-Art. Computer Vision and Image Understanding, 2018.

Note that the source code/data is based on other projects for which separate licenses apply, see:

Copyright (c) 2016-2018 David Stutz, RWTH Aachen University

Please read carefully the following terms and conditions and any accompanying documentation before you download and/or use this software and associated documentation files (the "Software").

The authors hereby grant you a non-exclusive, non-transferable, free of charge right to copy, modify, merge, publish, distribute, and sublicense the Software for the sole purpose of performing non-commercial scientific research, non-commercial education, or non-commercial artistic projects.

Any other use, in particular any use for commercial purposes, is prohibited. This includes, without limitation, incorporation in a commercial product, use in a commercial service, or production of other artefacts for commercial purposes.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

You understand and agree that the authors are under no obligation to provide either maintenance services, update services, notices of latent defects, or corrections of defects with regard to the Software. The authors nevertheless reserve the right to update, modify, or discontinue the Software at any time.

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. You agree to cite the corresponding papers (see above) in documents and papers that report on research using the Software.

More Repositories

1

bootstrap-multiselect

JQuery multiselect plugin based on Twitter Bootstrap.
HTML
3,661
star
2

latex-resources

Collection of LaTeX resources and examples.
TeX
475
star
3

mesh-voxelization

C++ implementation for computing occupancy grids and signed distance functions (SDFs) from watertight meshes.
C++
298
star
4

superpixels-revisited

Library containing 7 state-of-the-art superpixel algorithms with a total of 9 implementations used for evaluation purposes in [1] utilizing an extended version of the Berkeley Segmentation Benchmark.
C++
252
star
5

mesh-fusion

Python tool for obtaining watertight meshes using TSDF fusion.
C++
150
star
6

bootstrap-strength-meter

Password strength meter based on Twitter Bootstrap and Password Score.
HTML
83
star
7

caffe-tools

Some tools and examples for pyCaffe including LMDB I/O, custom Python layers and monitoring training error and loss.
Python
77
star
8

matlab-mnist-two-layer-perceptron

A two layer perceptron implemented in MatLab to recognize handwritten digits based on the MNIST dataset.
MATLAB
59
star
9

cvpr2018-shape-completion

CVPR 2018 paper "Learning 3D Shape Completion from Laser Scan Data with Weak Supervision".
TeX
59
star
10

password-score

Password scoring library written in Javascript.
JavaScript
56
star
11

pytorch-adversarial-examples-training-articles

PyTorch code corresponding to my blog series on adversarial examples and (confidence-calibrated) adversarial training.
Python
56
star
12

tensorflow-cpp-op-example

Simple example of implementing a new Tensorflow operation and its gradient in C++.
Python
55
star
13

bpy-visualization-utils

Blender/bpy utilities for paper-ready visualizations of meshes, point clouds and occupancy grids.
Python
55
star
14

seeds-revised

Implementation of the superpixel algorithm called SEEDS [1].
C++
52
star
15

mesh-evaluation

Efficient C++ implementation of mesh-to-mesh and mesh-to-point distance.
C++
43
star
16

disentangling-robustness-generalization

CVPR'19 experiments with (on-manifold) adversarial examples.
Python
40
star
17

graph-based-image-segmentation

Implementation of efficient graph-based image segmentation as proposed by Felzenswalb and Huttenlocher [1] that can be used to generate oversegmentations.
C++
40
star
18

extended-berkeley-segmentation-benchmark

Extended version of the Berkeley Segmentation Benchmark [1] used for evaluation in [2].
C++
39
star
19

confidence-calibrated-adversarial-training

Implementation of Confidence-Calibrated Adversarial Training (CCAT).
Python
38
star
20

grosse2009-intrinsic-images

Code from the MIT Intrinsic Images Dataset [1]; Including command line tool for Retinex algorithm.
Python
25
star
21

googlemock-example

An example of using Google Mock inspired by Martin Fowler's "Mocks Aren't Stubs".
C++
25
star
22

hierarchical-graph-based-video-segmentation

Implementation of the hierarchical graph-based video segmentation algorithm proposed by Grundmann et al. [1] based on the image segmentation algorithm by Felzenswalb and Huttenlocher [2].
C++
23
star
23

nyu-depth-v2-tools

Tools used in [2] to pre-process the ground truth segmentations to evaluate superpixel algorithms.
MATLAB
22
star
24

flow-io-opencv

Fork and OpenCV wrapper of the optical flow I/O and visualization code provided as part of the Sintel dataset [1].
C++
20
star
25

daml-shape-completion

CVPR'18 implementation of (deterministic) amortized maximum likelihood (AML) for weakly-supervised shape completion.
C++
20
star
26

sphinx-example

Example and cheat sheet for the Sphinx Python documentation generator.
Python
18
star
27

pointnet-auto-encoder

Torch PointNet auto encoder implementation.
C++
17
star
28

ijcv2018-improved-shape-completion

ArXiv'18 pre-print "Learning 3D Shape Completion under Weak Supervision".
TeX
15
star
29

robust-generalization-flatness

Implementation of average- and worst-case robust flatness measures for adversarial training.
Python
14
star
30

arxiv-submission-sanitizer-flattener

Simple Python scripts to clean up and flatten ArXiv LaTeX submissions.
Python
14
star
31

pytorch-custom-c-cuda-operations

Example of easily implementing custom tensor operations in C and CUDA.
Python
13
star
32

ipiano

Implementation of the iPiano algorithm for non-convex and non-smooth optimization as described in [1].
C++
13
star
33

opencv-2.4-cuda-9-patch

This is a quick patch for compiling OpenCV 2.4.x with CUDA 9.
CMake
13
star
34

cvpr2019-adversarial-robustness

CVPR 2019 paper "Disentangling Adversarial Robustness and Generalization".
TeX
13
star
35

kohana-hooks

Event module for Kohana.
PHP
12
star
36

seminar-convolutional-neural-networks

Seminar paper "Understanding Convolutional Neural Networks".
TeX
12
star
37

probabilistic-pca

Python probabilistic PCA (PPCA) implementation.
Python
11
star
38

bachelor-thesis-superpixels

Bachelor thesis "Superpixel Segmentation using Depth Information", including a thorough comparison of several state-of-the-art superpixel algorithms.
TeX
11
star
39

aml-improved-shape-completion

ArXiv'18 implementation of amortized maximum likelihood (AML) for high-quality, weakly-supervised shape completion.
C++
10
star
40

vlfeat-slic-example

Example of using VLFeat's SLIC implementation from C++.
C++
10
star
41

icml2020-confidence-calibrated-adversarial-training

ICML'20 paper "Confidence-Calibrated Adversarial Training: Generalizing to Unseen Attacks".
TeX
9
star
42

vedaldi2006-siftpp

Fork of SIFT++, a lightweight C++ implementation of the SIFT detector and descriptor.
C++
9
star
43

torch-examples

Collection of Torch examples for deep learning.
Lua
7
star
44

mathematical-image-processing

Implementations and examples of basic mathematical image processing algorithms. Based on the lectures "Mathematical Foundations of Image Processing" and "Variational Methods in Image Processing" by Prof. Berkels.
MATLAB
6
star
45

php-simplex

PHP library implementing the simplex algorithm.
PHP
5
star
46

jasmine-travis-example

Example for continuous integration with Jasmine, GitHub and Travis CI.
JavaScript
5
star
47

php-matrix-decompositions-demonstration

Demonstration of common matrix decompositions in PHP.
PHP
5
star
48

master-thesis-shape-completion

Master thesis "Learning 3D Shape Completion from Bounding Boxes using CAD Shape Priors".
TeX
5
star
49

iccv2021-robust-flatness

ICCV'21 paper "Relating Adversarially Robust Generalization to Flat Minima".
PostScript
5
star
50

banic2012-color-constancy

Fork of the Light Random Spray Retinex Algorithm as discussed in [1].
C++
5
star
51

jquery-pseudocode

Lightweight jQuery plugin to display algorithms similar to LaTeX pseudocode and algorithm packages.
HTML
5
star
52

functional-dependencies

Small demo application for calculating candidate keys of a given relational database schema.
PHP
5
star
53

d3-topological

Topological sort using d3.js.
JavaScript
4
star
54

wordpress-iamdavidstutz

Wordpress theme of my personal webpage.
JavaScript
4
star
55

random-bit-error-robustness

Implementation of robust quantization, weight clipping and random bit error training to improve robustness against bit errors in quantized weights.
Python
4
star
56

superpixel-benchmark-data

Converted datasets for davidstutz/superpixel-benchmark.
4
star
57

php-matrix-decompositions

PHP Library including several common matrix decompositions: LU, QR and Cholesky.
PHP
3
star
58

kohana-red

Kohana authentication module based on Kohana's ORM and Database module.
PHP
3
star
59

cmsimple-pictures

CMSimple plugin for creating different kinds of sliders and galleries.
PHP
3
star
60

gcpr2015-superpixels

GCPR 2015 paper and poster "Superpixel Segmentation: An Evaluation".
TeX
3
star
61

seminar-cnn-image-retrieval

Seminar paper "Neural Codes for Image Retreival".
TeX
3
star
62

kohana-navigation

Navigation generation module for Kohana.
PHP
3
star
63

davidstutz

Personal README.
2
star
64

cmsimple-iamdavidstutz

CMSimple theme of my personal webpage.
CSS
2
star
65

kohana-green

Kohana Access Control List implementation based on Kohana's Red module.
PHP
2
star
66

wordpress-github

Wordpress GitHub plugin.
PHP
2
star
67

cmsimple-news

CMSimple plugin for managing and publishing news.
PHP
2
star
68

matlab-multi-label-connected-components

MEX wrapper for Ali Rahimi's multi-label connected components implementation in C++.
C++
2
star
69

kohana-gaps

Kohana form creation module based on ORM models.
PHP
2
star
70

seminar-neural-networks

Seminar paper "Introduction to Neural Networks".
TeX
2
star
71

project-social-network-analysis-stackexchange

Project of "Social Network Analysis" MOOC by the University of Michigan on analyzing StackExchange sites.
PHP
2
star
72

seminar-ipiano

Seminar paper "iPiano: Inertial Proximal Algorithm for Non-Convex Optimization".
TeX
2
star
73

superpixel-benchmark-nvd3

Interactive plots of results from the superpixel benchmark davidstutz/superpixel-benchmark using NVD3.
JavaScript
2
star
74

nvd3-superpixel-comparison

Interactive compariosn of superpixel algorithms as presented in the bachelor thesis "Superpixel Segmentation using Depth Information" [1].
JavaScript
2
star
75

proseminar-dart

RWTH Aachen University Proseminar 2012 Chair for Data Management and Data Exploration: Dart - A Brief Introduction
TeX
2
star
76

cmsimple-youtube

CMSimple plugin for creating youtube video galleries.
PHP
1
star
77

pytorch-adversarial-robustness-articles

Code corresponding to a series of blog articles on adversarial robustness at davidstutz.de.
1
star
78

kohana-yellow

Yellow is a logging module for the Kohana Green module based on Green and Red.
PHP
1
star
79

pytorch-pgd-adversarial-examples

PyTorch implementation of projected gradient descent (PGD) to generate L_p adversarial examples.
1
star
80

pytorch-tensorboard-monitoring

PyTorch example for using TensorBoard logging in a plug-and-play fashion.
1
star
81

cmsimple-bootstrap

A simple CMSimple theme based on Twitter Bootstrap.
CSS
1
star
82

cmsimple-bbclone

BBClone plugin for CMSimple.
PHP
1
star
83

tensorflow-mnist-experiments

CADL course project: different architectures implemented in TensorFlow and tested on MNIST.
Python
1
star
84

cmsimple-elfinder

CMSimple elFinder filebrowser.
JavaScript
1
star
85

pytorch-loading-models

PyTorch example for loading models without initializing their architectures first.
1
star
86

pytorch-cifar10-autoaugment-cutout

PyTorch Code for getting 2.56% test error on CIFAR-10 using AugoAugment and CutOut.
1
star
87

kohana-media

Simple media/assets module for Kohana.
PHP
1
star
88

jquery-references

Naive jQuery plugin to allow referencing figures, listings, algorithms and references in a BibTex-like style.
HTML
1
star
89

kohana-blue

Blue is a user configuration module based on Kohana's Red module.
PHP
1
star