2023:OCR Profile (Node Type)

From Grooper Wiki
Revision as of 13:35, 6 November 2023 by Rpatton (talk | contribs)
An example of a configured OCR Profile's property settings

An OCR Profile defines the settings for performing OCR.

This includes:

  • Setting which OCR Engine is used
  • Determining whether a temporary IP Profile is used for image cleanup before the OCR engine runs
  • Grooper's unique Synthesis settings
    • Determining if and how multiple OCR results are pre-processed and re-processed
  • If and how results are filtered, to toss out undesirable results.
  • Any configurable settings available from the OCR Engine


Previous Versions

Grooper 2.80

About

At first glance, an OCR profile may look like a wall of properties, and in some ways, it is. They are a way to save a collection of properties that determine how OCR results are obtained. Let's break these properties down, using a configured OCR Profile as an example.

Below you will see one of the default OCR Profiles that ship with Grooper named "Full Text - Accurate", with these settings highlighted in each tab.

OCR - 2023


The OCR Testing Tab

When you select them in the Node Tree, OCR Profiles also contain an "OCR Testing" tab to verify results of the profile. This will pull up a testing module, allowing us to select documents from a Test Batch, OCR individual pages, and view some extra diagnostic information that will help fine tune your property settings.

  1. To access this testing module, first select an OCR Profile in the Node Tree. Here, we've selected the "Full Text - Accurate" OCR Profile that comes with all Grooper installations.
    • You can follow this path in the Node Tree to find this OCR Profile:
    • Root Node > Projects > Essentials > Profiles > Full Text - Accurate
  2. Click the "Tester" tab.
  1. From here, click the Batch selection icon.
  1. Select a Test Batch from the dropdown list. Here, we're selecting a Test Batch named "Application for Cow Ownership".

  1. Click the test icon.
  2. You will see the selected page appear in the "Document Viewer" window.

Once OCR is finished you will see OCR results appear in the "Layout View" tab in the bottom of the screen. You can look at the "Text View" or "Character View" by selecting the corresponding tabs.

  1. After testing the OCR, you can click the "Diagnostics" icon to take a look at the diagnostic tools available.

  1. The "Diagnostics" window that opens in a new tab provides a variety of diagnostics images just as the "IP Image" selected here. This shows you the pre-processed version of this page handed to the OCR engine (as altered by the IP Profile set on the OCR Profile).

As you can see here, this diagnostic image does not contain any table lines, whereas the actual page does. This table lines were removed temporarily by a Line Removal step in the IP Profile (a very common temporary image processing adjustment to improve OCR results).

The other diagnostic images have to do with Grooper's Synthesis settings. You can learn more about these settings and these diagnostics images by visiting the Synthesis article.

Last but certainly not least, there is always an "Execution Log" file at the bottom of this diagnostics panel. This file is a text file detailing information about the OCR operation. This file can be particularly helpful when configuring Grooper's Synthesis settings as well.

Use Cases

OCR Profiles are required to obtain machine readable text from any image based content. Based on the image quality or source document quality, this may range from a relatively simply configured OCR Profile, perhaps just setting the OCR engine to be used, to a more complex one, taking advantage of temporary image processing, Grooper's Synthesis suite, or Result Filtering settings.

The only time you won't use an OCR Profile to obtain machine readable text is if you are only processing documents with full native text. These would be digital documents like a PDF created with encoded text already present that can be extracted via the Native Text Extraction functionality of the Recognize activity.

How To

Create an OCR Profile

Add a New OCR Profile to the Node Tree

Creating an OCR Profile is fairly straight forward. OCR Profiles may be created and stored in a Content Model's local resources folder.

  1. Navigate to the Local Resources folder in your Content Model folder in the Node Tree. Feel free to add folders under your Local Resources folder for organization. Here we have created a folder called "OCR Profiles". Right click on the folder.
  2. Mouse over "Add"...
  3. ...and click "OCR Profile..."

  1. Name the OCR Profile whatever you like.
  2. Click "EXECUTE" to create it.
    • For this exercise we just named ours "OCR Profile Example."

This will create a blank OCR Profile in the OCR Profiles folder.

Configure the OCR Profile

  1. Bare minimum, you will need to select an OCR engine in order to obtain OCR results. To do this, select the OCR Engine property and choose an OCR engine from the dropdown menu.

Configure the rest of the OCR Profile's properties according to your documents' needs. General information about these properties can be found in the About section of this article.

Execute an OCR Profile

Now that you have made and configured an OCR Profile, how do you execute it? OCR results are obtained by the Recognize activity. This activity will perform OCR on documents based on the settings in an OCR Profile. You will run this activity in one of two ways in Grooper:

  1. Manual or "ad hoc" while testing and configuring within Grooper Design Studio.
  2. As a step in a Batch Process.

At any point you can get to a Batch Viewer in Grooper, you can execute various activities manually on a page, folder or entire batch. This manual execution of activities is typical when building and testing your solution design in Grooper Design Studio.

To manually apply an OCR Profile to a single page:

  1. Navigate to a page in a Batch and right click it.
  2. Select "Activities" and then "Cleanup & Recognition" from the selection list.
  3. Click "Recognize" from the final selection list.

On the following pop up window:

  1. Click the hamburger menu icon next to the OCR Profile property.
  2. Select the OCR Profile you wish to apply from the dropdown list.
  3. Click the "EXECUTE" button to run the Recognize activity using the selected OCR Profile on the page.

For automated Batch Processing, you'll want to add a Recognize step and configure it to use the OCR Process.

  1. Right click on a Batch Process.
  2. Hover over "Add Activity" and then "Cleanup & Recognition".
  3. Click on "Recognize..." to add a Recognize step.

  1. When the "Add Activity" window pops up, click "EXECUTE".

  1. In the "Activity Properties" panel, click the hamburger menu next to the OCR Profile property.
  2. Select the OCR Profile desired from the drop down menu.
Retrieved from "https://wiki.grooper.com/index.php?title=2023:OCR_Profile_(Node_Type)&oldid=15127"