A professor encouraged me to write a software implementation of a scantronmachine. It's licensed under the ISCor MIT licenses. The goal was to scana PDF of the key and all the students' sheets, grade, email the students theirgrade and a copy of their sheet, and then display statistics about the exam.While the program doesn't quite do all that, it does grade scanned formsand provide a website interface for convenience. Feel free to try it out andimprove it.

Errors and Results. Download software uses components of ScanTools software to access existing applications and edit profiles, and to. ScanTools software does not need to be running for Download software to use these components. Scantron Test Grading Manual Scantron Preparation. The Scantron uses the ParScore software, available on the computer right next to the Scantron. The first step is to open this software. The Scantron can score approximately 60 forms at one time. If you have a larger class, it will need to be broken up a bit. Put the first pile of sixty.

At the moment this only supports one type of form available directly fromApperson or inwebsite/files/form.pdf.

Using

You can either use this as a command-line utility or run it as a daemonproviding a website interface.

Dependencies

a C++11 compiler
CppDB (Boost or MIT)
CppCMS (LGPL)
PoDoFo (LGPL)
OpenIL/DevIL (LGPL)
libtiff (custom: http://www.libtiff.org/misc.html)

Note: PoDoFo must be compiled with C++11 not C++98 otherwise it won't extract images. You can modify the CMakeLists.txt file. For Arch, look at my PKGBUILD for podofo-cpp11 and for freetron.

Compiling

make:make; make install
cmake:cd cmake; cmake .; make; make install

I have tested g++ and clang++ on Linux. For Mac you'll find most of thedependencies in Macports, Fink, Homebrew, or whatever you use, but you'llprobably have to build CppCMS and CppDB. On Windows you'll have to buildbasically all of these.

Note: Use cmake if you want the keys generated on install; otherwise,use make and then generate the keys and put them in /srv/freetron orwhatever website directory you choose:

Running

Website interface: ./freetron --daemon website/
Command line interface: ./freetron -i KeyID form.pdf

Example

Download a computer-generatedform or a scannedform created from the Appersonform mentioned above. Below is the output of these two example forms. The firsttakes about 1 second and the second about 3 seconds on my computer.

If you specify the -d option, it'll generate debug images, which allows youto find any problematic bubbles or boxes. Below is the output from the thirdpage of the example scanned form. Note that since OpenIL doesn't allowmulti-threading, this greatly extends the run time.

If you run the examples in the website, you get:

Navigating the Code

If you want to extend or modify this program, this summary of what thedifferent portions do may be useful.

options -- All parameters for the supported style of forms (e.g. bubbleaspect ratio)

Core functionality

extract -- Extract the images from the PDF
processor -- Manage the extracting and processing threads, what to do witheach image, etc. Basically, if you want to extend this program, you would addadditional code to the end of parseImage.
read -- Find filled bubbles for the answers, ID, etc. on the form.
rotate -- Determine the rotation from the list of black boxes on the leftand bottom of the form.

Image processing

Scantron Score It Software Download Windows 7

blobs -- Connected-component labeling of black objects in image
histogram -- Self explanatory
box -- Taking a starting pixel, determine if the object that point is apart of is actually one of those black boxes on the left and bottom.
outline -- Contour tracing. Given a starting point, get a vector of pointson the boundary of that object.
boxes -- Find the blobs and determine if each is a box.

Data structures

forms -- Each form (on the command line you will have only one) stores allthe information needed about it and the individual pages of that form.
pixels -- Data structure for storing pixel data
data -- Data structures for coordinates, answers, etc.
disjointset -- Used in the connected-component labeling.

Scantron Score It Software Download Full

Utilities

Scantron Score It Software Download For Laptop

log -- Log messages will be put at end of output
maputils -- Iterators and whatnot
math -- All the distance, average, stdev, etc. functions
threadqueue(void) -- Run the processing in a number of threads.
cores -- Get the number of cores for determining the number of threads touse.

Website

Scantron Score It Software Download

The website uses CppCMS, so you may want to become acquainted with that tounderstand this code.

website -- Main website application
rpc -- Get/set data for Javascript RPC
database -- Manage saving/reading database information using CppDB
date -- Access the date in a thread-safe way
content, skin, *.tmpl, *.js, *.css -- For the pagetemplates and website design