Difference between revisions of "OMR templates"
From OpenKM Documentation
(→Step 1 - Create template) |
|||
| Line 12: | Line 12: | ||
* On the original printout, color all the marks with a black pen, and scan this marked up printout. Please be as careful as you can to align the printout so that there is no rotation. Some amount of error is fine, but not too much! This scanned image will be the template. | * On the original printout, color all the marks with a black pen, and scan this marked up printout. Please be as careful as you can to align the printout so that there is no rotation. Some amount of error is fine, but not too much! This scanned image will be the template. | ||
| − | [[File:2circle-org-colored-whole. | + | [[File:2circle-org-colored-whole.png]] |
== Step 2 - Upload template == | == Step 2 - Upload template == | ||
Revision as of 16:00, 29 April 2013
OpenKM integrates OMR ( Optical Mark Recognition ) that has been written by Aaditeshwar Seth from the Udai Waterloo chapter, at the University of Waterloo. Udai is a volunteer student organization at the University of Waterloo in Canada and the University of California at San Diego. For more information about it see OMRProj website.
OMR ( Optical Mark Recognition ) engines is especially suited for extracting data from forms that have been photo-copied and then scanned; hence, the resultant images are likely to suffer from rotations, smudge marks, and random lines here and there. Examples of a few forms that the tool is able to handle with 100% accuracy are shown here.
Contents
Step 1 - Create template
- First make a form in powerpoint using the template File:Omr patterns.zip. Make sure that you do not move the two concentric circles in the top-left and bottom-right corners of the template. These are used by the software to determine the angle of rotation of the form.
- Take a printout and make as many photocopies of the form as you want.
- On the original printout, color all the marks with a black pen, and scan this marked up printout. Please be as careful as you can to align the printout so that there is no rotation. Some amount of error is fine, but not too much! This scanned image will be the template.
Step 2 - Upload template
Click add icon 
The training process will generate two files .asc and .config
Step 3 - Update asc file
Download the .asc file and openkm with a standard text editor. This is actually an ascii representation of the template with all the marks marked with a '0', as shown below.
--------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --0----0----0----0----0--------0----0----0----0----0---------0----------------0-------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------------0--0--0---0--0---0--0---0--0---0--0-----0---0--0---0--0---0----- --------------------------------------------------------------------------------------- ---0--------0----------0--0--0---0--0---0--0---0--0---0--0-----0---0--0---0--0--0------ --------------------------------------------------------------------------------------- ----------------------0---0--0---0--0---0--0---0--0--0---0-----0---0--0---0--0--0------ --------------------------------------------------------------------------------------- ----0----------0-------0--0--0---0--0---0--0---0--0--0---0-----0---0--0--0---0--0------ --------------------------------------------------------------------------------------- -----------------------0--0---0--0--0---0--0---0--0---0--0-----0---0--0---0--0---0----- --------------------------------------------------------------------------------------- -----------------------0--0---0--0---0--0--0---0--0---0--0-----0---0--0---0--0---0----- --------------------------------------------------------------------------------------- -----------------------0--0---0--0--0---0--0---0--0---0--0-----0---0--0---0--0---0----- --------------------------------------------------------------------------------------- -----------------------0--0---0--0---0--0--0---0--0---0--0-----0---0--0---0--0---0----- --------------------------------------------------------------------------------------- ----0--------0---------0--0---0--0--0---0--0---0--0---0--0-----0---0--0---0--0---0----- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------0----------------------0--------------------------0--------------0---- --------------------------------------------------------------------------------------- -----------------0----------------------0--------------------------0--------------0---- --------------------------------------------------------------------------------------- -----------------0----------------------0-----------------------------------------0---- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------0----------------------0-----------------------------------------0---- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------0-------------0---------------0-----------------0----------------0---- --------------------------------------------------------------------------------------- -----------------0-------------0---------------0----------------0-----------------0---- --------------------------------------------------------------------------------------- ----------------0-----------------------------0------------------0----------------0---- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- ------------------0------------0------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------0-------------0------------------------------------------------------- --------------------------------------------------------------------------------------- ------------------0------------0------------------------------------------------------- --------------------------------------------------------------------------------------- ------------------0-------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------
Some of the marks may not be exactly aligned, but don't worry. Now, very carefully, label the marks with single characters, by setting all the marks in the same group with the same character. This is shown below. In case you run out of alphabets, you can use numerals or any other character such as - + ? . etc. Make sure that you do not alter the position of any mark! This is agreably hard to do, but we chose this method to avoid the need for making a graphical frontend.
--------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --a----a----a----a----a--------b----b----b----b----b---------c----------------c-------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------------f--f--f---f--f---f--f---f--f---f--f-----h---h--h---h--h---h----- --------------------------------------------------------------------------------------- ---d--------d----------f--f--f---f--f---f--f---f--f---f--f-----h---h--h---h--h--h------ --------------------------------------------------------------------------------------- ----------------------f---f--f---f--f---f--f---f--f--f---f-----h---h--h---h--h--h------ --------------------------------------------------------------------------------------- ----e----------e-------f--f--f---f--f---f--f---f--f--f---f-----h---h--h--h---h--h------ --------------------------------------------------------------------------------------- -----------------------f--f---f--f--f---f--f---f--f---f--f-----h---h--h---h--h---h----- --------------------------------------------------------------------------------------- -----------------------f--f---f--f---f--f--f---f--f---f--f-----h---h--h---h--h---h----- --------------------------------------------------------------------------------------- -----------------------f--f---f--f--f---f--f---f--f---f--f-----h---h--h---h--h---h----- --------------------------------------------------------------------------------------- -----------------------f--f---f--f---f--f--f---f--f---f--f-----h---h--h---h--h---h----- --------------------------------------------------------------------------------------- ----g--------g---------f--f---f--f--f---f--f---f--f---f--f-----h---h--h---h--h---h----- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------i----------------------j--------------------------k--------------l---- --------------------------------------------------------------------------------------- -----------------i----------------------j--------------------------k--------------l---- --------------------------------------------------------------------------------------- -----------------i----------------------j-----------------------------------------l---- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------i----------------------j-----------------------------------------l---- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------q-------------p---------------o-----------------n----------------m---- --------------------------------------------------------------------------------------- -----------------q-------------p---------------o----------------n-----------------m---- --------------------------------------------------------------------------------------- ----------------q-----------------------------o------------------n----------------m---- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- ------------------r------------s------------------------------------------------------- --------------------------------------------------------------------------------------- -----------------r-------------s------------------------------------------------------- --------------------------------------------------------------------------------------- ------------------r------------s------------------------------------------------------- --------------------------------------------------------------------------------------- ------------------r-------------------------------------------------------------------- --------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------
Click edit icon 
:
Click edit asc file icon :
Select asc file and click send button.
Step 4 - upload .fields file
You now need to make a [template-filename].fields file, which contains the details of the various form-fields, as follows.
The format of each line is: character type subtype name value1 value2....
- Character: This is the same as the character you used in the .asc file
- Type and Subtype: The types of fields supported are single and multiple choice lists, aligned row-wise (horizontally) or column-wise (vertically). And grids aligned horizontally or vertically. Each field is denoted by (i) row single or row multiple for a single or multiple selection field aligned row-wise, (ii) column single or column multiple for a single or mutiple selection field aligned column-wise, or (iii) grid row or grid column for a grid field aligned row-wise or column-wise respectively.
- Field name: This can be any name you want to associate with the field.
- Values: These are the field values, in order.
Click edit icon :
Click edit fields icon :
Select fields file and click send button.
Step 5 - check template
Click check icon 
:
Upload some file to recognise values:
And you'll get the results:
