do_ocr_single_class_knnT_do_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnndo_ocr_single_class_knn (Operator)
Name
do_ocr_single_class_knnT_do_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnndo_ocr_single_class_knn — Klassifikation eines Zeichens mit einem OCR-Klassifikator.
Signatur
void DoOcrSingleClassKnn(const HObject& Character, const HObject& Image, const HTuple& OCRHandle, const HTuple& NumClasses, const HTuple& NumNeighbors, HTuple* Class, HTuple* Confidence)
HTuple HRegion::DoOcrSingleClassKnn(const HImage& Image, const HOCRKnn& OCRHandle, const HTuple& NumClasses, const HTuple& NumNeighbors, HTuple* Confidence) const
HString HRegion::DoOcrSingleClassKnn(const HImage& Image, const HOCRKnn& OCRHandle, const HTuple& NumClasses, const HTuple& NumNeighbors, double* Confidence) const
HTuple HOCRKnn::DoOcrSingleClassKnn(const HRegion& Character, const HImage& Image, const HTuple& NumClasses, const HTuple& NumNeighbors, HTuple* Confidence) const
HString HOCRKnn::DoOcrSingleClassKnn(const HRegion& Character, const HImage& Image, const HTuple& NumClasses, const HTuple& NumNeighbors, double* Confidence) const
static void HOperatorSet.DoOcrSingleClassKnn(HObject character, HObject image, HTuple OCRHandle, HTuple numClasses, HTuple numNeighbors, out HTuple classVal, out HTuple confidence)
HTuple HRegion.DoOcrSingleClassKnn(HImage image, HOCRKnn OCRHandle, HTuple numClasses, HTuple numNeighbors, out HTuple confidence)
string HRegion.DoOcrSingleClassKnn(HImage image, HOCRKnn OCRHandle, HTuple numClasses, HTuple numNeighbors, out double confidence)
HTuple HOCRKnn.DoOcrSingleClassKnn(HRegion character, HImage image, HTuple numClasses, HTuple numNeighbors, out HTuple confidence)
string HOCRKnn.DoOcrSingleClassKnn(HRegion character, HImage image, HTuple numClasses, HTuple numNeighbors, out double confidence)
def do_ocr_single_class_knn(character: HObject, image: HObject, ocrhandle: HHandle, num_classes: Sequence[int], num_neighbors: Sequence[int]) -> Tuple[Sequence[str], Sequence[float]]
def do_ocr_single_class_knn_s(character: HObject, image: HObject, ocrhandle: HHandle, num_classes: Sequence[int], num_neighbors: Sequence[int]) -> Tuple[str, float]
Beschreibung
do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnnDoOcrSingleClassKnndo_ocr_single_class_knn berechnet mit dem durch
OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleocrhandle gegebenen k-NN-Klassifikator zu den Eigenschaften
des durch die Region CharacterCharacterCharacterCharactercharactercharacter und die Grauwerte ImageImageImageImageimageimage
gegebenen Zeichens die NumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighborsnum_neighbors besten Trainingsbeispiele und
gibt deren Klassen in ClassClassClassClassclassValclass und die zugehörigen Konfidenzen
in ConfidenceConfidenceConfidenceConfidenceconfidenceconfidence zurück.
Gehören die ersten
NumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighborsnum_neighbors Trainingsbeispiele zu verschiedenen Klassen, werden
maximal NumClassesNumClassesNumClassesNumClassesnumClassesnum_classes 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 NumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighborsnum_neighbors 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_knnDoOcrMultiClassKnnDoOcrMultiClassKnnDoOcrMultiClassKnndo_ocr_multi_class_knn verwendet werden.
Vor dem Aufruf von do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnnDoOcrSingleClassKnndo_ocr_single_class_knn sollte
der OCR-Klassifikator bereits mit trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnnTrainfOcrClassKnntrainf_ocr_class_knn oder
select_feature_set_trainf_knnselect_feature_set_trainf_knnSelectFeatureSetTrainfKnnSelectFeatureSetTrainfKnnSelectFeatureSetTrainfKnnselect_feature_set_trainf_knn trainiert worden sein.
Wenn nur eine Klasse unter den nächsten NumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighborsnum_neighbors
Nachbarn ist, wird auch nur eine Klasse zurückgegeben.
Ausführungsinformationen
- 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 → objectHRegionHObjectHRegionHobject
Zu erkennendes Zeichen.
ImageImageImageImageimageimage (input_object) singlechannelimage → objectHImageHObjectHImageHobject (byte / uint2)
Grauwerte des Zeichens.
OCRHandleOCRHandleOCRHandleOCRHandleOCRHandleocrhandle (input_control) ocr_knn → HOCRKnn, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des OCR-Klassifikators.
NumClassesNumClassesNumClassesNumClassesnumClassesnum_classes (input_control) integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Anzahl der maximal zu bestimmenden besten Klassen.
Defaultwert: 1
Wertevorschläge: 1, 2, 3, 4, 5
NumNeighborsNumNeighborsNumNeighborsNumNeighborsnumNeighborsnum_neighbors (input_control) integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Anzahl der zu bestimmenden nächsten Nachbarn.
Defaultwert: 1
Wertevorschläge: 1, 2, 3, 4, 5
ClassClassClassClassclassValclass (output_control) string(-array) → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Ergebnis der Klassifikation des Zeichens durch
das k-NN.
ConfidenceConfidenceConfidenceConfidenceconfidenceconfidence (output_control) real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Konfidenz(en) der Klasse(n).
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
do_ocr_single_class_knndo_ocr_single_class_knnDoOcrSingleClassKnnDoOcrSingleClassKnnDoOcrSingleClassKnndo_ocr_single_class_knn den Wert TRUE. Gegebenenfalls wird
eine Fehlerbehandlung durchgeführt.
Vorgänger
trainf_ocr_class_knntrainf_ocr_class_knnTrainfOcrClassKnnTrainfOcrClassKnnTrainfOcrClassKnntrainf_ocr_class_knn,
read_ocr_class_knnread_ocr_class_knnReadOcrClassKnnReadOcrClassKnnReadOcrClassKnnread_ocr_class_knn
Alternativen
do_ocr_multi_class_knndo_ocr_multi_class_knnDoOcrMultiClassKnnDoOcrMultiClassKnnDoOcrMultiClassKnndo_ocr_multi_class_knn
Siehe auch
create_ocr_class_knncreate_ocr_class_knnCreateOcrClassKnnCreateOcrClassKnnCreateOcrClassKnncreate_ocr_class_knn,
classify_class_knnclassify_class_knnClassifyClassKnnClassifyClassKnnClassifyClassKnnclassify_class_knn
Modul
OCR/OCV