do_ocr_single_class_knnT_do_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn (Operator)

Name

do_ocr_single_class_knnT_do_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn — Klassifikation eines Zeichens mit einem OCR-Klassifikator.

Signatur

do_ocr_single_class_knn(Character, Image : : OCRHandle, NumClasses, NumNeighbors : Class, Confidence)

Beschreibung

do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn berechnet mit dem durch OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleOCRHandle gegebenen k-NN-Klassifikator zu den Eigenschaften des durch die Region CharacterCharacterCharacterCharacterCharactercharacter und die Grauwerte ImageImageImageImageImageimage gegebenen Zeichens die NumNeighborsNumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighbors besten Trainingsbeispiele und gibt deren Klassen in ClassClassClassClassClassclassVal und die zugehörigen Konfidenzen in ConfidenceConfidenceConfidenceConfidenceConfidenceconfidence zurück. Gehören die ersten NumNeighborsNumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighbors Trainingsbeispiele zu verschiedenen Klassen, werden maximal NumClassesNumClassesNumClassesNumClassesNumClassesnumClasses Klassen sortiert nach Häufigkeit und gewichteter Distanz zurückgegeben. Die Konfidenzen liegen zwischen 0.0 und 1.0. Je höher der Wert, desto sicherer ist die Klassifikation. Die Konfidenzen können nur robust ermittelt werden, wenn NumNeighborsNumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighbors ausreichend groß ist.

Da potentiell mehrere Klassen zurückgeliefert werden können, darf CharacterCharacterCharacterCharacterCharactercharacter nur eine Region (ein Zeichen) enthalten. Falls mehrere Zeichen in einem Aufruf klassifiziert werden sollen, muss do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn verwendet werden. Vor dem Aufruf von do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn sollte der OCR-Klassifikator bereits mit trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnn oder select_feature_set_trainf_knnselect_feature_set_trainf_knnSelectFeatureSetTrainfKnnselect_feature_set_trainf_knnSelectFeatureSetTrainfKnnSelectFeatureSetTrainfKnn trainiert worden sein. Wenn nur eine Klasse unter den nächsten NumNeighborsNumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighbors Nachbarn ist, wird auch nur eine Klasse zurückgegeben.

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

CharacterCharacterCharacterCharacterCharactercharacter (input_object) region → object

Zu erkennendes Zeichen.

ImageImageImageImageImageimage (input_object) singlechannelimage → object (byte / uint2)

Grauwerte des Zeichens.

OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleOCRHandle (input_control) ocr_knn → (integer)

Handle des OCR-Klassifikators.

NumClassesNumClassesNumClassesNumClassesNumClassesnumClasses (input_control) integer-array → (integer)

Anzahl der maximal zu bestimmenden besten Klassen.

Defaultwert: 1

Wertevorschläge: 1, 2, 3, 4, 5

NumNeighborsNumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighbors (input_control) integer-array → (integer)

Anzahl der zu bestimmenden nächsten Nachbarn.

Defaultwert: 1

Wertevorschläge: 1, 2, 3, 4, 5

ClassClassClassClassClassclassVal (output_control) string(-array) → (string)

Ergebnis der Klassifikation des Zeichens durch das k-NN.

ConfidenceConfidenceConfidenceConfidenceConfidenceconfidence (output_control) real(-array) → (real)

Konfidenz(en) der Klasse(n).

Sind die Parameterwerte korrekt, dann liefert do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnn den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnn, read_ocr_class_knnread_ocr_class_knnReadOcrClassKnnread_ocr_class_knnReadOcrClassKnnReadOcrClassKnn

Alternativen

do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnn

Siehe auch

create_ocr_class_knncreate_ocr_class_knnCreateOcrClassKnncreate_ocr_class_knnCreateOcrClassKnnCreateOcrClassKnn, classify_class_knnclassify_class_knnClassifyClassKnnclassify_class_knnClassifyClassKnnClassifyClassKnn

Modul

OCR/OCV

Operatoren