Tess4J

Tess4J Node integrates the Tesseract OCR library into KNIME. You may change the language and Tesseract datapath (path to language files) in the node configuration.

Options

Tessdata Path (*)
If you want to use your own .traineddata tesseract language files, select "Use External" and select the folder which contains those language files.
Language
Tesseract uses languages to help with the optical character recognition. Default is "eng" (English), but there are other languages bundled with this plugin. If you have your own tessdata path defined, languages found in that path will automatically be listed here.
Deskew input images
Some images may not be exactly horizontal, but rather slightly rotated. If this option is checked, the node will undo the rotation. This comes with a slight performance cost, so if you know that the text in your images is perfectly horizontal, be sure to turn this off. If images are slightly rotated, this option is required, since optical character recognition will not work properly otherwise.
Page Segmentation Mode
Define how your page is segmented here. For flow variables use the ID.

Legend: (ID) Name Description

  • (0) OSD Only Orientation and script detection (OSD) only.
  • (1) Auto Pageseg and OSD Automatic page segmentation and OSD.
  • (2) Auto Pageseg Only Automatic page segmentation, no OSD and no OCR.
  • (3) Full Auto Pageseg Fully automatic page segmentation, no OSD.
  • (4) Single Column Assume a single column of text of variable sizes.
  • (5) Single Vert Block Assume a single uniform block of vertically aligned text.
  • (6) Single Block Assume a single uniform block of text. (default)
  • (7) Single Line Treat the image as a single text line.
  • (8) Single Word Treat the image as a single word.
  • (9) Circle Word Treat the image as a single word in a circle.
  • (10) Single Char Treat the image as a single character.
  • (11) Sparse Text Find as much text as possible in no particular order.
  • (12) Sparse Test with OSD Sparse text with OSD.
OCR Engine Mode
Define which OCR engine to use. For flow variables use ID.

Legend: (ID) Name Description

  • (0) Tesseract Only Only use Tesseract. (Fastest)
  • (1) Cube Only Only use Cube. This is slower than "Tesseract Only", but more accurate.
  • (2) Tesseract And Cube Use both of the above and combine results. (Best accuracy)
  • (3) Default Use language specific configuration or "Tesseract Only", if not specified.

Advanced Config

Tesseract Config (*)

This allows defining key/value pairs as user-defined tesseract configuration variables. See (http://www.sk-spell.sk.cx/tesseract-ocr-parameters-in-302-version) for a list.

Advanced users can use this tab to make use of tesseracts flexibility, but may result in unexpected errors, since the variables are not checked for correctness.

The "Import" and "Export" buttons allow you to load and write tesseract configuration files from the list.

Column Selection

Column Creation Mode

Mode how to handle the selected column. The processed column can be added to a new table, appended to the end of the table, or the old column can be replaced by the new result

Column Suffix
A suffix appended to the column name. If "Append" is not selected, it can be left empty.
Column Selection
Selection of the columns to be processed.

Input Ports

Icon
Text as Images.

Output Ports

Icon
OCR Result String

Views

Image Viewer
Another, possibly interactive, view on table cells. Displays the selected cells with their associated viewer if it exists. Available views are:
- Image Viewer
-- This viewer renders the selected image-cell.
- BigDataViewer
-- A viewer shown when the user selects an interval of rows and columns in the viewer. This viewer combines all images and labelings in the selected interval to one image by rendering them next to each other. Alternatively, the images and labelings can be layed over each other.
- Labeling View
-- View on a labeling/segmentation
- Missing Value Viewer
-- An empty viewer that is shown when the input cell has no value to display.
- Histogram Viewer
-- This viewer shows the histogram of the currently selected image.
- XML
-- XML tree
- Combined View
-- A viewer shown when the user selects an interval of rows and columns in the viewer. This viewer combines all images and labelings in the selected interval to one image by rendering them next to each other. Alternatively, the images and labelings can be layed over each other.

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.