OCR Reader (Result Post Processor) - Revision history

Dgreenwood: Changed redirect target from OCR Reader (Result Post Processor) - 2.90 to 2.90:OCR Reader (Result Post Processor)

2024-01-02T18:37:08Z

Changed redirect target from OCR Reader (Result Post Processor) - 2.90 to 2.90:OCR Reader (Result Post Processor)

← Older revision		Revision as of 13:37, 2 January 2024
Line 1:		Line 1:
	#REDIRECT		#REDIRECT [[2.90:OCR Reader (Result Post Processor)]]
	[[~~OCR Reader (Result Post Processor) -~~ 2.90]]

	~~<!--~~

	~~This shit old~~

	~~[[image:ocr reader2.png\|frame\|The OCR Reader post processor selected on a Data Type's property panel.]]~~

	~~<blockquote style="font-size~~:~~14pt">~~
	~~The '''~~OCR Reader~~''' post processor allows you to run additional OCR on a region nearby a label~~ (~~which has been returned as the result of a Data Type extractor) and return the reprocessed text.~~
	~~</blockquote>~~

	~~This is especially useful on documents where data is printed in a special font, or even when the label and value fonts are different entirely.~~

	~~This region can be relative to the initial Data Type extractor's result, or be configured to automatically "snap" to a bounding box.~~

	~~== Example ==~~

	We want to extract key values from a form. The problem is that this form contains mixed fonts, and the values we want are displayed in the OCR-A font, which is sometimes troublesome for standard OCR engines.

	~~[[image:1555438762302-330.png\|center\|900px]]~~

	The idea for this scenario is to first extract the label for the value we want using a Data Type extractor <code>2. First Name</code>, and then set the "Post Processing" property of that Data Type to run a special OCR Profile designed to extract the value associated with the label <code>Benjamin</code>.

	~~=== Steps ===~~

	~~<tabs>~~
	~~<tab name="Step 1">~~
	~~===== Create the Data Type =====~~
	~~First, we want to create the "Data Type" that will extract the label with the following "Pattern".~~

	~~<code>(\d\.\s)?first name</code>~~


	~~[[image:ocrpp001.png\|center\|900px]]~~


	~~</tab>~~
	~~<tab name="Step 2">~~
	~~===== Enable the Post Processor =====~~
	~~In the "Output" section of the Data Type, we'll set the "Post Processing" property to "OCR Reader".~~


	~~[[image:ocrpp002.png\|center\|900px]]~~


	~~</tab>~~
	~~<tab name="Step 3">~~
	~~===== Configure the Post Processor =====~~
	~~Once we've chosen "OCR Reader", we can expand it to reveal its configurable properties.~~
	* Set the '''OCR Profile''' to a profile designed specifically to deal with OCR-A fonts.
	* Set '''Auto Snap Distance''' to "1.5in".
	* Set '''Auto Snap Margin''' to "1pt, 12pt, 2pt, 1pt".
	* Set '''Output Full Region''' to "True".


	~~[[image:ocrpp003.png\|center\|900px]]~~


	~~</tab>~~
	~~<tab name="Step 4">~~
	~~===== Test Extraction =====~~
	~~Once we Save and Run Extraction, the "~~Post Processor~~" runs after the initial pattern (the one that finds the label~~)~~, OCRs the region we defined, and outputs our value: <code>Benjamin</code>.~~


	~~[[image:ocrpp004.png\|center\|900px]]~~
	~~</tab>~~
	~~</tabs>~~

	~~=== The Value Extractor Property: A Word of Caution ===~~

	In a lot of ways, the ''Read Zone'' option for a '''Data Field's''' '''''Value Extractor''''' and the ''OCR Reader'' '''''Post Processing''''' option for '''Data Types''' are very similar to each other. Both can use text anchors and extraction zones to return data inside the drawn boundary on the page.

	~~Both have a '''''Value Extractor''''' property to parse data within the zone's data instance as well. However, the results are collated and returned in one drastically different way.~~
	* Read Zone will return only the first match returned.
	* OCR Reader will return all matches concatenated together.

	~~The differences are not necessarily good or bad. It just depends on your needs which one you will want to use.~~

	~~For an in-depth explanation of the differences, visit the [[Read Zone#Data Instancing: Using Read Zone's Value Extractor Property\|Read Zone article's section on the Value Extractor property~~]].

	~~== Version Differences ==~~

	The OCR Reader result processor is a new configurable property available to Data Types as of version 2.72. Prior to version 2.72, the capability of reprocessing OCR on a region of a document was available by configuring a Data Element Profile in a Document Type object. Furthermore, since the result is returned to a Data Type, this data could be used any time an extractor is used in Grooper, not just to populate a field in a data model.

	~~== Properties ==~~

	~~{\|cellpadding="10" cellspacing="5"~~
	~~\|-style="background-color:#ddf5f5"~~
	~~\|OCR Profile\|\|The OCR Profile to use for character extraction.~~
	~~\|-style="background-color:#ddf5f5"~~
	~~\|Region\|\|Specifies a region, relative to each output instance, where OCR should be performed.~~
	~~\|-style="background-color:#ddf5f5"~~
	~~\|Auto Snap Distance\|\|Specifies the maximum distance for an auto snap operation, which automatically aligns the edges of the zone to lines on the document.~~
	~~\|-style="background-color:#ddf5f5"~~
	~~\|Auto Snap Margin\|\|When the auto snap feature is in use, specifies an additional amount to shrink the zone on each edge.~~
	~~\|-style="background-color:#ddf5f5"~~
	~~\|Value Extractor\|\|An optional extractor to be executed against the OCR content.~~
	~~\|-style="background-color:#ddf5f5"~~
	~~\|Line Separator\|\|When capturing multiple lines of text, specifies how line breaks will be represented in the output.~~
	~~\|-style="background-color:#ddf5f5"~~
	~~\|Output Full Region\|\|Specifies whether the highlight region of each output instance will reflect the full OCR area, or only the area containing text.~~

Dgreenwood: Redirected page to OCR Reader (Result Post Processor) - 2.90

2020-10-23T19:52:22Z

Redirected page to OCR Reader (Result Post Processor) - 2.90

← Older revision		Revision as of 14:52, 23 October 2020
Line 1:		Line 1:
			#REDIRECT
			[[OCR Reader (Result Post Processor) - 2.90]]

			<!--

			This shit old

	[[image:ocr reader2.png\|frame\|The OCR Reader post processor selected on a Data Type's property panel.]]		[[image:ocr reader2.png\|frame\|The OCR Reader post processor selected on a Data Type's property panel.]]

Dgreenwood: /* The Value Extractor Property: A Word of Caution */

2020-10-23T19:20:25Z

The Value Extractor Property: A Word of Caution

← Older revision		Revision as of 14:20, 23 October 2020
Line 72:		Line 72:
	The differences are not necessarily good or bad. It just depends on your needs which one you will want to use.		The differences are not necessarily good or bad. It just depends on your needs which one you will want to use.

	For an in-depth ~~explaination~~ of the differences, visit the [[Read Zone#Data Instancing: Using Read Zone's Value Extractor Property\|Read Zone article's section on the Value Extractor property]].		For an in-depth explanation of the differences, visit the [[Read Zone#Data Instancing: Using Read Zone's Value Extractor Property\|Read Zone article's section on the Value Extractor property]].

	== Version Differences ==		== Version Differences ==

Dgreenwood at 16:32, 13 October 2020

2020-10-13T16:32:39Z

@@ Line 8: / Line 8: @@
 This region can be relative to the initial Data Type extractor's result, or be configured to automatically "snap" to a bounding box.
 == Example ==
@@ Line 65: / Line 61: @@
 </tab>
 </tabs>
 == Properties ==

Configadmin at 18:06, 23 December 2019

2019-12-23T18:06:57Z

← Older revision		Revision as of 13:06, 23 December 2019
Line 8:		Line 8:

	This region can be relative to the initial Data Type extractor's result, or be configured to automatically "snap" to a bounding box.		This region can be relative to the initial Data Type extractor's result, or be configured to automatically "snap" to a bounding box.

	~~<br clear = all>~~

	== Version Differences ==		== Version Differences ==

Configadmin at 17:55, 23 December 2019

2019-12-23T17:55:34Z

← Older revision		Revision as of 12:55, 23 December 2019
Line 1:		Line 1:
	[[image:ocr ~~reader~~.png\|frame\|The OCR Reader post processor selected on a Data Type's property panel.]]		[[image:ocr reader2.png\|frame\|The OCR Reader post processor selected on a Data Type's property panel.]]

	<blockquote style="font-size:14pt">		<blockquote style="font-size:14pt">

Configadmin at 17:29, 23 December 2019

2019-12-23T17:29:08Z

← Older revision		Revision as of 12:29, 23 December 2019
Line 10:		Line 10:

	<br clear = all>		<br clear = all>

			== Version Differences ==

			The OCR Reader result processor is a new configurable property available to Data Types as of version 2.72. Prior to version 2.72, the capability of reprocessing OCR on a region of a document was available by configuring a Data Element Profile in a Document Type object. Furthermore, since the result is returned to a Data Type, this data could be used any time an extractor is used in Grooper, not just to populate a field in a data model.

	== Example ==		== Example ==

Configadmin at 15:38, 23 December 2019

2019-12-23T15:38:56Z

← Older revision		Revision as of 10:38, 23 December 2019
Line 2:		Line 2:

	<blockquote style="font-size:14pt">		<blockquote style="font-size:14pt">
	The '''OCR Reader''' post processor allows you to run additional OCR on a region nearby a label (which has been returned as the result of a Data Type extractor) and return the ~~OCR'd~~ text.		The '''OCR Reader''' post processor allows you to run additional OCR on a region nearby a label (which has been returned as the result of a Data Type extractor) and return the reprocessed text.
	</blockquote>		</blockquote>

Configadmin at 22:00, 20 December 2019

2019-12-20T22:00:01Z

← Older revision		Revision as of 17:00, 20 December 2019
Line 15:		Line 15:
	We want to extract key values from a form. The problem is that this form contains mixed fonts, and the values we want are displayed in the OCR-A font, which is sometimes troublesome for standard OCR engines.		We want to extract key values from a form. The problem is that this form contains mixed fonts, and the values we want are displayed in the OCR-A font, which is sometimes troublesome for standard OCR engines.

	[[image:1555438762302-330.png]]		[[image:1555438762302-330.png\|center\|900px]]

	The idea for this scenario is to first extract the label for the value we want using a Data Type extractor <code>2. First Name</code>, and then set the "Post Processing" property of that Data Type to run a special OCR Profile designed to extract the value associated with the label <code>Benjamin</code>.		The idea for this scenario is to first extract the label for the value we want using a Data Type extractor <code>2. First Name</code>, and then set the "Post Processing" property of that Data Type to run a special OCR Profile designed to extract the value associated with the label <code>Benjamin</code>.
Line 29:		Line 29:


	[[image:ocrpp001.png\|center]]		[[image:ocrpp001.png\|center\|900px]]


Line 38:		Line 38:


	[[image:ocrpp002.png\|center]]		[[image:ocrpp002.png\|center\|900px]]


Line 51:		Line 51:


	[[image:ocrpp003.png\|center]]		[[image:ocrpp003.png\|center\|900px]]


Line 60:		Line 60:


	[[image:ocrpp004.png\|center]]		[[image:ocrpp004.png\|center\|900px]]
	</tab>		</tab>
	</tabs>		</tabs>

Configadmin at 21:59, 20 December 2019

2019-12-20T21:59:00Z

← Older revision		Revision as of 16:59, 20 December 2019
Line 29:		Line 29:


	[[image:~~001~~.png\|center]]		[[image:ocrpp001.png\|center]]


Line 35:		Line 35:
	<tab name="Step 2">		<tab name="Step 2">
	===== Enable the Post Processor =====		===== Enable the Post Processor =====
	In the Output section of the Data Type, we'll set the "Post Processing" property to "OCR Reader".		In the "Output" section of the Data Type, we'll set the "Post Processing" property to "OCR Reader".


	[[image:~~002~~.png\|center]]		[[image:ocrpp002.png\|center]]


Line 51:		Line 51:


	[[image:~~003~~.png\|center]]		[[image:ocrpp003.png\|center]]


Line 60:		Line 60:


	[[image:~~004~~.png\|center]]		[[image:ocrpp004.png\|center]]
	</tab>		</tab>
	</tabs>		</tabs>
Line 67:		Line 67:

	{\|cellpadding="10" cellspacing="5"		{\|cellpadding="10" cellspacing="5"
	\|-style="background-color:#~~fcd4a5~~"		\|-style="background-color:#ddf5f5"
	\|OCR Profile\|\|The OCR Profile to use for character extraction.		\|OCR Profile\|\|The OCR Profile to use for character extraction.
	\|-style="background-color:#~~fcd4a5~~"		\|-style="background-color:#ddf5f5"
	\|Region\|\|Specifies a region, relative to each output instance, where OCR should be performed.		\|Region\|\|Specifies a region, relative to each output instance, where OCR should be performed.
	\|-style="background-color:#~~fcd4a5~~"		\|-style="background-color:#ddf5f5"
	\|Auto Snap Distance\|\|Specifies the maximum distance for an auto snap operation, which automatically aligns the edges of the zone to lines on the document.		\|Auto Snap Distance\|\|Specifies the maximum distance for an auto snap operation, which automatically aligns the edges of the zone to lines on the document.
	\|-style="background-color:#~~fcd4a5~~"		\|-style="background-color:#ddf5f5"
	\|Auto Snap Margin\|\|When the auto snap feature is in use, specifies an additional amount to shrink the zone on each edge.		\|Auto Snap Margin\|\|When the auto snap feature is in use, specifies an additional amount to shrink the zone on each edge.
	\|-style="background-color:#~~fcd4a5~~"		\|-style="background-color:#ddf5f5"
	\|Value Extractor\|\|An optional extractor to be executed against the OCR content.		\|Value Extractor\|\|An optional extractor to be executed against the OCR content.
	\|-style="background-color:#~~fcd4a5~~"		\|-style="background-color:#ddf5f5"
	\|Line Separator\|\|When capturing multiple lines of text, specifies how line breaks will be represented in the output.		\|Line Separator\|\|When capturing multiple lines of text, specifies how line breaks will be represented in the output.
	\|-style="background-color:#~~fcd4a5~~"		\|-style="background-color:#ddf5f5"
	\|Output Full Region\|\|Specifies whether the highlight region of each output instance will reflect the full OCR area, or only the area containing text.		\|Output Full Region\|\|Specifies whether the highlight region of each output instance will reflect the full OCR area, or only the area containing text.