HALCON Reference Manual 10.0.2
Table of Contents / Classification / Gaussian Mixture Models ClassesClassesClasses | | | Operators

read_class_gmmread_class_gmmread_class_gmmReadClassGmmReadClassGmm (Operator)

Name

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

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

void HClassGmm::ReadClassGmm(const HTuple& 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_gmmread_class_gmmReadClassGmmReadClassGmm reads a Gaussian Mixture Model (GMM) that has been stored with write_class_gmmwrite_class_gmmwrite_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_gmmwrite_class_gmmWriteClassGmmWriteClassGmm. In the online process the GMM is read with read_class_gmmread_class_gmmread_class_gmmReadClassGmmReadClassGmm and subsequently used for evaluation with evaluate_class_gmmevaluate_class_gmmevaluate_class_gmmEvaluateClassGmmEvaluateClassGmm or for classification with classify_class_gmmclassify_class_gmmclassify_class_gmmClassifyClassGmmClassifyClassGmm. The default HALCON file extension for the GMM classifier is 'ggc'.

Parallelization

Parameters

FileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

File name.

File extension: .ggc

GMMHandleGMMHandleGMMHandleGMMHandleGMMHandle (output_control)  class_gmm → HClassGmm, HTupleHClassGmm, HTupleHClassGmmX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

GMM handle.

Result

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

Possible Successors

classify_class_gmmclassify_class_gmmclassify_class_gmmClassifyClassGmmClassifyClassGmm, evaluate_class_gmmevaluate_class_gmmevaluate_class_gmmEvaluateClassGmmEvaluateClassGmm, create_class_lut_gmmcreate_class_lut_gmmcreate_class_lut_gmmCreateClassLutGmmCreateClassLutGmm

See also

create_class_gmmcreate_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmm, write_class_gmmwrite_class_gmmwrite_class_gmmWriteClassGmmWriteClassGmm

Module

Foundation

Table of Contents / Classification / Gaussian Mixture Models ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH