Back to FabImage Studio website

You are here: Start » Filter Reference » Optical Character Recognition Deprecated » RecognizeCharacters_MLP_Deprecated

RecognizeCharacters_MLP_Deprecated


Classifies input regions into characters. Based on the Multi-Layer Perceptron model.

Name Type Range Description
inCharacterRegions RegionArray Array of character regions to recognize
inOcrModel OcrMlpModel Trained OcrMlpModel used to recognize characters
inCharacterSize Size* Size of single monospaced character if needed
inDotPrint Bool Dot-printed characters preprocessing
inCharacterSorting CharacterSortingOrder Sorting order of input characters
inMinScore Real* 0.0 - 1.0 Minimal value of accepted result. Otherwise char '*' will be placed.
inMinSpaceWidth Integer* 0 - Minimal distance between characters where space character will be inserted
outCharacters String Result of characters recognition
outScores RealArray Classification result score
outCandidates OcrCandidateArrayArray Array of a character classification results and their score
diagNormalizedCharacters ImageArray Images of normalized characters used in character recognition
diagCharactersBoxes BoxArray Bounding boxes of characters

Applications

Usually the last, yet the most important step of optical character recognition or verification.

Description

The operation recognizes characters from given regions using trained OcrMlpModel.

This operation requires trained MLP classifier provided in the inOcrModel input. For further details about creating and learning fonts please refer to the documentation of filters InitOcr_MLP_Deprecated and TrainOcr_MLP_Deprecated.

Filter requires regions specified in the inCharacterRegions. Each of the input region must contain single character. To separate characters in the region use SplitRegionIntoExactlyNCharacters or SplitRegionIntoMultipleCharacters.

The inCharacterSorting parameter defines the sorting order of the input characters provided in inCharacterRegions.

The parameter inDotPrint turns on the dedicated smoothing for characters printed using jet printer in dot-matrix form.

The parameter inCharacterSize defines size of monospaced (fixed-width) font. If the parameter is set to auto character will be recognized as proportional font. For further information about font types please refer to the documentation of filter TrainOcr_MLP_Deprecated.

The input inMinSpaceWidth value indicates minimal distance between characters where space character will be inserted to result string. When the value is marked as auto no spaces will be inserted.

The output outCharacters contains recognized characters. The recognition score of each recognized character is stored in the outScores.

Remarks

To read more about how to use OCR technique, refer to Machine Vision Guide: Optical Character Recognition

Errors

This filter can throw an exception to report error. Read how to deal with errors here: Error Handling

Error type Description
DomainError Invalid OcrMlpModel in RecognizeCharacters_MLP.
DomainError Uninitialized OcrMlpModel in RecognizeCharacters_MLP

Complexity Level

This filter is available on Basic Complexity Level.

See Also