ExamScan

A Python 3 script to evaluate single and multiple choice exam sheets.

Example

Input image:

Processed image:

Usage

main.py (-u URL | -f FILE) -n NUM [-h] [-i IOUT] [-d DOUT] [-c COMP] [-p]

Flags:

Required, but mutually exclusive flags:

Short	Long	Description
-u URL	--url URL	URL to the image or pdf to be evaluated
-f FILE	--file FILE	path to the image or pdf to be evaluated

Required flags:

Short	Long	Description
-n NUM	--num NUM	number of answers per question

Optional flags:

Short	Long	Description
-h	--help	shows help message and exits
-i IOUT	--iout IOUT	path for the output picture to be stored.
-d DOUT	--dout DOUT	path for the output data to be stored.
-c COMP	--compare COMP	compares the calculated result to a given result
-p	--plot	plots every single step

Requirements:

Module	Pip	Git
OpenCV	opencv-python	skvark/opencv-python
NumPy	numpy	numpy/numpy
Matplotlib	matplotlib	matplotlib/matplotlib
imutils	imutils	jrosebr1/imutils
python-magic	python-magic	ahupp/python-magic
pdf2image	pdf2image	Belval/pdf2image