Operator Reference

HALCON Operator Reference / Legacy / Classification
ClassesClasses | | Operators

enquire_reject_class_boxT_enquire_reject_class_boxEnquireRejectClassBoxEnquireRejectClassBoxenquire_reject_class_box (Operator)

enquire_reject_class_boxT_enquire_reject_class_boxEnquireRejectClassBoxEnquireRejectClassBoxenquire_reject_class_box — Classify a tuple of attributes with rejection class.

Warning

enquire_reject_class_boxenquire_reject_class_boxEnquireRejectClassBoxEnquireRejectClassBoxenquire_reject_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. The operator will be removed with HALCON 25.11.

Signature

enquire_reject_class_box( : : ClassifHandle, FeatureList : Class)

Herror T_enquire_reject_class_box(const Htuple ClassifHandle, const Htuple FeatureList, Htuple* Class)

void EnquireRejectClassBox(const HTuple& ClassifHandle, const HTuple& FeatureList, HTuple* Class)

Hlong HClassBox::EnquireRejectClassBox(const HTuple& FeatureList) const

static void HOperatorSet.EnquireRejectClassBox(HTuple classifHandle, HTuple featureList, out HTuple classVal)

int HClassBox.EnquireRejectClassBox(HTuple featureList)

def enquire_reject_class_box(classif_handle: HHandle, feature_list: Sequence[Union[int, float, str]]) -> int

Description

FeatureListFeatureListFeatureListfeatureListfeature_list is a tuple of any floating point- or integer numbers (attributes) which has to be assigned to a class with assistance of a previous trained (learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxlearn_class_box) classifier. It is possible to specify attributes as unknown by indicating the symbol '*' instead of a number. If you specify n values, then all following values, i.e. the attributes n+1 until 'max', are automatically supposed to be undefined.

If the array of attributes cannot be assigned to a class, i.e. the array does not reside inside of one of the hyper boxes, then in contrary to enquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBoxenquire_class_box not the next class is going to be returned, but the rejection class -1 as a result is going to be passed.

See learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxlearn_class_box for more details about the functionality of the classifier.

You may call the operators learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxlearn_class_box and enquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBoxenquire_class_box alternately, so that it is possible to classify already in the phase of learning. By this means you could see when a satisfying behavior had been reached.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

ClassifHandleClassifHandleClassifHandleclassifHandleclassif_handle (input_control)  class_box → HClassBox, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the classifier.

FeatureListFeatureListFeatureListfeatureListfeature_list (input_control)  real-array → HTupleSequence[Union[int, float, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Array of attributes which has to be classified.

Default: 1.0

ClassClassClassclassValclass (output_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of the class, to which the array of attributes had been assigned or -1 for the rejection class.

Result

enquire_reject_class_boxenquire_reject_class_boxEnquireRejectClassBoxEnquireRejectClassBoxenquire_reject_class_box returns 2 ( H_MSG_TRUE) .

Possible Predecessors

create_class_boxcreate_class_boxCreateClassBoxCreateClassBoxcreate_class_box, learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxlearn_class_box, set_class_box_paramset_class_box_paramSetClassBoxParamSetClassBoxParamset_class_box_param

Possible Successors

learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxlearn_class_box, write_class_boxwrite_class_boxWriteClassBoxWriteClassBoxwrite_class_box, close_class_boxclose_class_boxCloseClassBoxCloseClassBoxclose_class_box

Alternatives

enquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBoxenquire_class_box

See also

test_sampset_boxtest_sampset_boxTestSampsetBoxTestSampsetBoxtest_sampset_box, learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxlearn_class_box, learn_sampset_boxlearn_sampset_boxLearnSampsetBoxLearnSampsetBoxlearn_sampset_box

Module

Foundation

ClassesClasses | | Operators