HALCON Website / HALCON Operator Reference / Classification / Gaussian Mixture Models
ClassesClassesClassesClasses | | | | Operators

read_class_gmmread_class_gmmReadClassGmmread_class_gmmReadClassGmmReadClassGmm (Operator)

Name

read_class_gmmread_class_gmmReadClassGmmread_class_gmmReadClassGmmReadClassGmm — Read a Gaussian Mixture Model from a file.

Signature

read_class_gmm( : : FileName : GMMHandle)

Herror read_class_gmm(const char* FileName, Hlong* GMMHandle)

Herror T_read_class_gmm(const Htuple FileName, Htuple* GMMHandle)

Herror read_class_gmm(const HTuple& FileName, Hlong* GMMHandle)

void HClassGmm::ReadClassGmm(const HTuple& FileName)

void ReadClassGmm(const HTuple& FileName, HTuple* GMMHandle)

void HClassGmm::HClassGmm(const HString& FileName)

void HClassGmm::HClassGmm(const char* FileName)

void HClassGmm::ReadClassGmm(const HString& FileName)

void HClassGmm::ReadClassGmm(const char* FileName)

void HOperatorSetX.ReadClassGmm(
[in] VARIANT FileName, [out] VARIANT* GMMHandle)

void HClassGmmX.ReadClassGmm([in] BSTR FileName)

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

public HClassGmm(string fileName)

void HClassGmm.ReadClassGmm(string fileName)

Description

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

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

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

File name.

File extension: .ggc

GMMHandleGMMHandleGMMHandleGMMHandleGMMHandleGMMHandle (output_control)  class_gmm → HClassGmm, HTupleHTupleHClassGmm, HTupleHClassGmmX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

GMM handle.

Result

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

Possible Successors

classify_class_gmmclassify_class_gmmClassifyClassGmmclassify_class_gmmClassifyClassGmmClassifyClassGmm, evaluate_class_gmmevaluate_class_gmmEvaluateClassGmmevaluate_class_gmmEvaluateClassGmmEvaluateClassGmm, create_class_lut_gmmcreate_class_lut_gmmCreateClassLutGmmcreate_class_lut_gmmCreateClassLutGmmCreateClassLutGmm

See also

create_class_gmmcreate_class_gmmCreateClassGmmcreate_class_gmmCreateClassGmmCreateClassGmm, write_class_gmmwrite_class_gmmWriteClassGmmwrite_class_gmmWriteClassGmmWriteClassGmm

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 13.0.4 Copyright © 1996-2019 MVTec Software GmbH