HALCON Reference Manual / Classification / Gaussian-Mixture-Models Operators

read_samples_class_gmm (Operator)

Name

read_samples_class_gmm — Read the training data of a Gaussian Mixture Model from a file.

Synopsis

read_samples_class_gmm( : : GMMHandle, FileName : )

Description

read_samples_class_gmm reads training samples from the file given by FileName and adds them to the training samples that have already been stored in the Gaussian Mixture Model (GMM) given by GMMHandle. The GMM must be created with create_class_gmm before calling read_samples_class_gmm. As described with train_class_gmm and write_samples_class_gmm, read_samples_class_gmm, add_sample_class_gmm, and write_samples_class_gmm can be used to build up a database of training samples, and hence to improve the performance of the GMM by retraining the GMM with extended data sets.

It should be noted that the training samples must have the correct dimensionality. The feature vectors stored in FileName must have the lengths NumDim that was specified with create_class_gmm, and enough classes must have been created in create_class_gmm. If this is not the case, an error message is returned.

It is possible to read files of samples that were written with write_samples_class_svm or write_samples_class_mlp.

Parameters

GMMHandle (input_control) class_gmm (integer)
GMM handle.

FileName (input_control) filename.read (string)
File name.

Result

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

Parallelization Information

read_samples_class_gmm is processed completely exclusively without parallelization.

Possible Predecessors

create_class_gmm

Possible Successors

train_class_gmm

Alternatives

add_sample_class_gmm

See also

write_samples_class_gmm, write_samples_class_mlp, clear_samples_class_gmm

Module

Foundation


HALCON Reference Manual / Classification / Gaussian-Mixture-Models Operators
Version 9.0.2 Copyright © 1996-2010 MVTec Software GmbH