do_ocr_multi_class_cnnT_do_ocr_multi_class_cnnDoOcrMultiClassCnnDoOcrMultiClassCnn (Operator)
Name
do_ocr_multi_class_cnnT_do_ocr_multi_class_cnnDoOcrMultiClassCnnDoOcrMultiClassCnn — Classify multiple characters with an CNN-based OCR classifier.
Signature
void DoOcrMultiClassCnn(const HObject& Character, const HObject& Image, const HTuple& OCRHandle, HTuple* Class, HTuple* Confidence)
HTuple HRegion::DoOcrMultiClassCnn(const HImage& Image, const HOCRCnn& OCRHandle, HTuple* Confidence) const
HString HRegion::DoOcrMultiClassCnn(const HImage& Image, const HOCRCnn& OCRHandle, double* Confidence) const
HTuple HOCRCnn::DoOcrMultiClassCnn(const HRegion& Character, const HImage& Image, HTuple* Confidence) const
HString HOCRCnn::DoOcrMultiClassCnn(const HRegion& Character, const HImage& Image, double* Confidence) const
static void HOperatorSet.DoOcrMultiClassCnn(HObject character, HObject image, HTuple OCRHandle, out HTuple classVal, out HTuple confidence)
HTuple HRegion.DoOcrMultiClassCnn(HImage image, HOCRCnn OCRHandle, out HTuple confidence)
string HRegion.DoOcrMultiClassCnn(HImage image, HOCRCnn OCRHandle, out double confidence)
HTuple HOCRCnn.DoOcrMultiClassCnn(HRegion character, HImage image, out HTuple confidence)
string HOCRCnn.DoOcrMultiClassCnn(HRegion character, HImage image, out double confidence)
Description
do_ocr_multi_class_cnndo_ocr_multi_class_cnnDoOcrMultiClassCnnDoOcrMultiClassCnnDoOcrMultiClassCnn computes the best class for each of
the characters given by the regions CharacterCharacterCharacterCharactercharacter and the gray
values ImageImageImageImageimage with the OCR classifier OCRHandleOCRHandleOCRHandleOCRHandleOCRHandle and
returns the classes in ClassClassClassClassclassVal and the corresponding
confidences (probabilities) of the classes in ConfidenceConfidenceConfidenceConfidenceconfidence.
In contrast to do_ocr_single_class_cnndo_ocr_single_class_cnnDoOcrSingleClassCnnDoOcrSingleClassCnnDoOcrSingleClassCnn,
do_ocr_multi_class_cnndo_ocr_multi_class_cnnDoOcrMultiClassCnnDoOcrMultiClassCnnDoOcrMultiClassCnn can classify multiple characters in
one call, and therefore typically is faster than a loop that uses
do_ocr_single_class_cnndo_ocr_single_class_cnnDoOcrSingleClassCnnDoOcrSingleClassCnnDoOcrSingleClassCnn to classify single characters.
However, do_ocr_multi_class_cnndo_ocr_multi_class_cnnDoOcrMultiClassCnnDoOcrMultiClassCnnDoOcrMultiClassCnn can only return the best
class of each character. Because the confidences can be interpreted as
probabilities, it is easier to check whether a character has been
classified with too much uncertainty. This is usually not a disadvantage,
except in cases where the classes overlap so much that in many cases the
second best class must be examined to be able to decide the class of the
character. In these cases, do_ocr_single_class_cnndo_ocr_single_class_cnnDoOcrSingleClassCnnDoOcrSingleClassCnnDoOcrSingleClassCnn should be used.
The result '\x1A'"\x1A""\x1A""\x1A""\x1A" in
ClassClassClassClassclassVal signifies that the region has been classified as rejection
class.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on internal data level.
Parameters
CharacterCharacterCharacterCharactercharacter (input_object) region(-array) → objectHRegionHRegionHobject
Characters to be recognized.
ImageImageImageImageimage (input_object) singlechannelimage → objectHImageHImageHobject (byte / uint2)
Gray values of the characters.
OCRHandleOCRHandleOCRHandleOCRHandleOCRHandle (input_control) ocr_cnn → HOCRCnn, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the OCR classifier.
ClassClassClassClassclassVal (output_control) string(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)
Result of classifying the characters with the
CNN.
Number of elements: Class == Character
ConfidenceConfidenceConfidenceConfidenceconfidence (output_control) real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)
Confidence of the class of the characters.
Number of elements: Confidence == Character
Result
If the parameters are valid, the operator
do_ocr_multi_class_cnndo_ocr_multi_class_cnnDoOcrMultiClassCnnDoOcrMultiClassCnnDoOcrMultiClassCnn returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.
Possible Predecessors
read_ocr_class_cnnread_ocr_class_cnnReadOcrClassCnnReadOcrClassCnnReadOcrClassCnn
Alternatives
do_ocr_word_cnndo_ocr_word_cnnDoOcrWordCnnDoOcrWordCnnDoOcrWordCnn,
do_ocr_single_class_cnndo_ocr_single_class_cnnDoOcrSingleClassCnnDoOcrSingleClassCnnDoOcrSingleClassCnn
Module
OCR/OCV