read_class_boxT_read_class_boxReadClassBoxReadClassBoxread_class_box (Operator)

Name

read_class_boxT_read_class_boxReadClassBoxReadClassBoxread_class_box — Read a classifier from a file.

Warning

read_class_boxread_class_boxReadClassBoxReadClassBoxReadClassBoxread_class_box 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_boxReadClassBoxReadClassBoxReadClassBoxread_class_box reads the saved classifier from the file FileNameFileNameFileNameFileNamefileNamefile_name (see write_class_boxwrite_class_boxWriteClassBoxWriteClassBoxWriteClassBoxwrite_class_box). 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:

ClassifHandleClassifHandleClassifHandleClassifHandleclassifHandleclassif_handle

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

Parameters

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

Handle of the classifier.

FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → (string)

Filename of the classifier.

File extension: .gbc

Result

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

Possible Predecessors

create_class_boxcreate_class_boxCreateClassBoxCreateClassBoxCreateClassBoxcreate_class_box

Possible Successors

test_sampset_boxtest_sampset_boxTestSampsetBoxTestSampsetBoxTestSampsetBoxtest_sampset_box, enquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBoxEnquireClassBoxenquire_class_box, write_class_boxwrite_class_boxWriteClassBoxWriteClassBoxWriteClassBoxwrite_class_box, close_class_boxclose_class_boxCloseClassBoxCloseClassBoxCloseClassBoxclose_class_box, clear_sampsetclear_sampsetClearSampsetClearSampsetClearSampsetclear_sampset

Module

Foundation

Operators