Exam Printing/Grading Infrastructure
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
adam j hartz 604a1272df
actually fix?
2 days ago
gradesoop actually fix? 2 days ago
.gitignore reorganize into a pip-installable package 1 week ago
LICENSE some more metadata 1 week ago
MANIFEST.in typo in MANIFEST.in 1 week ago
README.md readme 6 days ago
requirements.txt requirements 4 days ago
setup.py code formatting 1 week ago


gradesoop: grading of printed exams within catsoop



install prereqs and the gradesoop package:

$ sudo apt install poppler-utils libzbar-dev git
$ pip install git+git://catsoop.org/gradesoop.git

this will install the gradesoop command, which is the entry point for all of the pdf processing stuff. run the following to get started:

$ gradesoop --help


all of the subcommands have a --help flag that shows usage, arguments, and options. here they are, roughly in the order they're needed:

  • gradesoop add-qrs for adding qr codes to exams
  • gradesoop parse-scans for reading and organizing raw scan data
  • gradesoop separate for generating per-student pdfs from scan data
  • gradesoop setup-catsoop-course for adding the web interface to a course (NOT YET IMPLEMENTED)


the first version of gradesoop was started in spring 2016 and was developed primarily by a collection of dedicated 6.01 ta's: Rodrigo Toste Gomes, Gustavo Goretkin, Jeremy Kaplan, Kade Phillips, and Jeremy Wright. much of the code has been rewritten, but the current version is resting comfortably on the shoulders of their work.