read_class_gmmT_read_class_gmmReadClassGmmReadClassGmm (Operator)
Name
read_class_gmmT_read_class_gmmReadClassGmmReadClassGmm — Read a Gaussian Mixture Model from a file.
Signature
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
- 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
FileNameFileNameFileNameFileNamefileName (input_control) filename.read → HTupleHTupleHtuple (string) (string) (HString) (char*)
File name.
File extension: .ggc
GMMHandleGMMHandleGMMHandleGMMHandleGMMHandle (output_control) class_gmm → HClassGmm, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
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