read_class_boxT_read_class_boxReadClassBoxReadClassBox (Operator)

Name

read_class_boxT_read_class_boxReadClassBoxReadClassBox — Read a classifier from a file.

Warning

read_class_boxread_class_boxReadClassBoxReadClassBoxReadClassBox is obsolete and is only provided for reasons of backward compatibility. New applications should use the MLP, SVM, KNN or GMM operators instead.

Signature

read_class_box( : : ClassifHandle, FileName : )

Description

read_class_boxread_class_boxReadClassBoxReadClassBoxReadClassBox reads the saved classifier from the file FileNameFileNameFileNameFileNamefileName (see write_class_boxwrite_class_boxWriteClassBoxWriteClassBoxWriteClassBox). The values of the current classifier are overwritten. The default HALCON file extension for the box classifier is 'gbc'.

Attention

All values of the classifier are going to be overwritten.

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 modifies the state of the following input parameter:

ClassifHandleClassifHandleClassifHandleClassifHandleclassifHandle

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

ClassifHandleClassifHandleClassifHandleClassifHandleclassifHandle (input_control, state is modified) class_box → (handle)

Handle of the classifier.

FileNameFileNameFileNameFileNamefileName (input_control) filename.read → (string)

Filename of the classifier.

File extension: .gbc

Result

read_class_boxread_class_boxReadClassBoxReadClassBoxReadClassBox returns 2 (H_MSG_TRUE). An exception is raised if it was not possible to open file FileNameFileNameFileNameFileNamefileName or the file has the wrong format.

Possible Predecessors

create_class_boxcreate_class_boxCreateClassBoxCreateClassBoxCreateClassBox

Possible Successors

test_sampset_boxtest_sampset_boxTestSampsetBoxTestSampsetBoxTestSampsetBox, enquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBoxEnquireClassBox, write_class_boxwrite_class_boxWriteClassBoxWriteClassBoxWriteClassBox, close_class_boxclose_class_boxCloseClassBoxCloseClassBoxCloseClassBox, clear_sampsetclear_sampsetClearSampsetClearSampsetClearSampset

Module

Foundation

Operators