Skip to content

read_class_gmmReadClassGmmReadClassGmmread_class_gmmT_read_class_gmm🔗

Short description🔗

read_class_gmmReadClassGmmReadClassGmmread_class_gmmT_read_class_gmm — Read a Gaussian Mixture Model from a file.

Signature🔗

read_class_gmm( filename.read FileName, out class_gmm GMMHandle )void ReadClassGmm( const HTuple& FileName, HTuple* GMMHandle )static void HOperatorSet.ReadClassGmm( HTuple fileName, out HTuple GMMHandle )def read_class_gmm( file_name: str ) -> HHandle

Herror T_read_class_gmm( const Htuple FileName, Htuple* GMMHandle )

void HClassGmm::HClassGmm( const HString& FileName )

void HClassGmm::HClassGmm( const char* FileName )

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

public HClassGmm( string fileName )

void HClassGmm::ReadClassGmm( const HString& FileName )

void HClassGmm::ReadClassGmm( const char* FileName )

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

void HClassGmm.ReadClassGmm( string fileName )

Description🔗

read_class_gmmReadClassGmm reads a Gaussian Mixture Model (GMM) that has been stored with write_class_gmmWriteClassGmm. Since the training of an GMM can consume a relatively long time, the GMM is typically trained in an offline process and written to a file with write_class_gmmWriteClassGmm. In the online process the GMM is read with read_class_gmmReadClassGmm and subsequently used for evaluation with evaluate_class_gmmEvaluateClassGmm or for classification with classify_class_gmmClassifyClassGmm. The default HALCON file extension for the GMM classifier is 'ggc'.

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 returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters🔗

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

File name.

File extension: .ggc

GMMHandleGMMHandlegmmhandle (output_control) class_gmm → (handle)HTuple (HHandle)HClassGmm, HTuple (IntPtr)HHandleHtuple (handle)

GMM handle.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible successors

classify_class_gmmClassifyClassGmm, evaluate_class_gmmEvaluateClassGmm, create_class_lut_gmmCreateClassLutGmm

See also

create_class_gmmCreateClassGmm, write_class_gmmWriteClassGmm

Module🔗

Foundation