HALCON Reference Manual 10.0.2
Table of Contents / Classification / Hyperboxes ClassesClassesClasses | | | Operators

set_class_box_paramset_class_box_paramset_class_box_paramSetClassBoxParamSetClassBoxParam (Operator)

Name

set_class_box_paramset_class_box_paramset_class_box_paramSetClassBoxParamSetClassBoxParam — Set system parameters for classification.

Signature

set_class_box_param( : : ClassifHandle, Flag, Value : )

Herror set_class_box_param(const Hlong ClassifHandle, const char* Flag, double Value)

Herror T_set_class_box_param(const Htuple ClassifHandle, const Htuple Flag, const Htuple Value)

Herror set_class_box_param(const HTuple& ClassifHandle, const HTuple& Flag, const HTuple& Value)

void HClassBox::SetClassBoxParam(const HTuple& Flag, const HTuple& Value) const

void HOperatorSetX.SetClassBoxParam(
[in] VARIANT ClassifHandle, [in] VARIANT Flag, [in] VARIANT Value)

void HClassBoxX.SetClassBoxParam(
[in] BSTR Flag, [in] VARIANT Value)

static void HOperatorSet.SetClassBoxParam(HTuple classifHandle, HTuple flag, HTuple value)

void HClassBox.SetClassBoxParam(string flag, HTuple value)

void HClassBox.SetClassBoxParam(string flag, double value)

Description

set_class_box_paramset_class_box_paramset_class_box_paramSetClassBoxParamSetClassBoxParam modifies parameter which manipulate the training sequence while calling learn_class_boxlearn_class_boxlearn_class_boxLearnClassBoxLearnClassBox. Only parameters of the classifier are modified, all other classifiers remain unmodified. 'min_samples_for_split' is the number of examples at least which have to train in one cuboid of this classifier, before the cuboid is allowed to divide itself. 'split_error' indicates the critical error. By its exceeding the cuboid divides itself, if there are more than 'min_samples_for_split' examples to train. 'prop_constant' manipulates the extension of the cuboids. It is proportional to the average distance of the training examples in this cuboid to the center of the cuboid. More detailed:

   extension x prop = average distance of the expectation value.

This relation is valid in every dimension. Hence inside a cuboid the dimensions of the feature space are supposed to be independent.

The parameters are set with problem independent default values, which must not modified without any reason. Parameters are only important during a learning sequence. They do not influence on the behavior of enquire_class_boxenquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBox.

Default setting:

'min_samples_for_split' = 80,

'split_error' = 0.1,

'prop_constant' = 0.25

Parallelization

Parameters

ClassifHandleClassifHandleClassifHandleClassifHandleclassifHandle (input_control)  class_box HClassBox, HTupleHClassBox, HTupleHClassBoxX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Handle of the classifier.

FlagFlagFlagFlagflag (input_control)  string HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Name of the wanted parameter.

Default value: 'split_error' "split_error" "split_error" "split_error" "split_error"

Suggested values: 'min_samples_for_split'"min_samples_for_split""min_samples_for_split""min_samples_for_split""min_samples_for_split", 'split_error'"split_error""split_error""split_error""split_error", 'prop_constant'"prop_constant""prop_constant""prop_constant""prop_constant"

ValueValueValueValuevalue (input_control)  number HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Value of the parameter.

Default value: 0.1

Result

read_sampsetread_sampsetread_sampsetReadSampsetReadSampset returns 2 (H_MSG_TRUE).

Possible Predecessors

create_class_boxcreate_class_boxcreate_class_boxCreateClassBoxCreateClassBox, enquire_class_boxenquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBox

Possible Successors

learn_class_boxlearn_class_boxlearn_class_boxLearnClassBoxLearnClassBox, test_sampset_boxtest_sampset_boxtest_sampset_boxTestSampsetBoxTestSampsetBox, write_class_boxwrite_class_boxwrite_class_boxWriteClassBoxWriteClassBox, close_class_boxclose_class_boxclose_class_boxCloseClassBoxCloseClassBox, clear_sampsetclear_sampsetclear_sampsetClearSampsetClearSampset

See also

enquire_class_boxenquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBox, get_class_box_paramget_class_box_paramget_class_box_paramGetClassBoxParamGetClassBoxParam, learn_class_boxlearn_class_boxlearn_class_boxLearnClassBoxLearnClassBox

Module

Foundation


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