write_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmm (Operator)

Name

write_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmm — Write the training data of a Gaussian Mixture Model to a file.

Signature

write_samples_class_gmm( : : GMMHandle, FileName : )

write_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmmWriteSamplesClassGmm writes the training samples stored in the Gaussian Mixture Model (GMM) GMMHandleGMMHandleGMMHandleGMMHandleGMMHandle to the file given by FileNameFileNameFileNameFileNamefileName. write_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmmWriteSamplesClassGmm can be used to build up a database of training samples, and hence to improve the performance of the GMM by training it with an extended data set (see train_class_gmmtrain_class_gmmTrainClassGmmTrainClassGmmTrainClassGmm).

The file FileNameFileNameFileNameFileNamefileName is overwritten by write_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmmWriteSamplesClassGmm. Nevertheless, extending the database of training samples is easy because read_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmmReadSamplesClassGmm and add_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmmAddSampleClassGmm add the training samples to the training samples that are already stored in memory with the GMM.

The created file can be read with read_samples_class_mlpread_samples_class_mlpReadSamplesClassMlpReadSamplesClassMlpReadSamplesClassMlp if the classifier of a multilayer perceptron (MLP) should be used. The class of a training sample in the GMM corresponds to a component of the target vector in the MLP being 1.0.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

GMMHandleGMMHandleGMMHandleGMMHandleGMMHandle (input_control) class_gmm → (integer)

GMM handle.

FileNameFileNameFileNameFileNamefileName (input_control) filename.write → (string)

File name.

Result

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