If you have made changes to the configuration for an assignment and
want to reprocess your previous practice submissions, or an error in the
assignment configuration was detected after students submitted
homeworks, you can queue these previous submissions for regrading by
Note that all instructors should be members of the
submitty_course_builders group and thus have limited superuser/sudo
access to run the commands below.
This script takes as arguments, one or more paths pointing to the portion of the course directory structure to be regraded.
For example, to regrade student smithj’s 5th submission for hw02, run this command:
sudo /usr/local/submitty/bin/regrade.py /var/local/submitty/courses/f16/csci1200/submissions/hw02/smithj/5
Instead to regrade every version of student smithj’s hw02, run this command:
sudo /usr/local/submitty/bin/regrade.py /var/local/submitty/courses/f16/csci1200/submissions/hw02/smithj
And similarly, to regrade all students submissions of hw02, run this command:
sudo /usr/local/submitty/bin/regrade.py /var/local/submitty/courses/f16/csci1200/submissions/hw02
You can use wildcards in your pattern as well. To regrade all of student smithj’s submissions for all assignments in the course, run:
The command also works without the escaped wildcard – the wildcard expansion happens on the command line instead of within the python script. Note that the command line expansion may fail if the wildcard expansion exceeds the maximum argument list length.
sudo /usr/local/submitty/bin/regrade.py /var/local/submitty/courses/f16/csci1200/submissions/*/smithj
You may also use a relative path. If you are currently in the
/var/local/submitty/courses/f16/csci1200/directory, you can run:
sudo /usr/local/submitty/bin/regrade.py submissions/hw02/smithj/5
You may also use the optional
--active_onlyflag to skip all versions that are not currently the active version:
sudo /usr/local/submitty/bin/regrade.py --active_only /var/local/submitty/courses/f16/csci1200/submissions/hw02
If the number of submissions matching the specified pattern is greater than 50, the script will require interactive confirmation [y/n] before queueing those homework submissions for reprocessing.
You may also want to use the
grading_done.pyscript to keep track of the progress in reprocessing a large set of submissions.
This command will display the number of grading processes, the number of items waiting in the interactive queue (items recently submitted by students) and in the batch queue (items sent for reprocessing by any instructor).
It is often helpful to combine these two commands, e.g.:
sudo /usr/local/submitty/bin/regrade.py /var/local/submitty/courses/f16/csci1200/submissions/hw02 && sudo /usr/local/submitty/bin/grading_done.py