Submitty supports instructor upload of bulk PDF files to then be divided into individual assignment PDFs and assigned to students.

If there is TA grading, questions can also be assigned page numbers by either instructor or student. In the TA grading interface, clicking on a question will open the corresponding page in the PDF.

Preparing the Exams for Scanning

Tips for Scanning

Explore the options / settings on your scanner. Things to check:

Scanning with the ScanSnap iX500 on Linux

We use the ScanSnap iX500 for scanning our exams. This works with SANE out of the box; a variety of of front-ends for SANE exist that work well with this printer. Simple-scan works fairly well - you will need to make sure to select the scanner in its preferences and set it to scan ‘Both’ sides of each page; you can then ‘scan all pages from feeder’ and then export multiple exams into one PDF, for bulk uploading.

Scanning with 150DPI for text and photos generates reasonably sized files - most PDFs generated are between 25 and 35MB for 140 pages.

Additionally, simple-scan dumps a lot of autosaved files into ~/.cache/simple-scan/ (roughly 6.5GB of temporary files were generated in one night, with about 650MB of outputted files). This balloons pretty quickly and required clearing that out every few times a PDF was exported.

Creating PDF assignments

Config:

For exams/quizzes/assignments where the instructor will bulk upload large multiple exam/assignment PDFS, use

/usr/local/submitty/more_autograding_examples/pdf_exam/config

This makes sure the file size is adequate. Otherwise, using

/usr/local/submitty/more_autograding_examples/upload_only/config

will suffice.

View/submit/download/version settings:

In summary,

Setting Student View Student Submit Student Download Student Version
Default Yes Yes No Any version
Exam/quiz/etc. No until grades are released, then Yes No Yes Active version only

Pages assigned to components:

For “Is this a PDF with a page assigned to each component?”, select Yes if this is a PDF upload where each component has an assigned page.

If yes, the question “Who will assign pages to components?” appears. The two options are either instructor (such as an exam/quiz/any instructor uploaded PDF) or student (any student uploaded PDF).

If the instructor assigns pages, then for each component there is input for the page number the component corresponds to. If it spans multiple pages, input the first page the component appears on.

If the student assigns pages, then on homework submission page students will have input boxes for each component, and those will be saved to a json called student_pages.json within their submissions folder.

TA grading

In the TA grading interface, if any pages are assigned to a component, clicking on a component will bring you to the assigned page.

Bulk PDF Upload

On the gradeable submission page, the instructor has three options: Normal Submission, Make Submission for a Student, and Bulk Upload. For uploading bulk PDFs for exams/quizzes/assignments, select Bulk Upload.

Input the number of pages for each exam/quiz/assignment.

In the drag and drop box, upload the bulk exam PDF. You may submit more than one PDF at once, but the box’s maximum total size is 10Mb.

On submit, the bulk PDF is uploaded to the course’s /uploads/bulk_pdf/gradeable_id folder and the split PDF items to /uploads/split_pdf/gradeable_id folder.

After the page reloads, another section on the page will appear called “Unassigned PDF Uploads”.

Split item submission

The “Unassigned PDF Uploads” section contains all items within the /uploads/split_pdf/gradeable_id folder.

PDF preview contains the first page of the pdf. If you want to view the full PDF, click on the popout icon. To submit for a student, enter their user ID and press enter or click submit. Autofill for user ID brings up students who do not yet have any submissions for this gradeable.

Once submitted, the split PDF item is moved from /uploads/split_pdf/gradeable_id to its corresponding location in the /submissions/gradeable_id/user_id folder.