Operator Reference

HALCON Operator Reference / Classification / Gaussian Mixture Models
ClassesClasses | | Operators

read_samples_class_gmmT_read_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmmread_samples_class_gmm (Operator)

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

Signature

read_samples_class_gmm( : : GMMHandle, FileName : )

Herror T_read_samples_class_gmm(const Htuple GMMHandle, const Htuple FileName)

void ReadSamplesClassGmm(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)

static void HOperatorSet.ReadSamplesClassGmm(HTuple GMMHandle, HTuple fileName)

void HClassGmm.ReadSamplesClassGmm(string fileName)

def read_samples_class_gmm(gmmhandle: HHandle, file_name: str) -> None

Description

read_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmmread_samples_class_gmm reads training samples from the file given by FileNameFileNameFileNamefileNamefile_name 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_gmmCreateClassGmmCreateClassGmmcreate_class_gmm before calling read_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmmread_samples_class_gmm. As described with train_class_gmmtrain_class_gmmTrainClassGmmTrainClassGmmtrain_class_gmm and write_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmmwrite_samples_class_gmm, read_samples_class_gmmread_samples_class_gmmReadSamplesClassGmmReadSamplesClassGmmread_samples_class_gmm, add_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmmadd_sample_class_gmm, and write_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmmwrite_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 FileNameFileNameFileNamefileNamefile_name must have the lengths NumDimNumDimNumDimnumDimnum_dim that was specified with create_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmmcreate_class_gmm, and enough classes must have been created in create_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmmcreate_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_svmwrite_samples_class_svmWriteSamplesClassSvmWriteSamplesClassSvmwrite_samples_class_svm or write_samples_class_mlpwrite_samples_class_mlpWriteSamplesClassMlpWriteSamplesClassMlpwrite_samples_class_mlp.

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

GMMHandleGMMHandleGMMHandleGMMHandlegmmhandle (input_control, state is modified)  class_gmm → HClassGmm, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

GMM handle.

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

File name.

Result

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

Possible Predecessors

create_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmmcreate_class_gmm

Possible Successors

train_class_gmmtrain_class_gmmTrainClassGmmTrainClassGmmtrain_class_gmm

Alternatives

add_sample_class_gmmadd_sample_class_gmmAddSampleClassGmmAddSampleClassGmmadd_sample_class_gmm

See also

write_samples_class_gmmwrite_samples_class_gmmWriteSamplesClassGmmWriteSamplesClassGmmwrite_samples_class_gmm, write_samples_class_mlpwrite_samples_class_mlpWriteSamplesClassMlpWriteSamplesClassMlpwrite_samples_class_mlp, clear_samples_class_gmmclear_samples_class_gmmClearSamplesClassGmmClearSamplesClassGmmclear_samples_class_gmm

Module

Foundation

ClassesClasses | | Operators