clear_samples_class_gmmclear_samples_class_gmmclear_samples_class_gmmClearSamplesClassGmmClearSamplesClassGmm (Operator)

Name

clear_samples_class_gmmclear_samples_class_gmmclear_samples_class_gmmClearSamplesClassGmmClearSamplesClassGmm — Clear the training data of a Gaussian Mixture Model.

Signature

Description

clear_samples_class_gmmclear_samples_class_gmmclear_samples_class_gmmClearSamplesClassGmmClearSamplesClassGmm clears all training samples that have been stored in the Gaussian Mixture Model (GMM) GMMHandleGMMHandleGMMHandleGMMHandleGMMHandle. clear_samples_class_gmmclear_samples_class_gmmclear_samples_class_gmmClearSamplesClassGmmClearSamplesClassGmm should only be used if the GMM is trained in the same process that uses the GMM for evaluation with evaluate_class_gmmevaluate_class_gmmevaluate_class_gmmEvaluateClassGmmEvaluateClassGmm or for classification with classify_class_gmmclassify_class_gmmclassify_class_gmmClassifyClassGmmClassifyClassGmm. In this case, the memory required for the training samples can be freed with clear_samples_class_gmmclear_samples_class_gmmclear_samples_class_gmmClearSamplesClassGmmClearSamplesClassGmm, and hence memory can be saved. In the normal usage, in which the GMM is trained offline and written to a file with write_class_gmmwrite_class_gmmwrite_class_gmmWriteClassGmmWriteClassGmm, it is typically unnecessary to call clear_samples_class_gmmclear_samples_class_gmmclear_samples_class_gmmClearSamplesClassGmmClearSamplesClassGmm because write_class_gmmwrite_class_gmmwrite_class_gmmWriteClassGmmWriteClassGmm does not save the training samples, and hence the online process, which reads the GMM with read_class_gmmread_class_gmmread_class_gmmReadClassGmmReadClassGmm, requires no memory for the training samples.

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 clear_samples_class_gmmclear_samples_class_gmmclear_samples_class_gmmClearSamplesClassGmmClearSamplesClassGmm returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

train_class_gmmtrain_class_gmmtrain_class_gmmTrainClassGmmTrainClassGmm, write_samples_class_gmmwrite_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmm

See also

create_class_gmmcreate_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmm, clear_class_gmmclear_class_gmmclear_class_gmmClearClassGmmClearClassGmm, add_sample_class_gmmadd_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmm, read_samples_class_gmmread_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmm

Module

Foundation