ClassesClassesClassesClasses | | | | Operators

add_sample_class_mlpT_add_sample_class_mlpAddSampleClassMlpadd_sample_class_mlpAddSampleClassMlpAddSampleClassMlp (Operator)

Name

add_sample_class_mlpT_add_sample_class_mlpAddSampleClassMlpadd_sample_class_mlpAddSampleClassMlpAddSampleClassMlp — Add a training sample to the training data of a multilayer perceptron.

Signature

add_sample_class_mlp( : : MLPHandle, Features, Target : )

Herror T_add_sample_class_mlp(const Htuple MLPHandle, const Htuple Features, const Htuple Target)

Herror add_sample_class_mlp(const HTuple& MLPHandle, const HTuple& Features, const HTuple& Target)

void HClassMlp::AddSampleClassMlp(const HTuple& Features, const HTuple& Target) const

void AddSampleClassMlp(const HTuple& MLPHandle, const HTuple& Features, const HTuple& Target)

void HClassMlp::AddSampleClassMlp(const HTuple& Features, const HTuple& Target) const

void HClassMlp::AddSampleClassMlp(const HTuple& Features, Hlong Target) const

void HOperatorSetX.AddSampleClassMlp(
[in] VARIANT MLPHandle, [in] VARIANT Features, [in] VARIANT Target)

void HClassMlpX.AddSampleClassMlp(
[in] VARIANT Features, [in] VARIANT Target)

static void HOperatorSet.AddSampleClassMlp(HTuple MLPHandle, HTuple features, HTuple target)

void HClassMlp.AddSampleClassMlp(HTuple features, HTuple target)

void HClassMlp.AddSampleClassMlp(HTuple features, int target)

Description

add_sample_class_mlpadd_sample_class_mlpAddSampleClassMlpadd_sample_class_mlpAddSampleClassMlpAddSampleClassMlp adds a training sample to the multilayer perceptron (MLP) given by MLPHandleMLPHandleMLPHandleMLPHandleMLPHandleMLPHandle. The training sample is given by FeaturesFeaturesFeaturesFeaturesFeaturesfeatures and TargetTargetTargetTargetTargettarget. FeaturesFeaturesFeaturesFeaturesFeaturesfeatures is the feature vector of the sample, and consequently must be a real vector of length NumInput, as specified in create_class_mlpcreate_class_mlpCreateClassMlpcreate_class_mlpCreateClassMlpCreateClassMlp. TargetTargetTargetTargetTargettarget is the target vector of the sample, which must have the length NumOutput (see create_class_mlpcreate_class_mlpCreateClassMlpcreate_class_mlpCreateClassMlpCreateClassMlp) for all three types of activation functions of the MLP (exception: see below). If the MLP is used for regression (function approximation), i.e., if OutputFunction = 'linear'"linear""linear""linear""linear""linear", TargetTargetTargetTargetTargettarget is the value of the function at the coordinate FeaturesFeaturesFeaturesFeaturesFeaturesfeatures. In this case, TargetTargetTargetTargetTargettarget can contain arbitrary real numbers. For OutputFunction = 'logistic'"logistic""logistic""logistic""logistic""logistic", TargetTargetTargetTargetTargettarget can only contain the values 0.0 and 1.0. A value of 1.0 specifies that the attribute in question is present, while a value of 0.0 specifies that the attribute is absent. Because in this case the attributes are independent, arbitrary combinations of 0.0 and 1.0 can be passed. For OutputFunction = 'softmax'"softmax""softmax""softmax""softmax""softmax", TargetTargetTargetTargetTargettarget also can only contain the values 0.0 and 1.0. In contrast to OutputFunction = 'logistic'"logistic""logistic""logistic""logistic""logistic", the value 1.0 must be present for exactly one element of the tuple TargetTargetTargetTargetTargettarget. The location in the tuple designates the class of the sample. For ease of use, a single integer value may be passed if OutputFunction = 'softmax'"softmax""softmax""softmax""softmax""softmax". This value directly designates the class of the sample, which is counted from 0, i.e., the class must be an integer between 0 and NumOutput - 1. The class is converted to a target vector of length NumOutput internally.

Before the MLP can be trained with train_class_mlptrain_class_mlpTrainClassMlptrain_class_mlpTrainClassMlpTrainClassMlp, all training samples must be added to the MLP with add_sample_class_mlpadd_sample_class_mlpAddSampleClassMlpadd_sample_class_mlpAddSampleClassMlpAddSampleClassMlp.

The number of currently stored training samples can be queried with get_sample_num_class_mlpget_sample_num_class_mlpGetSampleNumClassMlpget_sample_num_class_mlpGetSampleNumClassMlpGetSampleNumClassMlp. Stored training samples can be read out again with get_sample_class_mlpget_sample_class_mlpGetSampleClassMlpget_sample_class_mlpGetSampleClassMlpGetSampleClassMlp.

Normally, it is useful to save the training samples in a file with write_samples_class_mlpwrite_samples_class_mlpWriteSamplesClassMlpwrite_samples_class_mlpWriteSamplesClassMlpWriteSamplesClassMlp to facilitate reusing the samples, and to facilitate that, if necessary, new training samples can be added to the data set, and hence to facilitate that a newly created MLP can be trained anew with the extended data set.

Parallelization

This operator modifies the state of the following input parameter:

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

MLPHandleMLPHandleMLPHandleMLPHandleMLPHandleMLPHandle (input_control, state is modified)  class_mlp HClassMlp, HTupleHTupleHClassMlp, HTupleHClassMlpX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

MLP handle.

FeaturesFeaturesFeaturesFeaturesFeaturesfeatures (input_control)  real-array HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Feature vector of the training sample to be stored.

TargetTargetTargetTargetTargettarget (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

Class or target vector of the training sample to be stored.

Result

If the parameters are valid, the operator add_sample_class_mlpadd_sample_class_mlpAddSampleClassMlpadd_sample_class_mlpAddSampleClassMlpAddSampleClassMlp returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

create_class_mlpcreate_class_mlpCreateClassMlpcreate_class_mlpCreateClassMlpCreateClassMlp

Possible Successors

train_class_mlptrain_class_mlpTrainClassMlptrain_class_mlpTrainClassMlpTrainClassMlp, write_samples_class_mlpwrite_samples_class_mlpWriteSamplesClassMlpwrite_samples_class_mlpWriteSamplesClassMlpWriteSamplesClassMlp

Alternatives

read_samples_class_mlpread_samples_class_mlpReadSamplesClassMlpread_samples_class_mlpReadSamplesClassMlpReadSamplesClassMlp

See also

clear_samples_class_mlpclear_samples_class_mlpClearSamplesClassMlpclear_samples_class_mlpClearSamplesClassMlpClearSamplesClassMlp, get_sample_num_class_mlpget_sample_num_class_mlpGetSampleNumClassMlpget_sample_num_class_mlpGetSampleNumClassMlpGetSampleNumClassMlp, get_sample_class_mlpget_sample_class_mlpGetSampleClassMlpget_sample_class_mlpGetSampleClassMlpGetSampleClassMlp

Module

Foundation


ClassesClassesClassesClasses | | | | Operators