OpenCV  4.1.0
Open Source Computer Vision
Public Member Functions | List of all members
cv::BackgroundSubtractorMOG2 Class Referenceabstract

Gaussian Mixture-based Background/Foreground Segmentation Algorithm. More...

#include <opencv2/video/background_segm.hpp>

Inheritance diagram for cv::BackgroundSubtractorMOG2:
cv::BackgroundSubtractor cv::Algorithm cv::cuda::BackgroundSubtractorMOG2

Public Member Functions

virtual void apply (InputArray image, OutputArray fgmask, double learningRate=-1) CV_OVERRIDE=0
 Computes a foreground mask.
 
virtual double getBackgroundRatio () const =0
 Returns the "background ratio" parameter of the algorithm.
 
virtual double getComplexityReductionThreshold () const =0
 Returns the complexity reduction threshold.
 
virtual bool getDetectShadows () const =0
 Returns the shadow detection flag.
 
virtual int getHistory () const =0
 Returns the number of last frames that affect the background model.
 
virtual int getNMixtures () const =0
 Returns the number of gaussian components in the background model.
 
virtual double getShadowThreshold () const =0
 Returns the shadow threshold.
 
virtual int getShadowValue () const =0
 Returns the shadow value.
 
virtual double getVarInit () const =0
 Returns the initial variance of each gaussian component.
 
virtual double getVarMax () const =0
 
virtual double getVarMin () const =0
 
virtual double getVarThreshold () const =0
 Returns the variance threshold for the pixel-model match.
 
virtual double getVarThresholdGen () const =0
 Returns the variance threshold for the pixel-model match used for new mixture component generation.
 
virtual void setBackgroundRatio (double ratio)=0
 Sets the "background ratio" parameter of the algorithm.
 
virtual void setComplexityReductionThreshold (double ct)=0
 Sets the complexity reduction threshold.
 
virtual void setDetectShadows (bool detectShadows)=0
 Enables or disables shadow detection.
 
virtual void setHistory (int history)=0
 Sets the number of last frames that affect the background model.
 
virtual void setNMixtures (int nmixtures)=0
 Sets the number of gaussian components in the background model.
 
virtual void setShadowThreshold (double threshold)=0
 Sets the shadow threshold.
 
virtual void setShadowValue (int value)=0
 Sets the shadow value.
 
virtual void setVarInit (double varInit)=0
 Sets the initial variance of each gaussian component.
 
virtual void setVarMax (double varMax)=0
 
virtual void setVarMin (double varMin)=0
 
virtual void setVarThreshold (double varThreshold)=0
 Sets the variance threshold for the pixel-model match.
 
virtual void setVarThresholdGen (double varThresholdGen)=0
 Sets the variance threshold for the pixel-model match used for new mixture component generation.
 
- Public Member Functions inherited from cv::BackgroundSubtractor
virtual void getBackgroundImage (OutputArray backgroundImage) const =0
 Computes a background image.
 
- Public Member Functions inherited from cv::Algorithm
 Algorithm ()
 
virtual ~Algorithm ()
 
virtual void clear ()
 Clears the algorithm state.
 
virtual bool empty () const
 Returns true if the Algorithm is empty (e.g. in the very beginning or after unsuccessful read.
 
virtual String getDefaultName () const
 
virtual void read (const FileNode &fn)
 Reads algorithm parameters from a file storage.
 
virtual void save (const String &filename) const
 
virtual void write (FileStorage &fs) const
 Stores algorithm parameters in a file storage.
 
void write (const Ptr< FileStorage > &fs, const String &name=String()) const
 simplified API for language bindingsThis is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 

Additional Inherited Members

- Static Public Member Functions inherited from cv::Algorithm
template<typename _Tp >
static Ptr< _Tp > load (const String &filename, const String &objname=String())
 Loads algorithm from the file.
 
template<typename _Tp >
static Ptr< _Tp > loadFromString (const String &strModel, const String &objname=String())
 Loads algorithm from a String.
 
template<typename _Tp >
static Ptr< _Tp > read (const FileNode &fn)
 Reads algorithm from the file node.
 
- Protected Member Functions inherited from cv::Algorithm
void writeFormat (FileStorage &fs) const
 

Detailed Description

Gaussian Mixture-based Background/Foreground Segmentation Algorithm.

The class implements the Gaussian mixture model background subtraction described inZivkovic2004 andZivkovic2006 .

Member Function Documentation

virtual void cv::BackgroundSubtractorMOG2::apply ( InputArray  image,
OutputArray  fgmask,
double  learningRate = -1 
)
pure virtual
Python:
fgmask=cv.BackgroundSubtractorMOG2.apply(image[, fgmask[, learningRate]])

Computes a foreground mask.

Parameters
imageNext video frame. Floating point frame will be used without scaling and should be in range \([0,255]\).
fgmaskThe output foreground mask as an 8-bit binary image.
learningRateThe value between 0 and 1 that indicates how fast the background model is learnt. Negative parameter value makes the algorithm to use some automatically chosen learning rate. 0 means that the background model is not updated at all, 1 means that the background model is completely reinitialized from the last frame.

Implements cv::BackgroundSubtractor.

virtual double cv::BackgroundSubtractorMOG2::getBackgroundRatio ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getBackgroundRatio()

Returns the "background ratio" parameter of the algorithm.

If a foreground pixel keeps semi-constant value for about backgroundRatio*history frames, it's considered background and added to the model as a center of a new component. It corresponds to TB parameter in the paper.

virtual double cv::BackgroundSubtractorMOG2::getComplexityReductionThreshold ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getComplexityReductionThreshold()

Returns the complexity reduction threshold.

This parameter defines the number of samples needed to accept to prove the component exists. CT=0.05 is a default value for all the samples. By setting CT=0 you get an algorithm very similar to the standard Stauffer&Grimson algorithm.

virtual bool cv::BackgroundSubtractorMOG2::getDetectShadows ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getDetectShadows()

Returns the shadow detection flag.

If true, the algorithm detects shadows and marks them. See createBackgroundSubtractorMOG2 for details.

virtual int cv::BackgroundSubtractorMOG2::getHistory ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getHistory()

Returns the number of last frames that affect the background model.

virtual int cv::BackgroundSubtractorMOG2::getNMixtures ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getNMixtures()

Returns the number of gaussian components in the background model.

virtual double cv::BackgroundSubtractorMOG2::getShadowThreshold ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getShadowThreshold()

Returns the shadow threshold.

A shadow is detected if pixel is a darker version of the background. The shadow threshold (Tau in the paper) is a threshold defining how much darker the shadow can be. Tau= 0.5 means that if a pixel is more than twice darker then it is not shadow. See Prati, Mikic, Trivedi and Cucchiara, Detecting Moving Shadows..., IEEE PAMI,2003.

virtual int cv::BackgroundSubtractorMOG2::getShadowValue ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getShadowValue()

Returns the shadow value.

Shadow value is the value used to mark shadows in the foreground mask. Default value is 127. Value 0 in the mask always means background, 255 means foreground.

virtual double cv::BackgroundSubtractorMOG2::getVarInit ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getVarInit()

Returns the initial variance of each gaussian component.

virtual double cv::BackgroundSubtractorMOG2::getVarMax ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getVarMax()
virtual double cv::BackgroundSubtractorMOG2::getVarMin ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getVarMin()
virtual double cv::BackgroundSubtractorMOG2::getVarThreshold ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getVarThreshold()

Returns the variance threshold for the pixel-model match.

The main threshold on the squared Mahalanobis distance to decide if the sample is well described by the background model or not. Related to Cthr from the paper.

virtual double cv::BackgroundSubtractorMOG2::getVarThresholdGen ( ) const
pure virtual
Python:
retval=cv.BackgroundSubtractorMOG2.getVarThresholdGen()

Returns the variance threshold for the pixel-model match used for new mixture component generation.

Threshold for the squared Mahalanobis distance that helps decide when a sample is close to the existing components (corresponds to Tg in the paper). If a pixel is not close to any component, it is considered foreground or added as a new component. 3 sigma => Tg=3*3=9 is default. A smaller Tg value generates more components. A higher Tg value may result in a small number of components but they can grow too large.

virtual void cv::BackgroundSubtractorMOG2::setBackgroundRatio ( double  ratio)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setBackgroundRatio(ratio)

Sets the "background ratio" parameter of the algorithm.

virtual void cv::BackgroundSubtractorMOG2::setComplexityReductionThreshold ( double  ct)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setComplexityReductionThreshold(ct)

Sets the complexity reduction threshold.

virtual void cv::BackgroundSubtractorMOG2::setDetectShadows ( bool  detectShadows)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setDetectShadows(detectShadows)

Enables or disables shadow detection.

virtual void cv::BackgroundSubtractorMOG2::setHistory ( int  history)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setHistory(history)

Sets the number of last frames that affect the background model.

virtual void cv::BackgroundSubtractorMOG2::setNMixtures ( int  nmixtures)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setNMixtures(nmixtures)

Sets the number of gaussian components in the background model.

The model needs to be reinitalized to reserve memory.

virtual void cv::BackgroundSubtractorMOG2::setShadowThreshold ( double  threshold)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setShadowThreshold(threshold)

Sets the shadow threshold.

virtual void cv::BackgroundSubtractorMOG2::setShadowValue ( int  value)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setShadowValue(value)

Sets the shadow value.

virtual void cv::BackgroundSubtractorMOG2::setVarInit ( double  varInit)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setVarInit(varInit)

Sets the initial variance of each gaussian component.

virtual void cv::BackgroundSubtractorMOG2::setVarMax ( double  varMax)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setVarMax(varMax)
virtual void cv::BackgroundSubtractorMOG2::setVarMin ( double  varMin)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setVarMin(varMin)
virtual void cv::BackgroundSubtractorMOG2::setVarThreshold ( double  varThreshold)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setVarThreshold(varThreshold)

Sets the variance threshold for the pixel-model match.

virtual void cv::BackgroundSubtractorMOG2::setVarThresholdGen ( double  varThresholdGen)
pure virtual
Python:
None=cv.BackgroundSubtractorMOG2.setVarThresholdGen(varThresholdGen)

Sets the variance threshold for the pixel-model match used for new mixture component generation.


The documentation for this class was generated from the following file: