Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

Ordered OMR

OMR Extractor Grooper.Extract

Reads one or more checkboxes with a consistent order of appearance inside a rectangular region.

Remarks

OrderedOMR extracts the state of checkboxes that appear in a fixed order within a defined rectangular region, assigning output values based on their position.


Overview

OrderedOMR is designed for forms where checkboxes are always in the same order, but their text labels may be missing, unreliable, or unreadable. You specify a region containing the checkboxes and a list of output values, and the extractor assigns each value to a checkbox based on its detected order (left-to-right or top-to-bottom).

This is ideal for structured forms such as surveys, ballots, or standardized tests where the meaning of each checkbox is determined by its position, not by a label.

Before using OrderedOMR, ensure that the source documents have been processed with Box Detection or Box Removal to reliably identify checkbox regions.


Key Features

  • Region-Based Extraction:
    The 'Location' property defines the rectangular area to search for checkboxes.

  • Ordered Value Assignment:
    The 'Output Values' property provides a list of values to assign to checkboxes in order of appearance.

  • Flow Direction:
    The 'Flow Direction' property controls whether checkboxes are ordered horizontally (left-to-right) or vertically (top-to-bottom).

  • Flexible Output Modes:
    Supports Boolean (single selection), CheckOne (single selection from multiple), and CheckMulti (multiple selections) modes, as configured in the parent OMR Extractor.


Usage Examples

  • Multiple Choice (CheckOne):
    Extract a single selected value from a row or column of checkboxes, such as a rating scale.

  • Multi-Select (CheckMulti):
    Extract all checked values from a group of checkboxes, with results separated by the configured delimiter.

  • Boolean:
    Extract a Yes/No or True/False value from a pair of checkboxes.


Notes

  • The number of detected checkboxes in the region must match the number of output values.
  • For Boolean mode, exactly two checkboxes and two output values are required.
  • For more details, see the documentation for each property and the Ordered OMR wiki page.

Properties

NameTypeDescription
General
Options

See Also

Used By

Notification