read_sampsetT_read_sampsetReadSampsetReadSampsetread_sampset (Operator)

Name

read_sampsetT_read_sampsetReadSampsetReadSampsetread_sampset — Read a training data set from a file.

Warning

read_sampsetread_sampsetReadSampsetReadSampsetReadSampsetread_sampset is obsolete and is only provided for reasons of backward compatibility. New applications should use the MLP, SVM, KNN or GMM operators instead.

Signature

read_sampset( : : FileName : SampKey)

Description

The training examples are accessible with the key SampKeySampKeySampKeySampKeysampKeysamp_key by calling the operators clear_sampsetclear_sampsetClearSampsetClearSampsetClearSampsetclear_sampset and learn_sampset_boxlearn_sampset_boxLearnSampsetBoxLearnSampsetBoxLearnSampsetBoxlearn_sampset_box. You may edit the file using an editor. Every row contains an array of attributes with corresponding class. An example for a format might be:

(1.0, 25.3, * , 17 | 3) This row specifies an array of attributes which belong to class 3. In this array the third attribute is unknown. Attributes upwards 5 are supposed to be unknown, too. You may insert comments like /* .. */ in any place.

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 returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → (string)

Filename of the data set to train.

Default value: 'sampset1' "sampset1" "sampset1" "sampset1" "sampset1" "sampset1"

SampKeySampKeySampKeySampKeysampKeysamp_key (output_control) feature_set → (handle)

Identification of the data set to train.

Result

read_sampsetread_sampsetReadSampsetReadSampsetReadSampsetread_sampset returns TRUE. An exception is raised if it is not possible to open the file or it contains syntax errors or there is not enough memory.

Possible Predecessors

create_class_boxcreate_class_boxCreateClassBoxCreateClassBoxCreateClassBoxcreate_class_box

Possible Successors

test_sampset_boxtest_sampset_boxTestSampsetBoxTestSampsetBoxTestSampsetBoxtest_sampset_box, enquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBoxEnquireClassBoxenquire_class_box, write_class_boxwrite_class_boxWriteClassBoxWriteClassBoxWriteClassBoxwrite_class_box, close_class_boxclose_class_boxCloseClassBoxCloseClassBoxCloseClassBoxclose_class_box, clear_sampsetclear_sampsetClearSampsetClearSampsetClearSampsetclear_sampset

Module

Foundation

Operators