https://github.com/GregoryCMiller/omr

Bubble Vision: Optical Mark Reader
https://github.com/GregoryCMiller/omr

Last synced: 13 days ago
JSON representation

Bubble Vision: Optical Mark Reader

• Host: GitHub
• URL: https://github.com/GregoryCMiller/omr
• Owner: GregoryCMiller
• Created: 2013-11-13T19:54:11.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2014-05-06T19:02:37.000Z (over 10 years ago)
• Last Synced: 2024-10-13T14:56:44.671Z (about 1 month ago)
• Language: Python
• Homepage:
• Size: 16.5 MB
• Stars: 46
• Watchers: 7
• Forks: 25
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
==================================

Bubble Vision: Optical Mark Reader

==================================

Extract answer choices from scanned jpg bubble forms.

Graphical User Interface

------------------------

::

    

    $ omrcmd.py

Command Line

------------

::

    

    $ omrcmd.py [options] imagedir

imagedir           

  Input image directory (front side). Lowest numbered image identifies the key.

`--backdir=BACKDIR`

  Optional back side image directory                                                

`--form=FORM`        

  Set the form string (default and only supported="882E")                       

`--help`             

  Show this help message and exit                                               

Output

------

validation images

    Answer bubble means and reference box fits drawn over each input

    image.

    

results.xlsx

    summary            

        Image path, name box image, and total score for each test.

    

    questioninfo       

        Answer choice counts by question. Key excluded.

    

    scoring            

        Answer choice matches key (0/1). Same indices as choices. Score

        is 0 if key is -1.

    

    choices            

        Answer choice matrix. Tests in rows and questions in columns.

        0-4=A-E, -1=n/a.

Install

-------

::

    

    $ pip install omr

    $ pip install --upgrade omr

    $ pip uninstall omr

    

* Requirements

  * `python `_ 2.7+

  * `pip `_ ``$ easy_install pip``

* Dependencies (installed by pip)

  * `numpy 1.8.0 `_ multidimensional numerical array object. 

  * `openpyxl 1.6.2 `_ read and write excel xlsx files.  

  * `pillow 2.2.1 `_ image manipulation. 

  * `yaml 3.10 `_ human friendly data serialization.

  

Example Validation Image

------------------------

.. image:: https://raw.github.com/GregoryCMiller/omr/master/ExampleValidation.jpg

Troubleshooting

---------------

* Windows 

  * ``$ omrcmd.py --help`` gives ``omrcmd.py: error: too few arguments``

    

    * fix argument passing to "py" file associations from ``python %1`` to ``python %1 %*``

    

  * ``unable to find vcvarsall.bat``

    

    * I was able to use ``$ easy_install Pillow`` when pip failed to install Pillow 2.2.1

    

Author

------

Greg Miller [email protected]