read_samples_class_gmmread_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmm (Operator)

Name

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

Signature

Description

read_samples_class_gmmread_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmm reads training samples from the file given by FileNameFileNameFileNameFileNamefileName and adds them to the training samples that have already been stored in the Gaussian Mixture Model (GMM) given by GMMHandleGMMHandleGMMHandleGMMHandleGMMHandle. The GMM must be created with create_class_gmmcreate_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmm before calling read_samples_class_gmmread_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmm. As described with train_class_gmmtrain_class_gmmtrain_class_gmmTrainClassGmmTrainClassGmm and write_samples_class_gmmwrite_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmm, read_samples_class_gmmread_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmm, add_sample_class_gmmadd_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmm, and write_samples_class_gmmwrite_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmm 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 FileNameFileNameFileNameFileNamefileName must have the lengths NumDimNumDimNumDimNumDimnumDim that was specified with create_class_gmmcreate_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmm, and enough classes must have been created in create_class_gmmcreate_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmm. 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_svmwrite_samples_class_svmwrite_samples_class_svmWriteSamplesClassSvmWriteSamplesClassSvm or write_samples_class_mlpwrite_samples_class_mlpwrite_samples_class_mlpWriteSamplesClassMlpWriteSamplesClassMlp.

Parallelization

• Multithreading type: exclusive (runs in parallel only with independent operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

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

Possible Predecessors

create_class_gmmcreate_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmm

Possible Successors

train_class_gmmtrain_class_gmmtrain_class_gmmTrainClassGmmTrainClassGmm

Alternatives

add_sample_class_gmmadd_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmm

See also

write_samples_class_gmmwrite_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmm, write_samples_class_mlpwrite_samples_class_mlpwrite_samples_class_mlpWriteSamplesClassMlpWriteSamplesClassMlp, clear_samples_class_gmmclear_samples_class_gmmclear_samples_class_gmmClearSamplesClassGmmClearSamplesClassGmm

Module

Foundation