ClassesClassesClassesClasses | | | | Operators

learn_sampset_boxlearn_sampset_boxLearnSampsetBoxlearn_sampset_boxLearnSampsetBoxLearnSampsetBox (Operator)

Name

learn_sampset_boxlearn_sampset_boxLearnSampsetBoxlearn_sampset_boxLearnSampsetBoxLearnSampsetBox — Train the classifier with one data set.

Signature

learn_sampset_box( : : ClassifHandle, SampKey, Outfile, NSamples, StopError, ErrorN : )

Herror learn_sampset_box(const Hlong ClassifHandle, const Hlong SampKey, const char* Outfile, const Hlong NSamples, double StopError, const Hlong ErrorN)

Herror T_learn_sampset_box(const Htuple ClassifHandle, const Htuple SampKey, const Htuple Outfile, const Htuple NSamples, const Htuple StopError, const Htuple ErrorN)

Herror learn_sampset_box(const HTuple& ClassifHandle, const HTuple& SampKey, const HTuple& Outfile, const HTuple& NSamples, const HTuple& StopError, const HTuple& ErrorN)

void HClassBox::LearnSampsetBox(const HTuple& SampKey, const HTuple& Outfile, const HTuple& NSamples, const HTuple& StopError, const HTuple& ErrorN) const

void LearnSampsetBox(const HTuple& ClassifHandle, const HTuple& SampKey, const HTuple& Outfile, const HTuple& NSamples, const HTuple& StopError, const HTuple& ErrorN)

void HFeatureSet::LearnSampsetBox(const HClassBox& ClassifHandle, const HString& Outfile, Hlong NSamples, double StopError, Hlong ErrorN) const

void HFeatureSet::LearnSampsetBox(const HClassBox& ClassifHandle, const char* Outfile, Hlong NSamples, double StopError, Hlong ErrorN) const

void HClassBox::LearnSampsetBox(const HFeatureSet& SampKey, const HString& Outfile, Hlong NSamples, double StopError, Hlong ErrorN) const

void HClassBox::LearnSampsetBox(const HFeatureSet& SampKey, const char* Outfile, Hlong NSamples, double StopError, Hlong ErrorN) const

void HOperatorSetX.LearnSampsetBox(
[in] VARIANT ClassifHandle, [in] VARIANT SampKey, [in] VARIANT Outfile, [in] VARIANT NSamples, [in] VARIANT StopError, [in] VARIANT ErrorN)

void HFeatureSetX.LearnSampsetBox(
[in] IHClassBoxX* ClassifHandle, [in] BSTR Outfile, [in] Hlong NSamples, [in] double StopError, [in] Hlong ErrorN)

void HClassBoxX.LearnSampsetBox(
[in] IHFeatureSetX* SampKey, [in] BSTR Outfile, [in] Hlong NSamples, [in] double StopError, [in] Hlong ErrorN)

static void HOperatorSet.LearnSampsetBox(HTuple classifHandle, HTuple sampKey, HTuple outfile, HTuple NSamples, HTuple stopError, HTuple errorN)

void HFeatureSet.LearnSampsetBox(HClassBox classifHandle, string outfile, int NSamples, double stopError, int errorN)

void HClassBox.LearnSampsetBox(HFeatureSet sampKey, string outfile, int NSamples, double stopError, int errorN)

Description

learn_sampset_boxlearn_sampset_boxLearnSampsetBoxlearn_sampset_boxLearnSampsetBoxLearnSampsetBox trains the classifier with data for the key SampKeySampKeySampKeySampKeySampKeysampKey (see read_sampsetread_sampsetReadSampsetread_sampsetReadSampsetReadSampset). The training sequence is terminated at least after NSamplesNSamplesNSamplesNSamplesNSamplesNSamples examples. If NSamplesNSamplesNSamplesNSamplesNSamplesNSamples is bigger than the number of examples in SampKeySampKeySampKeySampKeySampKeysampKey, then a cyclic start at the beginning occurs. If the error underpasses the value StopErrorStopErrorStopErrorStopErrorStopErrorstopError, then the training sequence is prematurely terminated. StopErrorStopErrorStopErrorStopErrorStopErrorstopError is calculated with N / ErrorN. Whereby N means the number of examples which were wrong classified during the last ErrorNErrorNErrorNErrorNErrorNerrorN training examples. Typically ErrorNErrorNErrorNErrorNErrorNerrorN is the number of examples in SampKeySampKeySampKeySampKeySampKeysampKey and NSamplesNSamplesNSamplesNSamplesNSamplesNSamples is a multiple of it. If you want a data set with 100 examples to run 5 times at most and if you want it to terminate with an error lower than 5%, then the corresponding values are NSamplesNSamplesNSamplesNSamplesNSamplesNSamples = 500, ErrorNErrorNErrorNErrorNErrorNerrorN = 100 and StopErrorStopErrorStopErrorStopErrorStopErrorstopError = 0.05. A protocol of the training activity is going to be written in file OutfileOutfileOutfileOutfileOutfileoutfile.

Parallelization

Parameters

ClassifHandleClassifHandleClassifHandleClassifHandleClassifHandleclassifHandle (input_control)  class_box HClassBox, HTupleHTupleHClassBox, HTupleHClassBoxX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the classifier.

SampKeySampKeySampKeySampKeySampKeysampKey (input_control)  feature_set HFeatureSet, HTupleHTupleHTupleHFeatureSetX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Number of the data set to train.

OutfileOutfileOutfileOutfileOutfileoutfile (input_control)  filename.write HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name of the protocol file.

Default value: 'training_prot' "training_prot" "training_prot" "training_prot" "training_prot" "training_prot"

NSamplesNSamplesNSamplesNSamplesNSamplesNSamples (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of arrays of attributes to learn.

Default value: 500

StopErrorStopErrorStopErrorStopErrorStopErrorstopError (input_control)  real HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Classification error for termination.

Default value: 0.05

ErrorNErrorNErrorNErrorNErrorNerrorN (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Error during the assignment.

Default value: 100

Result

learn_sampset_boxlearn_sampset_boxLearnSampsetBoxlearn_sampset_boxLearnSampsetBoxLearnSampsetBox returns 2 (H_MSG_TRUE). An exception is raised if key SampKeySampKeySampKeySampKeySampKeysampKey does not exist or there are problems while opening the file.

Possible Predecessors

create_class_boxcreate_class_boxCreateClassBoxcreate_class_boxCreateClassBoxCreateClassBox

Possible Successors

test_sampset_boxtest_sampset_boxTestSampsetBoxtest_sampset_boxTestSampsetBoxTestSampsetBox, enquire_class_boxenquire_class_boxEnquireClassBoxenquire_class_boxEnquireClassBoxEnquireClassBox, write_class_boxwrite_class_boxWriteClassBoxwrite_class_boxWriteClassBoxWriteClassBox, close_class_boxclose_class_boxCloseClassBoxclose_class_boxCloseClassBoxCloseClassBox, clear_sampsetclear_sampsetClearSampsetclear_sampsetClearSampsetClearSampset

See also

test_sampset_boxtest_sampset_boxTestSampsetBoxtest_sampset_boxTestSampsetBoxTestSampsetBox, enquire_class_boxenquire_class_boxEnquireClassBoxenquire_class_boxEnquireClassBoxEnquireClassBox, learn_class_boxlearn_class_boxLearnClassBoxlearn_class_boxLearnClassBoxLearnClassBox, read_sampsetread_sampsetReadSampsetread_sampsetReadSampsetReadSampset

Module

Foundation


ClassesClassesClassesClasses | | | | Operators