Operator Reference

HALCON Operator Reference / Classification / Misc
ClassesClasses | | Operators

add_sample_class_train_dataT_add_sample_class_train_dataAddSampleClassTrainDataAddSampleClassTrainDataadd_sample_class_train_data (Operator)

add_sample_class_train_dataT_add_sample_class_train_dataAddSampleClassTrainDataAddSampleClassTrainDataadd_sample_class_train_data — Add a training sample to training data.

Signature

add_sample_class_train_data( : : ClassTrainDataHandle, Order, Features, ClassID : )

Herror T_add_sample_class_train_data(const Htuple ClassTrainDataHandle, const Htuple Order, const Htuple Features, const Htuple ClassID)

void AddSampleClassTrainData(const HTuple& ClassTrainDataHandle, const HTuple& Order, const HTuple& Features, const HTuple& ClassID)

void HClassTrainData::AddSampleClassTrainData(const HString& Order, const HTuple& Features, const HTuple& ClassID) const

void HClassTrainData::AddSampleClassTrainData(const char* Order, const HTuple& Features, const HTuple& ClassID) const

void HClassTrainData::AddSampleClassTrainData(const wchar_t* Order, const HTuple& Features, const HTuple& ClassID) const   ( Windows only)

static void HOperatorSet.AddSampleClassTrainData(HTuple classTrainDataHandle, HTuple order, HTuple features, HTuple classID)

void HClassTrainData.AddSampleClassTrainData(string order, HTuple features, HTuple classID)

def add_sample_class_train_data(class_train_data_handle: HHandle, order: str, features: Sequence[float], class_id: Sequence[int]) -> None

Description

add_sample_class_train_dataadd_sample_class_train_dataAddSampleClassTrainDataAddSampleClassTrainDataadd_sample_class_train_data adds a training sample to the training data given by ClassTrainDataHandleClassTrainDataHandleClassTrainDataHandleclassTrainDataHandleclass_train_data_handle. The training sample is given by FeaturesFeaturesFeaturesfeaturesfeatures and ClassIDClassIDClassIDclassIDclass_id. FeaturesFeaturesFeaturesfeaturesfeatures is the feature vector of the sample, and consequently must be a real vector of length NumDimNumDimNumDimnumDimnum_dim, as specified in create_class_train_datacreate_class_train_dataCreateClassTrainDataCreateClassTrainDatacreate_class_train_data. ClassIDClassIDClassIDclassIDclass_id is the class of the sample. More than one training sample can be added at once. In this case the parameter OrderOrderOrderorderorder defines in which order the elements of the feature vectors are passed in FeaturesFeaturesFeaturesfeaturesfeatures. If it is set to 'row'"row""row""row""row", the first training sample comes first, the second comes second, and so on. If it is set to 'column'"column""column""column""column", the first dimension of all feature vectors comes first, and then the second dimension of all feature vectors, and so on. The third possible mode for OrderOrderOrderorderorder is 'feature_column'"feature_column""feature_column""feature_column""feature_column". This mode expects features which were grouped before with set_feature_lengths_class_train_dataset_feature_lengths_class_train_dataSetFeatureLengthsClassTrainDataSetFeatureLengthsClassTrainDataset_feature_lengths_class_train_data to come completely and row-wise before the second feature, and so on.

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:

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

Parameters

ClassTrainDataHandleClassTrainDataHandleClassTrainDataHandleclassTrainDataHandleclass_train_data_handle (input_control, state is modified)  class_train_data → HClassTrainData, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the training data.

OrderOrderOrderorderorder (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

The order of the feature vector.

Default: 'row' "row" "row" "row" "row"

List of values: 'column'"column""column""column""column", 'feature_column'"feature_column""feature_column""feature_column""feature_column", 'row'"row""row""row""row"

FeaturesFeaturesFeaturesfeaturesfeatures (input_control)  number-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Feature vector of the training sample.

ClassIDClassIDClassIDclassIDclass_id (input_control)  integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Class of the training sample.

Result

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

Possible Predecessors

create_class_train_datacreate_class_train_dataCreateClassTrainDataCreateClassTrainDatacreate_class_train_data

Possible Successors

add_class_train_data_svmadd_class_train_data_svmAddClassTrainDataSvmAddClassTrainDataSvmadd_class_train_data_svm, add_class_train_data_knnadd_class_train_data_knnAddClassTrainDataKnnAddClassTrainDataKnnadd_class_train_data_knn, add_class_train_data_gmmadd_class_train_data_gmmAddClassTrainDataGmmAddClassTrainDataGmmadd_class_train_data_gmm, add_class_train_data_mlpadd_class_train_data_mlpAddClassTrainDataMlpAddClassTrainDataMlpadd_class_train_data_mlp

See also

create_class_train_datacreate_class_train_dataCreateClassTrainDataCreateClassTrainDatacreate_class_train_data

Module

Foundation

ClassesClasses | | Operators