Operator Reference

HALCON Operator Reference / Legacy / Classification

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

ClassesClasses | | Operators

read_sampsetT_read_sampsetReadSampsetReadSampsetread_sampset (Operator)

read_sampsetT_read_sampsetReadSampsetReadSampsetread_sampset — Read a training data set from a file.

Warning

read_sampsetread_sampsetReadSampsetReadSampsetread_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)

Herror T_read_sampset(const Htuple FileName, Htuple* SampKey)

void ReadSampset(const HTuple& FileName, HTuple* SampKey)

void HFeatureSet::HFeatureSet(const HString& FileName)

void HFeatureSet::HFeatureSet(const char* FileName)

void HFeatureSet::HFeatureSet(const wchar_t* FileName)   ( Windows only)

void HFeatureSet::ReadSampset(const HString& FileName)

void HFeatureSet::ReadSampset(const char* FileName)

void HFeatureSet::ReadSampset(const wchar_t* FileName)   ( Windows only)

static void HOperatorSet.ReadSampset(HTuple fileName, out HTuple sampKey)

public HFeatureSet(string fileName)

void HFeatureSet.ReadSampset(string fileName)

def read_sampset(file_name: str) -> HHandle

Description

The training examples are accessible with the key SampKeySampKeySampKeysampKeysamp_key by calling the operators clear_sampsetclear_sampsetClearSampsetClearSampsetclear_sampset and learn_sampset_boxlearn_sampset_boxLearnSampsetBoxLearnSampsetBoxlearn_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

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

Filename of the data set to train.

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

SampKeySampKeySampKeysampKeysamp_key (output_control)  feature_set → HFeatureSet, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Identification of the data set to train.

Result

read_sampsetread_sampsetReadSampsetReadSampsetread_sampset returns 2 ( H_MSG_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_boxCreateClassBoxCreateClassBoxcreate_class_box

Possible Successors

test_sampset_boxtest_sampset_boxTestSampsetBoxTestSampsetBoxtest_sampset_box, enquire_class_boxenquire_class_boxEnquireClassBoxEnquireClassBoxenquire_class_box, write_class_boxwrite_class_boxWriteClassBoxWriteClassBoxwrite_class_box, close_class_boxclose_class_boxCloseClassBoxCloseClassBoxclose_class_box, clear_sampsetclear_sampsetClearSampsetClearSampsetclear_sampset

See also

test_sampset_boxtest_sampset_boxTestSampsetBoxTestSampsetBoxtest_sampset_box, clear_sampsetclear_sampsetClearSampsetClearSampsetclear_sampset, learn_sampset_boxlearn_sampset_boxLearnSampsetBoxLearnSampsetBoxlearn_sampset_box

Module

Foundation

---

ClassesClasses | | Operators