Operator Reference

HALCON Operator Reference / Classification / K-Nearest Neighbors
ClassesClasses | | Operators

deserialize_class_knnT_deserialize_class_knnDeserializeClassKnnDeserializeClassKnndeserialize_class_knn (Operator)

deserialize_class_knnT_deserialize_class_knnDeserializeClassKnnDeserializeClassKnndeserialize_class_knn — Deserialize a serialized k-NN classifier.

Signature

deserialize_class_knn( : : SerializedItemHandle : KNNHandle)

Herror T_deserialize_class_knn(const Htuple SerializedItemHandle, Htuple* KNNHandle)

void DeserializeClassKnn(const HTuple& SerializedItemHandle, HTuple* KNNHandle)

void HClassKnn::DeserializeClassKnn(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeClassKnn(HTuple serializedItemHandle, out HTuple KNNHandle)

void HClassKnn.DeserializeClassKnn(HSerializedItem serializedItemHandle)

def deserialize_class_knn(serialized_item_handle: HHandle) -> HHandle

Description

deserialize_class_knndeserialize_class_knnDeserializeClassKnnDeserializeClassKnndeserialize_class_knn deserializes a k-NN classifier (k-NN) (including its training samples), that was serialized by serialize_class_knnserialize_class_knnSerializeClassKnnSerializeClassKnnserialize_class_knn (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized k-NN classifier is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created k-NN classifier with the handle KNNHandleKNNHandleKNNHandleKNNHandleknnhandle.

Execution Information

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

Parameters

SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control)  serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

KNNHandleKNNHandleKNNHandleKNNHandleknnhandle (output_control)  class_knn → HClassKnn, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the k-NN classifier.

Result

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

Possible Predecessors

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item, serialize_class_knnserialize_class_knnSerializeClassKnnSerializeClassKnnserialize_class_knn

Possible Successors

classify_class_knnclassify_class_knnClassifyClassKnnClassifyClassKnnclassify_class_knn

Alternatives

serialize_class_knnserialize_class_knnSerializeClassKnnSerializeClassKnnserialize_class_knn

See also

create_class_knncreate_class_knnCreateClassKnnCreateClassKnncreate_class_knn

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

ClassesClasses | | Operators