Normal Bayes Classifier¶

This simple classification model assumes that feature vectors from each class are normally distributed (though, not necessarily independently distributed). So, the whole data distribution function is assumed to be a Gaussian mixture, one component per class. Using the training data the algorithm estimates mean vectors and covariance matrices for every class, and then it uses them for prediction.

 [Fukunaga90] Fukunaga. Introduction to Statistical Pattern Recognition. second ed., New York: Academic Press, 1990.

CvNormalBayesClassifier¶

class `CvNormalBayesClassifier` : public `CvStatModel`

Bayes classifier for normally distributed data.

CvNormalBayesClassifier::CvNormalBayesClassifier¶

Default and training constructors.

C++:` ` `CvNormalBayesClassifier::``CvNormalBayesClassifier`()
C++:` ` `CvNormalBayesClassifier::``CvNormalBayesClassifier`(const Mat& trainData, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat() )
C++:` ` `CvNormalBayesClassifier::``CvNormalBayesClassifier`(const CvMat* trainData, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0 )
Python:` ``cv2.``NormalBayesClassifier`([trainData, responses[, varIdx[, sampleIdx]]]) → <NormalBayesClassifier object>

The constructors follow conventions of `CvStatModel::CvStatModel()`. See `CvStatModel::train()` for parameters descriptions.

CvNormalBayesClassifier::train¶

Trains the model.

C++:` `bool `CvNormalBayesClassifier::``train`(const Mat& trainData, const Mat& responses, const Mat& varIdx=Mat(), const Mat& sampleIdx=Mat(), bool update=false )
C++:` `bool `CvNormalBayesClassifier::``train`(const CvMat* trainData, const CvMat* responses, const CvMat* varIdx=0, const CvMat* sampleIdx=0, bool update=false )
Python:` ``cv2.NormalBayesClassifier.``train`(trainData, responses[, varIdx[, sampleIdx[, update]]]) → retval
Parameters: update – Identifies whether the model should be trained from scratch (`update=false`) or should be updated using the new training data (`update=true`).

The method trains the Normal Bayes classifier. It follows the conventions of the generic `CvStatModel::train()` approach with the following limitations:

• Only `CV_ROW_SAMPLE` data layout is supported.
• Input variables are all ordered.
• Output variable is categorical , which means that elements of `responses` must be integer numbers, though the vector may have the `CV_32FC1` type.
• Missing measurements are not supported.

CvNormalBayesClassifier::predict¶

Predicts the response for sample(s).

C++:` `float `CvNormalBayesClassifier::``predict`(const Mat& samples, Mat* results=0 )` const`
C++:` `float `CvNormalBayesClassifier::``predict`(const CvMat* samples, CvMat* results=0 )` const`
Python:` ``cv2.NormalBayesClassifier.``predict`(samples) → retval, results

The method estimates the most probable classes for input vectors. Input vectors (one or more) are stored as rows of the matrix `samples`. In case of multiple input vectors, there should be one output vector `results`. The predicted class for a single input vector is returned by the method.

The function is parallelized with the TBB library.