README.md

BGSLibrary

A Background Subtraction Library

Last page update: 04/03/2023

Library Version: 3.3.0 (see Build Status and Release Notes for more info)

The BGSLibrary was developed in early 2012 by Andrews Sobral as a C++ framework (with wrappers available for Python, Java and MATLAB) for foreground-background separation in videos using OpenCV. The bgslibrary is compatible with OpenCV versions 2.4.x, 3.x and 4.x, and can be compiled on Windows, Linux, and Mac OS X. It currently contains 43 algorithms and is available free of charge to all users, both academic and commercial. The library's source code is available under the MIT license.

• List of available algorithms

• Algorithms benchmark

• Which algorithms really matter?

• Library architecture

• Installation instructions

You can either install BGSLibrary via pre-built binary package or build it from source

• • Windows installation
• • Ubuntu / OS X installation

Supported Compilers are:

GCC 4.8 and above
Clang 3.4 and above
MSVC 2015, 2017, 2019 or newer

Other compilers might work, but are not officially supported. The bgslibrary requires some features from the ISO C++ 2014 standard.

• Graphical User Interface

• • C++ QT (Official)
• • C++ MFC (Deprecated)
• • Java (Obsolete)

• Wrappers

• • Python
• • MATLAB
• • Java

• Examples

• • https://github.com/andrewssobral/bgslibrary/tree/master/examples
• • https://github.com/andrewssobral/bgslibrary-examples

• Docker images

• How to integrate BGSLibrary in your own CPP code

• How to contribute

• List of collaborators

• Release notes

Algorithm compatibility across OpenCV versions

---

Algorithm	OpenCV < 3.0 (42)	3.0 <= OpenCV <= 3.4.7 (41)	3.4.7 < OpenCV < 4.0 (39)	OpenCV >= 4.0 (26)
AdaptiveBackgroundLearning	✔️	✔️	✔️	✔️
AdaptiveSelectiveBackgroundLearning	✔️	✔️	✔️	✔️
CodeBook	✔️	✔️	✔️	✔️
DPAdaptiveMedian	✔️	✔️	✔️	❌
DPEigenbackground	✔️	✔️	✔️	❌
DPGrimsonGMM	✔️	✔️	✔️	❌
DPMean	✔️	✔️	✔️	❌
DPPratiMediod	✔️	✔️	✔️	❌
DPTexture	✔️	✔️	✔️	❌
DPWrenGA	✔️	✔️	✔️	❌
DPZivkovicAGMM	✔️	✔️	✔️	❌
FrameDifference	✔️	✔️	✔️	✔️
FuzzyChoquetIntegral	✔️	✔️	✔️	✔️
FuzzySugenoIntegral	✔️	✔️	✔️	✔️
GMG	✔️	❌	❌	❌
IndependentMultimodal	✔️	✔️	✔️	✔️
KDE	✔️	✔️	✔️	✔️
KNN	❌	✔️	✔️	✔️
LBAdaptiveSOM	✔️	✔️	✔️	✔️
LBFuzzyAdaptiveSOM	✔️	✔️	✔️	✔️
LBFuzzyGaussian	✔️	✔️	✔️	✔️
LBMixtureOfGaussians	✔️	✔️	✔️	✔️
LBP_MRF	✔️	✔️	❌	❌
LBSimpleGaussian	✔️	✔️	✔️	✔️
LOBSTER	✔️	✔️	✔️	✔️
MixtureOfGaussianV1	✔️	❌	❌	❌
MixtureOfGaussianV2	✔️	✔️	✔️	✔️
MultiCue	✔️	✔️	✔️	❌
MultiLayer	✔️	✔️	❌	❌
PAWCS	✔️	✔️	✔️	✔️
PixelBasedAdaptiveSegmenter	✔️	✔️	✔️	✔️
SigmaDelta	✔️	✔️	✔️	✔️
StaticFrameDifference	✔️	✔️	✔️	✔️
SuBSENSE	✔️	✔️	✔️	✔️
T2FGMM_UM	✔️	✔️	✔️	❌
T2FGMM_UV	✔️	✔️	✔️	❌
T2FMRF_UM	✔️	✔️	✔️	❌
T2FMRF_UV	✔️	✔️	✔️	❌
TwoPoints	✔️	✔️	✔️	✔️
ViBe	✔️	✔️	✔️	✔️
VuMeter	✔️	✔️	✔️	✔️
WeightedMovingMean	✔️	✔️	✔️	✔️
WeightedMovingVariance	✔️	✔️	✔️	✔️

Stargazers over time

Citation