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
If you notice a student has extra pages or missing pages, or the exam is rather crumpled, set them to the side for individual scanning at the end.
Scanning ~100-150 pages at a time works well, so for example if your exam is 14 pages (7 sheets of paper, front & back), separating the paper exams into stacks of 7-10 works well.
Make most stacks the exact same count, and make sure the person working the scanner knows how many pages to expect per pack (e.g. 98 pages or 140 pages). The scanner person should check the page count after each scan and try to catch problems early.
Use scissors to cut the staple corner off the exams. IMPORTANT: Carefully cut off the smallest amount of paper with the staple. If you cut too much, the scanner feeder might fail to load the sheets of paper. Tap the exam papers on a table to align the sheets and make it less likely to jam or crumble in the feeder when scanning.
Put a post-it note on the cover of the first exam of each page (remove the post-it for the actual scan), and give a letter/name to each exam pile. Have that name match the scanned file name (either change the file name or write the scanner-generated name on the postit after scanning). This will help tracking down the pile if it needs to be re-scanned because of stuck pages or scan quality settings.
Optional: Re-staple the exams after scanning. Note: This is less necessary if you’ve pre-printed exams with each students name on every page.
Tips for Scanning
Explore the options / settings on your scanner. Things to check:
150-300 dpi works well for most exams (300 dpi might be necessary for students with small cramped handwriting).
Choose gray scale scanning (not black & white).
You may want to adjust the brightness / contrast to be sure to pick up light handwriting.
Choose duplex mode (double sided scanning). Even if your exam is single sided, the students might write on the back.
Specify “Do not rotate”. Some scanners will attempt to detect rotated pages and make errors rather than correct actual rotated pages.
Make sure “Blank page removal” is not selected. This will only throw off the page count!
Choose a new directory to save your scans. Scans should hopefully be sequentially numbered, or named with the timestamp to facilitate orderly upload to Submitty.
Scanning with the ScanSnap iX500 on Linux
We use the portable 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 scanner. 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 with the photo setting generates reasonably sized files - most PDFs generated are between 25 and 35MB for 140 pages.
Make sure you select ‘Photo’ from the Scan settings dropown in the top left corner:
And in the preferences menu, under Quality, select 150 dpi and adjust the brightness and contrast:
Check the quality and brightness/contrast of your initial scan. The background of white paper should scan light grey to ensure you pick up light pencil marks and erased writing. Make sure that the output pixel values are true greyscale. If your pixels are clamped to black and white or clamped to a few shades of grey you will likely struggle to read the full range of pencil markings.
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
For exams/quizzes/assignments where the instructor will bulk upload large multiple exam/assignment PDFS, use
This makes sure the file size is adequate. Otherwise, using
“Should students be able to view submissions?” controls whether students can see the gradeable. If this is for an exam/quiz/any instructor uploaded PDF, the recommended process is selecting No to start with then changing to Yes once grades have been released.
“Should students be able to make submissions?” controls whether students can make submissions. If this is for an exam/quiz/any instructor uploaded PDF, select No.
“Should students be able to download files?” controls whether students can download submission files. If this is for an exam/quiz/any instructor uploaded PDF, select Yes if you want to allow students to see their uploaded exams.
“Should students be able to view/download any version or just the active version?” controls whether students can view/download any or all versions. If this is for an exam/quiz/any instructor uploaded PDF, select Active version only.
|Setting||Student View||Student Submit||Student Download||Student 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.
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
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
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
Bulk Upload and Split with QR codes
For large bulk uploads or PDF’s that need to be split into different sizes, there is an option to use QR codes instead of a fixed page count. This can be choosen by selecting ‘bulk upload’ in the upload section for assignments then checking the ‘split with qr codes?’ box.
There are optional prefix and suffix text areas can remove parts of the string contained within the QR code. For example if your QR code contained the string
f18_12_student123 and your prefix was
f18_12_ the resulting string would be
If you are using a URL in your QR code, the prefix and suffix boxes can remove URL components, for example
https://student123.com/image.png will result in
student123 if the prefix is
https:// and the suffix is
Note: the prefix substring must exactly match with a substring at the beginning of the QR string and the suffix must match a substring from the end, otherwise they will not be removed from the QR string.
After processing, the
student_id text area will be autofilled with the string contained in the QR code along with a pagecount. Invalid user ID’s will be highlighted in red.
Check out our work-in-progress instructor tool for preparing customized exams with QR codes: