ClassesClasses | | Operators

evaluate_class_mlpT_evaluate_class_mlpEvaluateClassMlpEvaluateClassMlp (Operator)

Name

evaluate_class_mlpT_evaluate_class_mlpEvaluateClassMlpEvaluateClassMlp — Calculate the evaluation of a feature vector by a multilayer perceptron.

Signature

evaluate_class_mlp( : : MLPHandle, Features : Result)

Herror T_evaluate_class_mlp(const Htuple MLPHandle, const Htuple Features, Htuple* Result)

void EvaluateClassMlp(const HTuple& MLPHandle, const HTuple& Features, HTuple* Result)

HTuple HClassMlp::EvaluateClassMlp(const HTuple& Features) const

static void HOperatorSet.EvaluateClassMlp(HTuple MLPHandle, HTuple features, out HTuple result)

HTuple HClassMlp.EvaluateClassMlp(HTuple features)

Description

evaluate_class_mlpevaluate_class_mlpEvaluateClassMlpEvaluateClassMlpEvaluateClassMlp computes the result ResultResultResultResultresult of evaluating the feature vector FeaturesFeaturesFeaturesFeaturesfeatures with the multilayer perceptron (MLP) MLPHandleMLPHandleMLPHandleMLPHandleMLPHandle. The formulas used for the evaluation are described with create_class_mlpcreate_class_mlpCreateClassMlpCreateClassMlpCreateClassMlp. Before calling evaluate_class_mlpevaluate_class_mlpEvaluateClassMlpEvaluateClassMlpEvaluateClassMlp, the MLP must be trained with train_class_mlptrain_class_mlpTrainClassMlpTrainClassMlpTrainClassMlp.

If the MLP is used for regression (function approximation), i.e., if (OutputFunction = 'linear'"linear""linear""linear""linear"), ResultResultResultResultresult is the value of the function at the coordinate FeaturesFeaturesFeaturesFeaturesfeatures. For OutputFunction = 'logistic'"logistic""logistic""logistic""logistic" and 'softmax'"softmax""softmax""softmax""softmax", the values in ResultResultResultResultresult can be interpreted as probabilities. Hence, for OutputFunction = 'logistic'"logistic""logistic""logistic""logistic" the elements of ResultResultResultResultresult represent the probabilities of the presence of the respective independent attributes. Typically, a threshold of 0.5 is used to decide whether the attribute is present or not. Depending on the application, other thresholds may be used as well. For OutputFunction = 'softmax'"softmax""softmax""softmax""softmax" usually the position of the maximum value of ResultResultResultResultresult is interpreted as the class of the feature vector, and the corresponding value as the probability of the class. In this case, classify_class_mlpclassify_class_mlpClassifyClassMlpClassifyClassMlpClassifyClassMlp should be used instead of evaluate_class_mlpevaluate_class_mlpEvaluateClassMlpEvaluateClassMlpEvaluateClassMlp because classify_class_mlpclassify_class_mlpClassifyClassMlpClassifyClassMlpClassifyClassMlp directly returns the class and corresponding probability.

Execution Information

Parameters

MLPHandleMLPHandleMLPHandleMLPHandleMLPHandle (input_control)  class_mlp HClassMlp, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

MLP handle.

FeaturesFeaturesFeaturesFeaturesfeatures (input_control)  real-array HTupleHTupleHtuple (real) (double) (double) (double)

Feature vector.

ResultResultResultResultresult (output_control)  real-array HTupleHTupleHtuple (real) (double) (double) (double)

Result of evaluating the feature vector with the MLP.

Result

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

Possible Predecessors

train_class_mlptrain_class_mlpTrainClassMlpTrainClassMlpTrainClassMlp, read_class_mlpread_class_mlpReadClassMlpReadClassMlpReadClassMlp

Alternatives

classify_class_mlpclassify_class_mlpClassifyClassMlpClassifyClassMlpClassifyClassMlp

See also

create_class_mlpcreate_class_mlpCreateClassMlpCreateClassMlpCreateClassMlp

References

Christopher M. Bishop: “Neural Networks for Pattern Recognition”; Oxford University Press, Oxford; 1995.
Andrew Webb: “Statistical Pattern Recognition”; Arnold, London; 1999.

Module

Foundation


ClassesClasses | | Operators