Giter Site home page Giter Site logo

paranjay14 / omrchecker Goto Github PK

View Code? Open in Web Editor NEW

This project forked from udayraj123/omrchecker

0.0 1.0 0.0 3.22 MB

Grade exams fast and accurately using a scanner ๐Ÿ–จ or your phone ๐Ÿคณ.

License: GNU General Public License v3.0

Python 100.00%

omrchecker's Introduction

OMR Checker

Grade exams fast and accurately using a scanner ๐Ÿ–จ or your phone ๐Ÿคณ.

Accurate RobustLarge_Scale Fast Lightweight Extensible

UserGuide PRs Welcome GitHub stars

TLDR; Jump to Getting Started.

Code in action on images taken by scanner: ๐Ÿ”ฅ

document_scanner

Code in action on images taken by a mobile phone: ๐Ÿ”ฅ

checking_xeroxed_mobile

๐ŸŽฏ Features

Current_Speed Current_Size Min Resolution

A full-fledged OMR checking software that can read and evaluate OMR sheets scanned at any angle and having any color. Support is also provided for a customisable marking scheme with section-wise marking, bonus questions, etc.

๐Ÿ’ฏ Accurate - Currently nearly 100% accurate on good quality document scans; and about 90% accurate on mobile images.

๐Ÿ’ช๐Ÿฟ Robust - Supports low resolution, xeroxed sheets. See Robustness for more.

โฉ Fast Current processing speed without any optimization is 200 OMRs/minute.

โœ… Extensible - Easily apply to different OMR layouts, surveys, etc.

๐Ÿ“Š Visually Rich Outputs - get insights to configure and debug easily.

๐ŸŽˆ Lightweight - Core code size is less than 500 KB(Samples excluded).

๐Ÿซ Large Scale - Already used on tens of thousands of OMRs at Technothlon.

๐Ÿ‘ฉ๐Ÿฟโ€๐Ÿ’ป Dev Friendly - Well documented repository based on python and openCV.

Devs can look at TODOs for live challenges. See more at Project Wiki.

For any help: Join

Getting started

Setup Time

Operating System

Although windows is supported, Linux is recommended for a bug-free experience.

1. Install dependencies

opencv 4.0.0 python 3.4

Note: To get a copy button for below commands, use CodeCopy Chrome | CodeCopy Firefox.

python3 -m pip install --user --upgrade pip
python3 -m pip install --user opencv-python
python3 -m pip install --user opencv-contrib-python

More details on pip install openCV here.

Note: On a fresh computer some of the libraries may get missing in above pip install.

Install them using the following commands: Windows users may skip this step.

sudo apt-get install -y build-essential cmake unzip pkg-config
sudo apt-get install -y libjpeg-dev libpng-dev libtiff-dev
sudo apt-get install -y libavcodec-dev libavformat-dev libswscale-dev libv4l-dev
sudo apt-get install -y libatlas-base-dev gfortran

2. Clone the repo

git clone https://github.com/Udayraj123/OMRChecker

Install other requirements

imutils 0.5.2 matplotlib 3.0.2 pandas 0.24.0 numpy 1.16.0

cd OMRChecker/
python3 -m pip install --user -r requirements.txt

Note: If you face a distutils error, use the --ignore-installed flag

sudo python3 -m pip install --ignore-installed -r requirements.txt

3. Run the code(on sample images)

  1. Copy sample data:
    cp -r inputs/samples/sample1/* inputs/
    Note: If you are not running this for the first time, delete previous inputs first
    mv inputs/OMR_Files/ ~/.trash # can delete permanently using: rm -rf inputs/OMR_Files/
    
    cp -r inputs/samples/sample1/* inputs/
  2. Run OMRChecker: python3 main.py
  3. ???
  4. Profit!!

Note: For subsequent runs, if you don't want the outputs to append to previous results- Make sure the outputs folder is clean : rm -rf outputs/.

Applying it on your own OMR Sheets

  1. Follow the User Guide to create your own Template Layout.
  2. Open globals.py and play with the parameters (although most of them would need no change ๐Ÿ˜„)
  3. Run the code with appropriate arguments.

๐Ÿ’ก What can OMRChecker do for me?

Once you configure the OMR layout, just throw images of the sheets at the software; and you'll get back the graded responses in an excel sheet!

Images can be taken from various angles as shown below-

sample_input

These images will be processed in the following manner:

rotation_stack
*Note: This image is generated by the code itself!*

Finally a CSV file will also be generated containing all the responses and scoring

csv_output

There are a lot more visuals in the wiki. Check them out!

๐Ÿ’ก Why is this software free?

Our Motto:

Don't reinvent the wheel, use good wheels to make great vehicles!

After seeing it work fabulously at large scale on scanned OMR sheets at Technothlon, we have decided to open source the code and roll out mobile based scanning as well. The feedback from you all will be extremely valuable in making this idea become successful.

Can I use this code in my work?

Open Source Love svg1

OMRChecker is completely open source and published under GPLv3 license which is just to give you a heads up to disclose usage of this software in your code.

OMRChecker can be forked and modified. You are encouraged to play with it and we would love to see your own projects in action!

Credits

A Huge thanks to : The creative master Adrian Rosebrock for his blog : https://pyimagesearch.com

The legendary Harrison aka sentdex for his video tutorials.

And the james bond of computer vision Satya Mallic for his blog: https://www.learnopencv.com

And many other rockstars without whom this project would never have completed.

Thank you!

License

Copyright ยฉ 2019 Udayraj Deshmukh
OMRChecker : Grade exams fast and accurately using a scanner ๐Ÿ–จ or your phone ๐Ÿคณ
This is free software, and you are welcome to redistribute it under certain conditions;

For more details see GitHub license

Related Projects

Here's a sneak peak of the Android OMR Helper App(WIP):

Activity:

Discord Group: Chat Ask me

HitCount Maintenance GitHub pull-requests closed GitHub issues-closed GitHub contributors

Help us reach 550 stars โญ to become #1 (Currently #4) on the "OMR" tag on github GitHub stars

To keep my ๐Ÿ’ก brain juices flowing and create more such projects, โ˜• Buy Me A Coffee

If this project saved you large costs on OMR Software licenses, or saved efforts to make one, or simply want to give me some credit: paypal

Note: As per non-profit traditions of Technothlon, all of your your donations will go into funding good initiatives in the future.

omrchecker's People

Contributors

udayraj123 avatar sparsh2706 avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.