gradeR package helps grade your students’s assignment submissions that are
R Scripts (
.R files). If you want to use
gradeR for grading submissions on your own laptop or desktop, please see the vignette here. Instead, this vignette describes how to use the Gradescope autograder with a helper function from
If you have already read the “getting started” vignette, and you work for an institution/university that has an appropriate subscription to this service, then this is probably useful information for you.
For each assignment you make, you might consider cloning this repository, modifying the student-facing assignment provided in
example_hw_assignment/, and then modifying the files required by Gradescope provided in
Students submit their assignments to Gradescope, and afterwards, their code is run and checked on Gradescope servers. The benefit is that students get feedback much more quickly, and your computer doesn’t need to stay busy all day running student code.
The downside is that everything becomes a bit more complicated–but that’s what this repository is for. It provides a template for each assignment: both the student-facing assignment description, as well as the the code you have to give Gradescope.
setup.sh is a Linux Bash script that the Gradescope servers run to install
R and any
R packages that are required. For those of you have little to no experience with shell scripting, do not despair! This repository provides an example file (see here) that will be easy to modify. Note that the name of this file must be
setup.sh because that is what Gradescope expects.
The file with all of the tests. This can have any name you want, and it will usually change depending on what assignment you’re grading. In this example, we call it
assignment1_grading_file.r. This file contains
testthat tests, which is another
R package that
gradeR depends on. The example should be pretty self explanatory, but for those looking for more detail, see the original
gradeR vignette, or the documentation for the
testthat package. Note that by default, each test case has its visibility set to “after_due_date.” If you would like a test to be visible to the students before the deadline has passed, make sure to include the phrase
(visible) in the name of the particular test. Other options include
(after_published). For more information on visibility options, see the Gradescope documentation available here.
.R file that grades a single student submission. This can be named anything you want, too, but we call it
grade_one_submission.r. Thanks to
gradeR, this one is pretty simple–it just calls
gradeR::calcGradesForGradescope(). This function runs a single student’s
.R file submission, checks it against the provided
testthat tests, and nicely formats the output in a way that Gradescope expects.
run_autograder is another Bash script that Gradescope’s Linux servers run. This file must have this name, because Gradescope expects this. This small program is run every time a single student submission needs to be graded. It copies a single student submission into the directory that the Gradescope server expects, and then it runs the previously-mentioned file (
Extra data files need to be included too. For example, our example homework assignment asked students to read in the file called
data.csv. This particular csv file can be found in our directory with all the other autograding files.
After all of these files have been written, they are then compressed into a single
.zip file (as described by Gradescope here), and then uploaded to Gradescope. Gradescope takes care of the rest.
Note that it is still possible to use Gradescope’s autograder without the
gradeR package. For an example of how to do that, please see this Github repo.
To make your own assignment, log on to Gradescope and then start a new programming assignment. Then, download/clone this repository and make some customizations to the files. After you have made the changes, zip those files up, and upload it to Gradescope.
A word of warning: uploading the zip file can take several minutes.
If you are unfamiliar with their website, please see the instructions that they provide here.
There are a few things to do when you customize this to your own assignment:
Make sure that each student’s submission is named the same. In our example, we assume all submissions are named
grade_one_submission.r references the correct filenames. For us, we chose
Make sure your assignment instructions feature the same warnings in our example assignment here. This isn’t absolutely required, but it is helpful for the students.
Make sure your
setup.sh installs all packages that student code requires.
run_autograder uses the correct filenames. The directories are what Gradescope expects, so don’t change those.
Double check your test visibilities. Remember, by default all tests are only shown after the due date has passed. If you would like a test to be visible, just insert the phrase “(visible)” into the name of the test file. For example, that is done on the first test here.. Personally, I usually make a few of the easy tests visible, just to make sure that students know before the deadline that “Gradescope” was able to run their script successfully.
Make sure the max score you enter on Gradescope is the same as the total number of tests you have.