Operator Reference

HALCON Operator Reference / Classification / Gaussian Mixture Models

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

read_class_gmmT_read_class_gmmReadClassGmmReadClassGmmread_class_gmm (Operator)

read_class_gmmT_read_class_gmmReadClassGmmReadClassGmmread_class_gmm — Read a Gaussian Mixture Model from a file.

Signature

read_class_gmm( : : FileName : GMMHandle)

Herror T_read_class_gmm(const Htuple FileName, Htuple* GMMHandle)

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

void HClassGmm::ReadClassGmm(const HString& FileName)

void HClassGmm::ReadClassGmm(const char* FileName)

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

static void HOperatorSet.ReadClassGmm(HTuple fileName, out HTuple GMMHandle)

public HClassGmm(string fileName)

void HClassGmm.ReadClassGmm(string fileName)

def read_class_gmm(file_name: str) -> HHandle

Description

read_class_gmmread_class_gmmReadClassGmmReadClassGmmread_class_gmm reads a Gaussian Mixture Model (GMM) that has been stored with write_class_gmmwrite_class_gmmWriteClassGmmWriteClassGmmwrite_class_gmm. 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_gmmwrite_class_gmmWriteClassGmmWriteClassGmmwrite_class_gmm. In the online process the GMM is read with read_class_gmmread_class_gmmReadClassGmmReadClassGmmread_class_gmm and subsequently used for evaluation with evaluate_class_gmmevaluate_class_gmmEvaluateClassGmmEvaluateClassGmmevaluate_class_gmm or for classification with classify_class_gmmclassify_class_gmmClassifyClassGmmClassifyClassGmmclassify_class_gmm. The default HALCON file extension for the GMM classifier is 'ggc'.

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

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

File name.

File extension: .ggc

GMMHandleGMMHandleGMMHandleGMMHandlegmmhandle (output_control)  class_gmm → HClassGmm, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

GMM handle.

Result

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

Possible Successors

classify_class_gmmclassify_class_gmmClassifyClassGmmClassifyClassGmmclassify_class_gmm, evaluate_class_gmmevaluate_class_gmmEvaluateClassGmmEvaluateClassGmmevaluate_class_gmm, create_class_lut_gmmcreate_class_lut_gmmCreateClassLutGmmCreateClassLutGmmcreate_class_lut_gmm

See also

create_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmmcreate_class_gmm, write_class_gmmwrite_class_gmmWriteClassGmmWriteClassGmmwrite_class_gmm

Module

Foundation

---

ClassesClasses | | Operators