Labeled OMR (Value Extractor) - Revision history

Rpatton: // via Wikitext Extension for VSCode

2026-01-20T15:51:06Z

// via Wikitext Extension for VSCode

@@ Line 1: / Line 1: @@
 {{AutoVersion}}
@@ Line 13: / Line 4: @@
 <blockquote>{{#lst:Glossary|Labeled OMR}}</blockquote>
 == Introduction ==

Rpatton: // via Wikitext Extension for VSCode

2026-01-20T15:46:13Z

// via Wikitext Extension for VSCode

← Older revision		Revision as of 10:46, 20 January 2026
Line 196:		Line 196:
	* CheckMulti		* CheckMulti
	* Boolean		* Boolean


	To set the OMR Mode on your Labeled OMR:		To set the OMR Mode on your Labeled OMR:
Line 205:		Line 206:
	#* ''CheckMulti'' - one or more of multiple check boxes will be checked on the document.		#* ''CheckMulti'' - one or more of multiple check boxes will be checked on the document.
	#* ''Boolean'' - a single check box will either be checked or unchecked on the document.		#* ''Boolean'' - a single check box will either be checked or unchecked on the document.


	By default, the Mode is set to CheckOne. When you change the Mode to one of the other two, new properties will appear that you may configure:		By default, the Mode is set to CheckOne. When you change the Mode to one of the other two, new properties will appear that you may configure:

Rpatton: // via Wikitext Extension for VSCode

2026-01-20T15:45:19Z

// via Wikitext Extension for VSCode

@@ Line 185: / Line 185: @@
 <div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.78; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmkfzjytd000kwi0i5bykn5a5?embed_v=2&utm_source=embed" loading="lazy" title="05 Maximum Noise" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>
-Troubleshooting:
+=== OMR Modes ===
-<br>
 '''Too many or too few labels grouped:'''
 * For custom Label Extractor with "Group Match" = False, adjust "Minimum Label Count".

Rpatton: // via Wikitext Extension for VSCode

2026-01-19T19:16:26Z

// via Wikitext Extension for VSCode

← Older revision		Revision as of 14:16, 19 January 2026
Line 186:		Line 186:

	Troubleshooting:		Troubleshooting:
			<br>
	'''Too many or too few labels grouped:'''		'''Too many or too few labels grouped:'''
	* For custom Label Extractor with "Group Match" = False, adjust "Minimum Label Count".		* For custom Label Extractor with "Group Match" = False, adjust "Minimum Label Count".

Rpatton: // via Wikitext Extension for VSCode

2026-01-19T19:15:57Z

// via Wikitext Extension for VSCode

← Older revision		Revision as of 14:15, 19 January 2026
Line 186:		Line 186:

	Troubleshooting:		Troubleshooting:
	* Too many or too few labels grouped:		'''Too many or too few labels grouped:'''
	* For custom Label Extractor with "Group Match" = False, adjust "Minimum Label Count".		* For custom Label Extractor with "Group Match" = False, adjust "Minimum Label Count".
	* Enable "Consider Lines" to avoid accidentally grouping across lines.		* Enable "Consider Lines" to avoid accidentally grouping across lines.
	* No OMR boxes found:		'''No OMR boxes found:'''
	* Confirm Box Removal was applied for rectangular checkboxes.		* Confirm Box Removal was applied for rectangular checkboxes.
	* Labeled OMR will fall back to circular detection if rectangular detection fails.		* Labeled OMR will fall back to circular detection if rectangular detection fails.
	* Ambiguous repeated groups:		'''Ambiguous repeated groups:'''
	* Configure "Header Extractor" to select the correct group.		* Configure "Header Extractor" to select the correct group.
	* Multi-select output formatting:		'''Multi-select output formatting:'''
	* In CheckMulti mode, verify whether the [[Data Field]] is an array (uses the ~~field’s~~ delimiter) or a single-value field (uses "Separator String").		* In CheckMulti mode, verify whether the [[Data Field]] is an array (uses the field's delimiter) or a single-value field (uses "Separator String").

	== Properties overview ==		== Properties overview ==
Line 202:		Line 202:
	'''"Label Extractor"'''		'''"Label Extractor"'''
	* Definition: An extractor that matches the labels for each checkbox.		* Definition: An extractor that matches the labels for each checkbox.
	* Remarks: Leave empty when using Label Sets or when the Data ~~Field’s~~ list values are configured; Labeled OMR will auto-create a list-based label matcher. If "Group Match" is False, configure it to match individual labels (e.g., Pattern or List). If "Group Match" is True, the extractor should match an entire label group and return the individual box labels as children.		* Remarks: Leave empty when using Label Sets or when the Data Field's list values are configured; Labeled OMR will auto-create a list-based label matcher. If "Group Match" is False, configure it to match individual labels (e.g., Pattern or List). If "Group Match" is True, the extractor should match an entire label group and return the individual box labels as children.
	* Purpose: Supplies label hits that anchor checkbox detection near those labels.		* Purpose: Supplies label hits that anchor checkbox detection near those labels.

Line 223:		Line 223:

	'''"Maximum Noise"'''		'''"Maximum Noise"'''
	* Definition: The maximum number of noise characters allowed in the label ~~group’s~~ bounding region.		* Definition: The maximum number of noise characters allowed in the label group's bounding region.
	* Remarks: The bounding region is the smallest rectangle enclosing the ~~group’s~~ labels (and header, if present). Noise characters are letters or digits in that region that are not part of the key/value; punctuation and whitespace are ignored. Set to zero to reject groups with any noise; leave unset to skip this check.		* Remarks: The bounding region is the smallest rectangle enclosing the group's labels (and header, if present). Noise characters are letters or digits in that region that are not part of the key/value; punctuation and whitespace are ignored. Set to zero to reject groups with any noise; leave unset to skip this check.
	* Purpose: Filters out groups with unwanted text artifacts inside the label area, improving accuracy on noisy forms.		* Purpose: Filters out groups with unwanted text artifacts inside the label area, improving accuracy on noisy forms.

Line 239:		Line 239:
	'''"Value If Checked"'''		'''"Value If Checked"'''
	* Definition: Output value when a checkbox is checked (primarily used in Boolean mode).		* Definition: Output value when a checkbox is checked (primarily used in Boolean mode).
	* Visibility: Hidden in contexts where selection comes from labels (e.g., Ordered OMR), but applicable to Labeled ~~OMR’s~~ Boolean mode.		* Visibility: Hidden in contexts where selection comes from labels (e.g., Ordered OMR), but applicable to Labeled OMR's Boolean mode.

	'''"Value If Unchecked"'''		'''"Value If Unchecked"'''
Line 247:		Line 247:
	'''"Separator String"'''		'''"Separator String"'''
	* Definition: The delimiter used to join multiple values in CheckMulti mode.		* Definition: The delimiter used to join multiple values in CheckMulti mode.
	* Visibility: Shown when Mode is CheckMulti and the [[Data Field]] is not an array. If the [[Data Field]] is an array, the ~~field’s~~ delimiter is used instead.		* Visibility: Shown when Mode is CheckMulti and the [[Data Field]] is not an array. If the [[Data Field]] is an array, the field's delimiter is used instead.

	== Execution and results ==		== Execution and results ==
	During Extract, Labeled OMR:		During Extract, Labeled OMR:
	# Finds labels either via "Label Extractor", via Label Sets on the [[Data Field]], or auto-generates a list-based label matcher using the ~~field’s~~ choices.		# Finds labels either via "Label Extractor", via Label Sets on the [[Data Field]], or auto-generates a list-based label matcher using the field's choices.
	# Groups labels (and header, if provided) into candidate sets, optionally considering intersecting lines.		# Groups labels (and header, if provided) into candidate sets, optionally considering intersecting lines.
	# Detects nearby checkboxes within each group:		# Detects nearby checkboxes within each group:
Line 263:		Line 263:
	== Tips ==		== Tips ==
	* Keep label text consistent and distinct across choices (e.g., avoid similar strings like ''Yes'' and ''Yes!'').		* Keep label text consistent and distinct across choices (e.g., avoid similar strings like ''Yes'' and ''Yes!'').
	* For CheckMulti outputs, confirm whether the [[Data Field]] should be configured as an array. Arrays use the ~~field’s~~ delimiter; single-value fields use "Separator String".		* For CheckMulti outputs, confirm whether the [[Data Field]] should be configured as an array. Arrays use the field's delimiter; single-value fields use "Separator String".
	* Use a header when similar checkbox groups repeat on the same page to avoid ambiguity.		* Use a header when similar checkbox groups repeat on the same page to avoid ambiguity.
	* Apply Box Removal to improve rectangular checkbox detection in the ~~page’s~~ layout data; otherwise Labeled OMR will rely on circular detection.		* Apply Box Removal to improve rectangular checkbox detection in the page's layout data; otherwise Labeled OMR will rely on circular detection.

	== See also ==		== See also ==

Rpatton: // via Wikitext Extension for VSCode

2026-01-19T17:57:54Z

// via Wikitext Extension for VSCode

Rpatton: // via Wikitext Extension for VSCode

2026-01-19T17:54:10Z

// via Wikitext Extension for VSCode

Show changes

Rpatton at 21:50, 15 January 2026

2026-01-15T21:50:56Z

← Older revision		Revision as of 16:50, 15 January 2026
Line 130:		Line 130:
	# Collect text on the document for each of the OMR option labels.		# Collect text on the document for each of the OMR option labels.
	#* The names of the labels will be the same as the text you typed in for the List Values.		#* The names of the labels will be the same as the text you typed in for the List Values.
			# (Optional) Collect a header label in the Data Field's text box label to give Grooper more context about where the OMR information is located on the document.
	# Save your changes to your Labels.		# Save your changes to your Labels.
	# Navigate to your Data Model and test your extraction.		# Navigate to your Data Model and test your extraction.

Rpatton at 21:39, 15 January 2026

2026-01-15T21:39:04Z

← Older revision		Revision as of 16:39, 15 January 2026
Line 91:		Line 91:

	<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.78; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmk5uhub900m13k0i098qkeew?embed_v=2&utm_source=embed" loading="lazy" title="02 Labeled OMR with Label Extractors" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>		<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.78; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmk5uhub900m13k0i098qkeew?embed_v=2&utm_source=embed" loading="lazy" title="02 Labeled OMR with Label Extractors" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>


			=== Configuring Labeled OMR: using List Values ===

			Instead of configuring a Label extractor for the OMR options, you can type in the text of the OMR options into the List Values property. Listing the options in List Values allows the Data Field to have a drop down menu available during review where a Reviewer can select from multiple options if the extraction is missing or incorrect rather than having to type in the full text.

			To set up your Labeled OMR extractor using List Values:
			# On the Data Field, set the Value Extractor property to Labeled OMR.
			# Scroll to the bottom of the property grid and locate the List Values property.
			# Click the "⮞" to expand out the List Values sub properties.
			# Click the "..." to the right of the Local Entries property to open the editor.
			# Type in the text for the OMR options on the document, hitting enter after each one.
			# Click "OK" in the top right of the editor.
			# (Optional) Expand the Value Extractor sub properties and set an extractor on the Header Extractor property to return the label or header for the OMR information.
			#* Setting a Header Extractor is not always necessary, but can help Grooper better understand where the OMR information is located on the document.
			#* A Header Extractor can be useful when the text for the OMR choices shows up in other areas on the document.
			# Click over to the "Tester" tab and test your extraction to ensure the desired data is extracted properly.
			#* You should see the option to access a drop down for the Data Field which will have all the OMR options you typed into the List Values.

			<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.78; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmkfo2d3s0088vf0i7efi6i55?embed_v=2&utm_source=embed" loading="lazy" title="03 Labeled OMR with List Values" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>


			=== Configuring Labeled OMR: using Labelsets ===

			Labeled OMR is a Labelset aware Value Extractor. That means that Labeled OMR can work with a Labeling Behavior set on your Content Model. Labelsets work in combination with List Values for Labeled OMR. List Values provide the text that will appear in the Data Field upon extraction. The Labelsets will provide Grooper with the information to determine which OMR option is checked on the document.

			'''Prerequisite:''' You will need to enable a Labeling Behavior on your [[Content Model]] before you will have access to the "Labels" tab. For more information on how to set up a Labeling Behavior, visit the [[Labeling Behavior]] wiki page.

			# On the Data Field, set the Value Extractor property to a Labeled OMR.
			# Scroll to the bottom of the property grid and locate the List Values property.
			# Click the "⮞" to expand out the List Values sub properties.
			# Click the "..." to the right of the Local Entries property to open the editor.
			# Type in text for the OMR options on the document, hitting enter after each one.
			#* When using Labelsets with Labeled Value, the List Values do not need to match the text on the document.
			# Click "OK" in the top right of the editor.
			# Navigate to the Content Model and click on the "Labels" tab.
			# Make sure your documents are Classified.
			# Collect text on the document for each of the OMR option labels.
			#* The names of the labels will be the same as the text you typed in for the List Values.
			# Save your changes to your Labels.
			# Navigate to your Data Model and test your extraction.
			#* You should see the text from the List Values returned in the Data Field with the ability to select another OMR option using the drop down on the Data Field text box.

			<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.78; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmkfpb9by008vxq0i30x4azsm?embed_v=2&utm_source=embed" loading="lazy" title="04 Labeled OMR with Label Sets" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

Rpatton at 17:08, 12 January 2026

2026-01-12T17:08:31Z

← Older revision		Revision as of 12:08, 12 January 2026
Line 1:		Line 1:
	{{~~Migrated~~}}		{\|class="wip-box"
	{{~~2023~~:~~{{PAGENAME}~~}}}		\|
			'''WIP'''
			\|
			This article is a work-in-progress or created as a placeholder for testing purposes. This article is subject to change and/or expansion. It may be incomplete, inaccurate, or stop abruptly.

			This tag will be removed upon draft completion.
			\|}

			{{AutoVersion}}

			[[File:Labeled-omr-about-01.png\|thumb\|200px\|An example of checkboxes.]]

			<blockquote>{{#lst:Glossary\|Labeled OMR}}</blockquote>

			== Introduction ==
			'''OMR boxes''' (Optical Mark Recognition) are small shapes printed on documents (typically squares or circles) that users fill or check to indicate a choice (for example, ''☑ Yes ☐ No''). Grooper detects whether each box is checked and converts these marks into data values for a [[Data Field]].

			'''Labeled OMR''' detects checkboxes based on nearby labels. It can:
			* Use a configured ''Label Extractor'' to find labels.
			* Automatically use labels from a ''[[Label Sets\|Label Set]]'' defined on the [[Data Field]] (no Label Extractor required).
			* Optionally use a header label to disambiguate one group of checkboxes from other similar groups on the same page.

			How it differs from other Value Extractors:
			* Unlike text-based extractors (e.g., Pattern, List, or Data Type), Labeled OMR reads visual checkboxes and links them to nearby text labels.
			* Unlike [[Ordered OMR]] (region + ordered positions) and [[Zonal OMR]] (manually defined zones), Labeled OMR anchors to labels found on the page and then locates checkboxes near those labels.

			Differences vs. Ordered OMR and Zonal OMR:
			* '''Ordered OMR''' assigns values based on the fixed order of checkboxes within a rectangular region. Use it when label text is unreliable or absent, but the positions and order of boxes are consistent.
			* '''Zonal OMR''' uses manually configured zones for each checkbox. Use it when checkbox locations are fixed and known per page layout.
			* '''Labeled OMR''' uses labels detected at runtime and finds nearby checkboxes. Use it when forms have variable placement or multiple repeated groups, and labels are the reliable anchor.

			== When to use ==
			Use Labeled OMR when:
			* Checkbox choices are printed with identifiable labels near each box (e.g., ''Yes'', ''No'', ''Undecided'').
			* The form may contain repeated groups or variable layouts that make fixed zones or strict ordering unsuitable.
			* You want automatic label awareness via the Data Field's Label Set or Choice List.

			Real-world example (preferred over Ordered OMR or Zonal OMR):
			# A multi-page survey where “Yes ☐ No ☐ Undecided ☐” appears under several different questions with varying positions. Because labels are reliable, Labeled OMR can find the correct group under a specific header (e.g., ''Attending next semester?'') and read the checkboxes near those labels—even if the exact location shifts among pages and documents.

			Prerequisites:
			* For rectangular checkboxes, ensure the page has layout data including '''Box Removal''' obtained during Recognize or Image Processing.
			* Provide labels either by:
			** Configuring a ''Label Extractor'', or
			** Defining a Label Set on the [[Data Field]].

			== How to configure Labeled OMR ==
			There are a few different ways to configure the Labeled OMR extractors. You can use Label Extractors, List Values, and Label Sets. We will first discuss obtaining Layout Data for our documents, then go through each method for obtaining labels for Labeled OMR.

			=== Prerequisite: layout data for documents ===
			Before configuring a Labeled OMR extractor, you must ensure you have Layout Data on our documents that includes the detection of boxes. To do this you will need to configure an [[IP Profile]] with (at minimum) a Box Detection [[IP Step]]. You will then need to reference the IP Profile in either an [[Image Processing]] or [[Recognize]] Step in a [[Batch Process]].

			# In your node tree, create a new IP Profile if you do not already have one available and add a Box Detection IP Step.
			# Reference your IP Profile on your Recognize Step in one of two ways:
			#* If your documents require OCR, reference the IP Profile on the [[OCR Profile]] you will be using on your Recognize Step.
			#* If your documents do not require OCR, reference the IP Profile on the Alternate IP property on your Recognize Step.
			#* If you find that your documents need more comprehensive Image Processing, you can run the IP Profile on an Image Processing Batch Process Step.
			# Save your changes to your Recognize Step.
			# Navigate to the "Activity Tester" tab of the Recognize Step and test on the Batch.
			#* If you have an Activity Processor running you can submit a job to run the Recognize Step, otherwise, select the objects you want to run Recognize on and click the test icon.
			# Now select the object you ran Recognize on and click the Renditions icon located at the top right of the Document Viewer.
			# Select the "Layout" view from the drop down.
			# Now you should be able to see the layout data that was collected.
			#* Empty boxes will be highlighted in pink.
			#* Checked boxes will be highlighted in green.

			{\|class="fyi-box"
			\|-
			\|
			'''FYI'''
			\|
			If you would like to follow along with the demo below, download the Project and Batch at the beginning of this Wiki Article.
			\|}

			<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.78; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmk5nznj6003z130irqciu37y?embed_v=2&utm_source=embed" loading="lazy" title="01 Layout Data" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

			=== Configuring Labeled OMR: using Label Extractors ===

			There are three methods to setting up a Labeled OMR Extractor. The first option is going to be setting up Label Extractors on the Labeled OMR.

			# On the Data Field, set the Value Extractor property to Labeled OMR.
			# Expand the Labeled OMR sub properties.
			# Set the Label Extractor to a List Match and open the List Match editor by clicking the "..." icon to the right of the property.
			# Type in the name of each of the OMR options. Hit Enter on your keyboard after each entry.
			# When finished, click "OK" in the top right of the pop up window.
			# (Optional) Set an extractor on the Header Extractor property to return the label or header for the OMR information. In our example below, we used a List Match.
			#* Setting a Header Extractor is not always necessary, but can help Grooper better understand where the OMR information is located on the document.
			#* A Header Extractor can be useful when the text for the OMR choices shows up in other areas on the document.
			# Click over to the "Tester" tab and test your extraction to ensure the desired data is extracted properly.

			<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.78; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmk5uhub900m13k0i098qkeew?embed_v=2&utm_source=embed" loading="lazy" title="02 Labeled OMR with Label Extractors" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

← Older revision		Revision as of 12:57, 19 January 2026
Line 200:		Line 200:
	Below are the Labeled OMR-specific properties and related OMR output behaviors. Property visibility may depend on OMR mode and whether a Label Extractor is set.		Below are the Labeled OMR-specific properties and related OMR output behaviors. Property visibility may depend on OMR mode and whether a Label Extractor is set.

	* "Label Extractor"		'''"Label Extractor"'''
	* Definition: An extractor that matches the labels for each checkbox.		* Definition: An extractor that matches the labels for each checkbox.
	* Remarks: Leave empty when using Label Sets or when the Data Field’s list values are configured; Labeled OMR will auto-create a list-based label matcher. If "Group Match" is False, configure it to match individual labels (e.g., Pattern or List). If "Group Match" is True, the extractor should match an entire label group and return the individual box labels as children.		* Remarks: Leave empty when using Label Sets or when the Data Field’s list values are configured; Labeled OMR will auto-create a list-based label matcher. If "Group Match" is False, configure it to match individual labels (e.g., Pattern or List). If "Group Match" is True, the extractor should match an entire label group and return the individual box labels as children.
	* Purpose: Supplies label hits that anchor checkbox detection near those labels.		* Purpose: Supplies label hits that anchor checkbox detection near those labels.

	* "Header Extractor"		'''"Header Extractor"'''
	* Definition: An extractor that matches the header label for the OMR group.		* Definition: An extractor that matches the header label for the OMR group.
	* Remarks: Optional; helps disambiguate between multiple similar checkbox groups. Leave empty when using Label Sets and a header label is defined for the field.		* Remarks: Optional; helps disambiguate between multiple similar checkbox groups. Leave empty when using Label Sets and a header label is defined for the field.
	* Purpose: Selects the correct group under a specific heading on pages that contain repeated groups.		* Purpose: Selects the correct group under a specific heading on pages that contain repeated groups.

	* "Group Match"		'''"Group Match"'''
	* Definition: Indicates that the Label Extractor matches an entire label group rather than individual labels.		* Definition: Indicates that the Label Extractor matches an entire label group rather than individual labels.
	* Remarks: When enabled, configure the Label Extractor to return a single result per group, with children representing the individual labels. When disabled, use separate label hits and specify "Minimum Label Count".		* Remarks: When enabled, configure the Label Extractor to return a single result per group, with children representing the individual labels. When disabled, use separate label hits and specify "Minimum Label Count".
	* Purpose: Controls grouping strategy based on how your Label Extractor returns results.		* Purpose: Controls grouping strategy based on how your Label Extractor returns results.
	* Visibility: Only shown when a Label Extractor is set and OMR mode is not Boolean.		* Visibility: Only shown when a Label Extractor is set and OMR mode is not Boolean.

	* "Minimum Label Count"		'''"Minimum Label Count"'''
	* Definition: The minimum number of labels required for a match to occur.		* Definition: The minimum number of labels required for a match to occur.
	* Remarks: Applies only when using a local Label Extractor and "Group Match" is False. Set to the expected number of labels per group to ensure complete grouping.		* Remarks: Applies only when using a local Label Extractor and "Group Match" is False. Set to the expected number of labels per group to ensure complete grouping.
	* Purpose: Prevents incomplete or partial groups from being considered valid.		* Purpose: Prevents incomplete or partial groups from being considered valid.
	* Visibility: Only shown when a Label Extractor is set, OMR mode is not Boolean, and "Group Match" is False.		* Visibility: Only shown when a Label Extractor is set, OMR mode is not Boolean, and "Group Match" is False.

	* "Maximum Noise"		'''"Maximum Noise"'''
	* Definition: The maximum number of noise characters allowed in the label group’s bounding region.		* Definition: The maximum number of noise characters allowed in the label group’s bounding region.
	* Remarks: The bounding region is the smallest rectangle enclosing the group’s labels (and header, if present). Noise characters are letters or digits in that region that are not part of the key/value; punctuation and whitespace are ignored. Set to zero to reject groups with any noise; leave unset to skip this check.		* Remarks: The bounding region is the smallest rectangle enclosing the group’s labels (and header, if present). Noise characters are letters or digits in that region that are not part of the key/value; punctuation and whitespace are ignored. Set to zero to reject groups with any noise; leave unset to skip this check.
	* Purpose: Filters out groups with unwanted text artifacts inside the label area, improving accuracy on noisy forms.		* Purpose: Filters out groups with unwanted text artifacts inside the label area, improving accuracy on noisy forms.

	* "Consider Lines"		'''"Consider Lines"'''
	* Definition: When enabled, grouping of labels considers intersecting lines to improve accuracy.		* Definition: When enabled, grouping of labels considers intersecting lines to improve accuracy.
	* Remarks: Useful when multiple identical labels appear on a page and cannot be grouped accurately by proximity alone. Lines are used as additional grouping cues.		* Remarks: Useful when multiple identical labels appear on a page and cannot be grouped accurately by proximity alone. Lines are used as additional grouping cues.
	* Purpose: Reduces incorrect label grouping in complex layouts, such as forms with grid lines or separators.		* Purpose: Reduces incorrect label grouping in complex layouts, such as forms with grid lines or separators.

	Related OMR output behaviors (inherited):		'''Related OMR output behaviors (inherited):'''
	* "Mode" (OMR mode)		'''"Mode" (OMR mode)'''
	* Definition: Controls how checkbox selections produce values (Boolean, CheckOne, CheckMulti).		* Definition: Controls how checkbox selections produce values (Boolean, CheckOne, CheckMulti).
	* Purpose: Determines whether single or multiple selections are allowed and how the output value is formed.		* Purpose: Determines whether single or multiple selections are allowed and how the output value is formed.

	* "Value If Checked"		'''"Value If Checked"'''
	* Definition: Output value when a checkbox is checked (primarily used in Boolean mode).		* Definition: Output value when a checkbox is checked (primarily used in Boolean mode).
	* Visibility: Hidden in contexts where selection comes from labels (e.g., Ordered OMR), but applicable to Labeled OMR’s Boolean mode.		* Visibility: Hidden in contexts where selection comes from labels (e.g., Ordered OMR), but applicable to Labeled OMR’s Boolean mode.

	* "Value If Unchecked"		'''"Value If Unchecked"'''
	* Definition: Output value when a checkbox is unchecked (primarily used in Boolean mode).		* Definition: Output value when a checkbox is unchecked (primarily used in Boolean mode).
	* Visibility: Similar to "Value If Checked".		* Visibility: Similar to "Value If Checked".

	* "Separator String"		'''"Separator String"'''
	* Definition: The delimiter used to join multiple values in CheckMulti mode.		* Definition: The delimiter used to join multiple values in CheckMulti mode.
	* Visibility: Shown when Mode is CheckMulti and the [[Data Field]] is not an array. If the [[Data Field]] is an array, the field’s delimiter is used instead.		* Visibility: Shown when Mode is CheckMulti and the [[Data Field]] is not an array. If the [[Data Field]] is an array, the field’s delimiter is used instead.

	== Execution and results ==		== Execution and results ==
Line 254:		Line 254:
	# Groups labels (and header, if provided) into candidate sets, optionally considering intersecting lines.		# Groups labels (and header, if provided) into candidate sets, optionally considering intersecting lines.
	# Detects nearby checkboxes within each group:		# Detects nearby checkboxes within each group:
	* Attempts rectangular detection first (requires Box Removal in preprocessing).		#* Attempts rectangular detection first (requires Box Removal in preprocessing).
	* Falls back to circular detection if rectangular boxes are not found.		#* Falls back to circular detection if rectangular boxes are not found.
	# Produces one or more [[Field Instance]]s with:		# Produces one or more [[Field Instance]]s with:
	* The selected value(s) based on checked boxes and OMR mode.		#* The selected value(s) based on checked boxes and OMR mode.
	* Linked "Labels" (context) and "Checkboxes" collections for review.		#* Linked "Labels" (context) and "Checkboxes" collections for review.
	* Confidence and annotations to visualize label groups and boxes in the Review UI.		#* Confidence and annotations to visualize label groups and boxes in the Review UI.

	== Tips ==		== Tips ==