Click here to Skip to main content
15,880,037 members
Articles / Programming Languages / C#

C# - Optical Marks Recognition (OMR) Engine 1.0

Rate me:
Please Sign up or sign in to vote.
4.77/5 (34 votes)
9 Mar 2015CPOL6 min read 295.7K   25.4K   107   126
An API that reads OMR sheets from camera taken/ scanner scanned images.

[Update March 2015]

I've released a major update to the engine and wrote a new article on it as, well. Kindly view it at THIS link.

From now an on, I'll not answer to any questions asked on this article, kindly refer to the other version. V2 is much better and most of the bugs you people reported, have been cleared.


OMR (wiki) are answer sheets that are not intended to be read by a human being. This projects eliminates the need to buy OMR reading machines and even a photo scanner for computer. Any >3MP mobile phone camera with autofocus will do the job.


I Googled to to find a good OMR engine but in vain, so I decided to make my own. Normally in schools and colleges they use specialized machines to read OMR answer sheets. In my case I needed to eliminate the need of buying the OMR reader machine, even the scanner! Pictures taken with a 3MP mobile phone camera (autofocus required) can be read through this engine. At an initial level, I have created my own sheet types that can be read.

The image processing part utilizes AForge.Net's image processor (libraries included in the download).  

[FAQ] Q: 1  Will it work with other OMR sheets?

It looks like a lot of people have asked a same question repeatedly in the feedback.  

"Can we use any other OMR sheet with this engine?" .

And the answer is, "NO".

Why? Because of the Paper image extraction Algorithm used in method ExtractPaperFromFlattened(). It identifies a paper out of a scanned immage by finding the 4 crossed circular symbols located on the paper. THESE SYMBOLS DEFINE THE BOUNDARIES OF PAPER AND THUS, THE INFORMATION ABOUT CROPPING, RESCALING AND SKEWING OF PAPER IS ESTIMATED.

So, no symbols, NO DETECTION of paper.

[FAQ] Q: 2  Can i create my own OMR Sheet?

In V1, you can't. Atleast without my help, you can't lest you are a super geek.

in V2, Yes! View THIS link

Using the Code

After adding all the references (AForge and OMR) you can use the simplest method overload to extract an OMR wrapped sheet from camera/scanner image. 

Raw images must contain one clear view of the supported sheet formats (Printable PDF is in the download). e.g.

Bitmap unf = new Bitmap(panel1.BackgroundImage);
OpticalReader reader = new OpticalReader();
panel1.BackgroundImage = (System.Drawing.Image)reader.ExtractOMRSheet(unf, 
    "sheets.xml" , OMREnums.OMRSheet.A550);

This will extract sheet as this:

And once the sheet is extracted you can process it using methods like:

OpticalReader rr = new OpticalReader();
    OMREnums.OMRSheet.A550, "sheets.xml",false).ToString()); 

Sheet Detection From Camera/Scanner Image

The procedure to detect a sheet involves detection of a sheet's corners. In the printed document corners are marked with specific binary images. We detect them, we detect a sheet.

  1. So, first of all, we need to flatten out the picture using correct contrast, fill, threshold and invert filter. As a start point, raw images with no contrast, brightness or fill correction are inverted. Given a threshold, the image is then converted to binary. This image is called a "Flattened Image" and is obtained by using the "OMR.OpticalReader.flatten" method.
  2. Once an image is flattened out, blob detection starts. In the first stage all sizes and kinds of blobs starting from a minimum blob size are detected (this ensures we remove noise grains blobs)
  3. The left edge is detected first and then we detect the right one edge of sheet.
  4. Out of hundreds of blobs detected out of a picture in first filter, the wrong sized blobs are filtered out by checking their size to camera/scanner image's size ratio.
  5. In the second filter, blobs placed on the wrong side of the image are filtered out
  6. In the third filter, blobs having insanely wrong aspect ratios are filtered out (ensuring we detect and reject the blobs produced by bends/lines on sheet)
  7. As a last filter to blobs, all the blobs are compared against a mirrored corner image (mirrored because we inverted the image in first step).
  8. Filtered out blobs are once again, re-verified that they are exactly four in quantity and are placed on the right sides of sheet. Also, left and right edges don't vary too much in their lengths.
  9. Verified blobs represent the real location of sheet corners in image coordinate system.
  10. Images can be cropped through of these points from the unflattened image and wrapped to produce a perfect rectangular image called OMR Sheet.
  11. If all the above filters yield only 4 corner blobs, the process is continued, otherwise a recursive call is made on the same function with the same parameters, but with altered contrast correction that may yield in a better results value.

See the code with line-line comments on the "OMR.OpticalReader.ExtractOMRSheet" method.

Reading the Extracted Sheet

Major image processing lied in the image extraction part. Now the next stage is to read the OMR sheet.

Normally OMR sheets have multiple choices to one question. All the options to same question are printed aside on the paper, forming a "block". All the blocks's locations, sizes and numbers of options given are enough to save it to XML file. Location is recorded according to a coordinate system, usually followed in .NET i.e. upper left corner as O(0,0) (x,y) +ive x asis towards right side, +ive y towards bottom.

To read a specific block in the sheet, (sheet means the extracted sheet in the first section), OMR.OpticalReader.getScoreOfSheet can be called. This method executes the above procedure repeatedly to read all the lines in all of the 4 BigAnswerBlocks printed on the sheet.

Reading The Selected Option Out of the Given Choices 

When a multiple choice selection block is sliced out of the document it's time to read the selected choice. For reading, the block is divided into as many equal parts as there are options present in it. Then the image is converted to binary, based on the mean color of the block. This is how we convert white papers to pure white and more than half the ink-filled pixels to pure black.

The black pixel count is recorded on each subdivision of block.

The darkest block is compared with other blocks and if a remarkable difference exists between the two sub divisions, the darker one is recorded as "Marked". Depending upon the number of Marked choices it can be decided which option was selected.


Take a look at the other methods also. The methods can read all the choices from a single paper sheet in one method call, and create an XML specification sheet for two kinds of sheets given.

The heart of the camera image sheet recognizer lies in the following method.

Points of Interest 

Now, what's next is to make an application that takes a Folder full of answer sheets for a test paper conducted in a class of 50 students or more. Or, have the address of a scanner attached to a PC and one after another start processing images. Depending upon the registration number written on sheet, the program should create an XLS file a PDF so that result is compiled totally electronically.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Written By
Engineer techCREATIONS
Pakistan Pakistan
Developer, Programmer, Beta Tester; technically, i'm none of these. I'm a mechanical engineer, programming is my passion, my hobby and my amateur non profit profession. I program when ii need and innovate whenever, wherever i want.


C#+Applied Mathematicss-Robotics+C++

C# OMR Reader
Monopoly (Urdu language)
HybridAutomation Framework
SMS Bomber (Windows Mobile 6 Professional)
Hard disk watch tower
Farmville Super Clicker
Games Profile selector
Windows mobile salat reminder
Windows mobile SMS Pole Host
and alot of other small apps

Comments and Discussions

GeneralRe: 3Re: How can i can with a sheet A4, 100 questions Pin
umar.techBOY2-Dec-12 3:56
umar.techBOY2-Dec-12 3:56 
GeneralRe: 3Re: How can i can with a sheet A4, 100 questions Pin
Ahmad Fauzi2-Dec-12 13:55
Ahmad Fauzi2-Dec-12 13:55 
GeneralRe: 3Re: How can i can with a sheet A4, 100 questions Pin
umar.techBOY13-Jun-13 19:49
umar.techBOY13-Jun-13 19:49 
GeneralRe: 3Re: How can i can with a sheet A4, 100 questions Pin
umar.techBOY13-Jun-13 20:09
umar.techBOY13-Jun-13 20:09 
GeneralRe: 3Re: How can i can with a sheet A4, 100 questions Pin
Arden Jeric Macapuno22-Feb-13 20:57
Arden Jeric Macapuno22-Feb-13 20:57 
BugI can't download the pdf files. Pin
liorpeleg4-Sep-12 8:25
liorpeleg4-Sep-12 8:25 
GeneralRe: I can't download the pdf files. Pin
umar.techBOY4-Sep-12 9:49
umar.techBOY4-Sep-12 9:49 
QuestionRotation? Pin
Bojan Sala4-Sep-12 0:39
professionalBojan Sala4-Sep-12 0:39 
Does it auto-rotate the image? The aspect ratio between blobs can often be fixed with rotating.

Sorry for not looking into code, I guess someone else will ask the question anyway sooner or later Smile | :) .

Anyways, a very nice article, thanks for sharing it! Big Grin | :-D
AnswerRe: Rotation? Pin
umar.techBOY4-Sep-12 6:35
umar.techBOY4-Sep-12 6:35 
BugError!!!! Pin
AmitGajjar2-Sep-12 19:53
professionalAmitGajjar2-Sep-12 19:53 
GeneralRe: Error!!!! Pin
umar.techBOY3-Sep-12 5:53
umar.techBOY3-Sep-12 5:53 
GeneralRe: Error!!!! Pin
AmitGajjar3-Sep-12 14:56
professionalAmitGajjar3-Sep-12 14:56 
GeneralRe: Error!!!! Pin
umar.techBOY3-Sep-12 22:38
umar.techBOY3-Sep-12 22:38 
GeneralRe: Error!!!! Pin
AmitGajjar3-Sep-12 22:44
professionalAmitGajjar3-Sep-12 22:44 
GeneralRe: Error!!!! Pin
umar.techBOY4-Sep-12 6:36
umar.techBOY4-Sep-12 6:36 
GeneralRe: Error!!!! Pin
swadexi18-Dec-12 22:43
swadexi18-Dec-12 22:43 
GeneralMy vote of 4 Pin
Christian Amado2-Sep-12 5:13
professionalChristian Amado2-Sep-12 5:13 
GeneralMy vote of 4 Pin
fredatcodeproject2-Sep-12 4:40
professionalfredatcodeproject2-Sep-12 4:40 
Questionfile link was broken. Pin
BaeInho2-Sep-12 0:57
professionalBaeInho2-Sep-12 0:57 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.