Normal Bayes Classifier — OpenCV 2.4.10.0 documentation

### Navigation

- index
- next |
- previous |
- OpenCV 2.4.10.0 documentation »
- OpenCV API Reference »
- ml. Machine Learning »

# 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.

## Help and Feedback

You did not find what you were looking for?

- Ask a question on the Q&A forum.
- If you think something is missing or wrong in the documentation, please file a bug report.

### Navigation

- index
- next |
- previous |
- OpenCV 2.4.10.0 documentation »
- OpenCV API Reference »
- ml. Machine Learning »