Operators

# evaluate_class_gmm (Operator)

## Name

evaluate_class_gmm — Evaluate a feature vector by a Gaussian Mixture Model.

## Signature

evaluate_class_gmm( : : GMMHandle, Features : ClassProb, Density, KSigmaProb)

## Description

evaluate_class_gmm computes three different probability values for a feature vector Features with the Gaussian Mixture Model (GMM) GMMHandle.

The a-posteriori probability of class i for the sample Features(x) is computed as

and returned for each class in ClassProb. The formulas for the calculation of the center density function p(x|j) are described with create_class_gmm.

The probability density of the feature vector is computed as a sum of the posterior class probabilities

and is returned in Density. Here, Pr(i) are the prior classes probabilities as computed by train_class_gmm. Density can be used for novelty detection, i.e., to reject feature vectors that do not belong to any of the trained classes. However, since Density depends on the scaling of the feature vectors and since Density is a probability density, and consequently does not need to lie between 0 and 1, the novelty detection can typically be performed more easily with KSigmaProb (see below).

A k-sigma error ellipsoid is defined as a locus of points for which

In the one dimensional case this is the interval . For any 1D Gaussian distribution, it is true that approximately 65% of the occurrences of the random variable are within this range for k=1, approximately 95% for k=2, approximately 99% for k=3, etc. Hence, the probability that a Gaussian distribution will generate a random variable outside this range is approximately 35%, 5%, and 1%, respectively. This probability is called k-sigma probability and is denoted by P[k]. P[k] can be computed numerically for univariate as well as for multivariate Gaussian distributions, where it should be noted that for the same values of k, (here N and (N+1) denote dimensions). For Gaussian mixture models the k-sigma probability is computed as:
They are weighted with the class priors and then normalized. The maximum value of all classes is returned in KSigmaProb, such that

KSigmaProb can be used for novelty detection. Typically, feature vectors having values below 0.0001 should be rejected. Note that the rejection threshold defined by the parameter RejectionThreshold in classify_image_class_gmm refers to the KSigmaProb values.

Before calling evaluate_class_gmm, the GMM must be trained with train_class_gmm.

The position of the maximum value of ClassProb is usually interpreted as the class of the feature vector and the corresponding value as the probability of the class. In this case, classify_class_gmm should be used instead of evaluate_class_gmm, because classify_class_gmm directly returns the class and corresponding probability.

## Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Processed without parallelization.

## Parameters

GMMHandle (input_control)  class_gmm (integer)

GMM handle.

Features (input_control)  real-array (real)

Feature vector.

ClassProb (output_control)  real-array (real)

A-posteriori probability of the classes.

Density (output_control)  real (real)

Probability density of the feature vector.

KSigmaProb (output_control)  real (real)

Normalized k-sigma-probability for the feature vector.

## Result

If the parameters are valid, the operator evaluate_class_gmm returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.