Operator Reference

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

serialize_class_knnT_serialize_class_knnSerializeClassKnnSerializeClassKnnserialize_class_knn (Operator)

serialize_class_knnT_serialize_class_knnSerializeClassKnnSerializeClassKnnserialize_class_knn — Serialize a k-NN classifier.

Signature

serialize_class_knn( : : KNNHandle : SerializedItemHandle)

Herror T_serialize_class_knn(const Htuple KNNHandle, Htuple* SerializedItemHandle)

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

HSerializedItem HClassKnn::SerializeClassKnn() const

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

HSerializedItem HClassKnn.SerializeClassKnn()

def serialize_class_knn(knnhandle: HHandle) -> HHandle

Description

serialize_class_knnserialize_class_knnSerializeClassKnnSerializeClassKnnserialize_class_knn serializes a k-NN classifier (k-NN) and its stored training samples (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The same data that is written in a file by write_class_knnwrite_class_knnWriteClassKnnWriteClassKnnwrite_class_knn is converted to a serialized item. The k-NN classifier is defined by the handle KNNHandleKNNHandleKNNHandleKNNHandleknnhandle. The serialized k-NN classifier is returned by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle and can be deserialized by deserialize_class_knndeserialize_class_knnDeserializeClassKnnDeserializeClassKnndeserialize_class_knn.

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

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

Handle of the k-NN classifier.

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

Handle of the serialized item.

Result

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

Possible Predecessors

train_class_knntrain_class_knnTrainClassKnnTrainClassKnntrain_class_knn, read_class_knnread_class_knnReadClassKnnReadClassKnnread_class_knn

Possible Successors

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item, deserialize_class_knndeserialize_class_knnDeserializeClassKnnDeserializeClassKnndeserialize_class_knn

See also

create_class_knncreate_class_knnCreateClassKnnCreateClassKnncreate_class_knn, read_class_knnread_class_knnReadClassKnnReadClassKnnread_class_knn, deserialize_class_knndeserialize_class_knnDeserializeClassKnnDeserializeClassKnndeserialize_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