Exam Printing/Grading Infrastructure
Go to file
adam j hartz bf84236a8f hgignore 2023-08-09 22:10:03 -04:00
gradesoop well, sure, but maybe everything would work better if adam weren't such an idiot 2023-05-24 00:02:32 -04:00
.gitignore reorganize into a pip-installable package 2023-03-18 21:31:25 -04:00
.hgignore hgignore 2023-08-09 22:10:03 -04:00
LICENSE some more metadata 2023-03-18 21:57:27 -04:00
MANIFEST.in typo in MANIFEST.in 2023-03-18 22:20:34 -04:00
README.md readme 2023-03-19 22:15:57 -04:00
requirements.txt requirements 2023-03-22 09:55:31 -04:00
setup.py code formatting 2023-03-18 23:23:02 -04:00


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.