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

read_class_gmmread_class_gmmReadClassGmmReadClassGmm (Operator)

Name

read_class_gmmread_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)

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)

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

public HClassGmm(string fileName)

void HClassGmm.ReadClassGmm(string fileName)

Description

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

Execution Information

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

FileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHtuple (string) (string) (HString) (char*)

File name.

File extension: .ggc

GMMHandleGMMHandleGMMHandleGMMHandleGMMHandle (output_control)  class_gmm → HClassGmm, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

GMM handle.

Result

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

Possible Successors

classify_class_gmmclassify_class_gmmClassifyClassGmmClassifyClassGmmClassifyClassGmm, evaluate_class_gmmevaluate_class_gmmEvaluateClassGmmEvaluateClassGmmEvaluateClassGmm, create_class_lut_gmmcreate_class_lut_gmmCreateClassLutGmmCreateClassLutGmmCreateClassLutGmm

See also

create_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmmCreateClassGmm, write_class_gmmwrite_class_gmmWriteClassGmmWriteClassGmmWriteClassGmm

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH