Skip to content

read_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmmread_samples_class_gmmT_read_samples_class_gmm🔗

Short description🔗

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

Signature🔗

read_samples_class_gmm( class_gmm GMMHandle, filename.read FileName )void ReadSamplesClassGmm( const HTuple& GMMHandle, const HTuple& FileName )static void HOperatorSet.ReadSamplesClassGmm( HTuple GMMHandle, HTuple fileName )def read_samples_class_gmm( gmmhandle: HHandle, file_name: str ) -> None

Herror T_read_samples_class_gmm( const Htuple GMMHandle, const Htuple FileName )

void HClassGmm::ReadSamplesClassGmm( const HString& FileName ) const

void HClassGmm::ReadSamplesClassGmm( const char* FileName ) const

void HClassGmm::ReadSamplesClassGmm( const wchar_t* FileName ) const (Windows only)

void HClassGmm.ReadSamplesClassGmm( string fileName )

Description🔗

read_samples_class_gmmReadSamplesClassGmm reads training samples from the file given by FileNamefileNamefile_name and adds them to the training samples that have already been stored in the Gaussian Mixture Model (GMM) given by GMMHandleGMMHandlegmmhandle. The GMM must be created with create_class_gmmCreateClassGmm before calling read_samples_class_gmmReadSamplesClassGmm. As described with train_class_gmmTrainClassGmm and write_samples_class_gmmWriteSamplesClassGmm, read_samples_class_gmmReadSamplesClassGmm, add_sample_class_gmmAddSampleClassGmm, and write_samples_class_gmmWriteSamplesClassGmm 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 FileNamefileNamefile_name must have the lengths NumDimnumDimnum_dim that was specified with create_class_gmmCreateClassGmm, and enough classes must have been created in create_class_gmmCreateClassGmm. 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_svmWriteSamplesClassSvm or write_samples_class_mlpWriteSamplesClassMlp.

Execution information🔗

Execution information

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

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

This operator modifies the state of the following input parameter:

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters🔗

GMMHandleGMMHandlegmmhandle (input_control, state is modified) class_gmm → (handle)HTuple (HHandle)HClassGmm, HTuple (IntPtr)HHandleHtuple (handle)

GMM handle.

FileNamefileNamefile_name (input_control) filename.read → (string)HTuple (HString)HTuple (string)strHtuple (char*)

File name.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

create_class_gmmCreateClassGmm

Possible successors

train_class_gmmTrainClassGmm

Alternatives

add_sample_class_gmmAddSampleClassGmm

See also

write_samples_class_gmmWriteSamplesClassGmm, write_samples_class_mlpWriteSamplesClassMlp, clear_samples_class_gmmClearSamplesClassGmm

Module🔗

Foundation