Zonal OMR (Extractor Type)

⚠	This article was migrated from an older version and has not been updated for the current version of Grooper. This tag will be removed upon article review and update.

This article is about the current version of Grooper.

Note that some content may still need to be updated.

2025

2023

Zonal OMR is an Extractor Type that reads one or more OMR checkboxes using manually-configured zones. The zone may be optionally fixed on the page or anchored to a static text value (such as a label). BE AWARE: Zonal OMR is outdated compared to Labeled OMR and Ordered OMR. It requires the most manual setup of any OMR extractor to configure. Use this as a last resort when other OMR extractor options have been exhausted.

You may download the ZIP(s) below and upload it into your own Grooper environment (version 2023). The first contains a Project with resources used in examples throughout this article. The second contains one or more Batches of sample documents.

About

In previous versions of Grooper (prior to Grooper 2021), OMR extraction was quite different and took a bit more setup than the OMR extractors we can use in Grooper 2023. Now called Zonal OMR, this previous method of OMR extraction still exists, for the most part, for upgrading repositories from old versions of Grooper. That way, anything that used this outdated version of OMR extraction still works in new versions.

It is recommended that you use Labeled OMR or Ordered OMR instead, but as a last resort, you can fall back on Zonal OMR.

⚠	Zonal OMR can only be used with OMR boxes. It will not detect radio buttons. If your document has radio buttons you want returned, you will have to use Labeled OMR for that.

How To

For Zonal OMR to work, we have to assign a Value to each OMR Box individually and tell Grooper where to look for the box on the document.

In the example below, we are using a simple document indicating different emotions. We are going to assign a different emotion to each OMR box and Grooper will return the value assigned to the checked box.

While it should never be your first choice, you can use Zonal OMR in more complex situations not easily accommodated by the other OMR extractors. In the example below, we show a diagram that is being used to indicate the area of impact to a vehicle from a car accident. We can use Zonal OMR to return this type of information.