HALCON Website / HALCON Operator Reference / Classification / K-Nearest Neighbors
ClassesClassesClassesClasses | | | | Operators

read_class_knnread_class_knnReadClassKnnread_class_knnReadClassKnnReadClassKnn (Operator)

Name

read_class_knnread_class_knnReadClassKnnread_class_knnReadClassKnnReadClassKnn — Read the k-NN classifier from a file.

Signature

read_class_knn( : : FileName : KNNHandle)

Herror read_class_knn(const char* FileName, Hlong* KNNHandle)

Herror T_read_class_knn(const Htuple FileName, Htuple* KNNHandle)

Herror read_class_knn(const HTuple& FileName, Hlong* KNNHandle)

void HClassKnn::ReadClassKnn(const HTuple& FileName)

void ReadClassKnn(const HTuple& FileName, HTuple* KNNHandle)

void HClassKnn::HClassKnn(const HString& FileName)

void HClassKnn::HClassKnn(const char* FileName)

void HClassKnn::ReadClassKnn(const HString& FileName)

void HClassKnn::ReadClassKnn(const char* FileName)

void HOperatorSetX.ReadClassKnn(
[in] VARIANT FileName, [out] VARIANT* KNNHandle)

void HClassKnnX.ReadClassKnn([in] BSTR FileName)

static void HOperatorSet.ReadClassKnn(HTuple fileName, out HTuple KNNHandle)

public HClassKnn(string fileName)

void HClassKnn.ReadClassKnn(string fileName)

Description

read_class_knnread_class_knnReadClassKnnread_class_knnReadClassKnnReadClassKnn reads the saved classifier from the file FileNameFileNameFileNameFileNameFileNamefileName (see write_class_knnwrite_class_knnWriteClassKnnwrite_class_knnWriteClassKnnWriteClassKnn). The values of the current classifier are overwritten. The default HALCON file extension for the k-NN classifier is 'gnc'.

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

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

File name of the classifier.

File extension: .gnc

KNNHandleKNNHandleKNNHandleKNNHandleKNNHandleKNNHandle (output_control)  class_knn → HClassKnn, HTupleHTupleHClassKnn, HTupleHClassKnnX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the k-NN classifier.

Result

read_class_knnread_class_knnReadClassKnnread_class_knnReadClassKnnReadClassKnn returns 2 (H_MSG_TRUE). An exception is raised if it was not possible to open the file FileNameFileNameFileNameFileNameFileNamefileName or the file has the wrong format.

Possible Successors

classify_class_knnclassify_class_knnClassifyClassKnnclassify_class_knnClassifyClassKnnClassifyClassKnn

See also

create_class_knncreate_class_knnCreateClassKnncreate_class_knnCreateClassKnnCreateClassKnn

References

Marius Muja, David G. Lowe: “Fast Approximate Nearest Neighbors with Automatic Algorithm Configuration”; International Conference on Computer Vision Theory and Applications (VISAPP 09); 2009.

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 13.0.4 Copyright © 1996-2019 MVTec Software GmbH