Operator Reference

HALCON Operator Reference / Classification / Neural Nets

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

read_samples_class_mlpT_read_samples_class_mlpReadSamplesClassMlpReadSamplesClassMlpread_samples_class_mlp (Operator)

read_samples_class_mlpT_read_samples_class_mlpReadSamplesClassMlpReadSamplesClassMlpread_samples_class_mlp — Read the training data of a multilayer perceptron from a file.

Signature

read_samples_class_mlp( : : MLPHandle, FileName : )

Herror T_read_samples_class_mlp(const Htuple MLPHandle, const Htuple FileName)

void ReadSamplesClassMlp(const HTuple& MLPHandle, const HTuple& FileName)

void HClassMlp::ReadSamplesClassMlp(const HString& FileName) const

void HClassMlp::ReadSamplesClassMlp(const char* FileName) const

void HClassMlp::ReadSamplesClassMlp(const wchar_t* FileName) const   ( Windows only)

static void HOperatorSet.ReadSamplesClassMlp(HTuple MLPHandle, HTuple fileName)

void HClassMlp.ReadSamplesClassMlp(string fileName)

def read_samples_class_mlp(mlphandle: HHandle, file_name: str) -> None

Description

read_samples_class_mlpread_samples_class_mlpReadSamplesClassMlpReadSamplesClassMlpread_samples_class_mlp reads training samples from the file given by FileNameFileNameFileNamefileNamefile_name and adds them to the training samples that have already been added to the multilayer perceptron (MLP) given by MLPHandleMLPHandleMLPHandleMLPHandlemlphandle. The MLP must be created with create_class_mlpcreate_class_mlpCreateClassMlpCreateClassMlpcreate_class_mlp before calling read_samples_class_mlpread_samples_class_mlpReadSamplesClassMlpReadSamplesClassMlpread_samples_class_mlp. As described with train_class_mlptrain_class_mlpTrainClassMlpTrainClassMlptrain_class_mlp and write_samples_class_mlpwrite_samples_class_mlpWriteSamplesClassMlpWriteSamplesClassMlpwrite_samples_class_mlp, the operators read_samples_class_mlpread_samples_class_mlpReadSamplesClassMlpReadSamplesClassMlpread_samples_class_mlp, add_sample_class_mlpadd_sample_class_mlpAddSampleClassMlpAddSampleClassMlpadd_sample_class_mlp, and write_samples_class_mlpwrite_samples_class_mlpWriteSamplesClassMlpWriteSamplesClassMlpwrite_samples_class_mlp can be used to build up a extensive set of training samples, and hence to improve the performance of the MLP by retraining the MLP with extended data sets.

It should be noted that the training samples must have the correct dimensionality. The feature vectors and target vectors stored in FileNameFileNameFileNamefileNamefile_name must have the lengths NumInputNumInputNumInputnumInputnum_input and NumOutputNumOutputNumOutputnumOutputnum_output that were specified with create_class_mlpcreate_class_mlpCreateClassMlpCreateClassMlpcreate_class_mlp. If this is not the case an error message is returned.

Execution Information

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

This operator modifies the state of the following input parameter:

• MLPHandleMLPHandleMLPHandleMLPHandlemlphandle

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

MLPHandleMLPHandleMLPHandleMLPHandlemlphandle (input_control, state is modified)  class_mlp → HClassMlp, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

MLP handle.

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

File name.

Result

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

Possible Predecessors

create_class_mlpcreate_class_mlpCreateClassMlpCreateClassMlpcreate_class_mlp

Possible Successors

train_class_mlptrain_class_mlpTrainClassMlpTrainClassMlptrain_class_mlp

Alternatives

add_sample_class_mlpadd_sample_class_mlpAddSampleClassMlpAddSampleClassMlpadd_sample_class_mlp

See also

write_samples_class_mlpwrite_samples_class_mlpWriteSamplesClassMlpWriteSamplesClassMlpwrite_samples_class_mlp, clear_samples_class_mlpclear_samples_class_mlpClearSamplesClassMlpClearSamplesClassMlpclear_samples_class_mlp

Module

Foundation

---

ClassesClasses | | Operators