Export the ‘Grade Summaries’ (complete data for each student) Go to the Submitty website. Click ‘Grade Reports’ from the left sidebar. Then Click “Generate Grade Summaries”. Once the grade summary reports have been created, the browser will finish reloading the page and display a green box with “Successfully Generated Grade Summaries” in it. Currently this box disappears automatically a few seconds after is is loaded.
Those json files are saved on the server here:
In order to run RainbowGrades on your local machine, you’ll need to install
Obtain the Rainbow Grades Chart Software
On your local computer (recommended so you can preview the results before posting), clone both the Submitty/Submitty repository and the Submitty/RainbowGrades repository. We recommend you put this in a convenient top-level directory, separate from the materials for a specific course. These directories should be in neighboring folders, e.g.:
Make a directory for preparing the grades
This should not be within either of the Submitty repository checkouts above.
If you have a repository/dropbox for your course, put it there (and then you can backup the configuration files)
SAMPLE_customization.jsonfiles from the RainbowGrades repository to that new directory (in the instructions below we’ll assume you called the directory
grades_summary). Change the names to
Edit the Makefile
Set the variables at the top of the file (
If you are not a developer, jump to step 5 after setting these variables.
Note (FOR DEVELOPERS ONLY): When using the development VM, you can connect to the server as the instructor user:
ssh -p 2222 email@example.com
And copy files as the instructor user:
scp -P 2222 -r firstname.lastname@example.org:/var/local/submitty/courses/<SEMESTER>/<COURSE>/<ETC> <DESTINATION>
Download the per student grade summary text files from the server
This will ask for your password on the server, and then it should copy those files to this local directory:
Start your customization
In order to run Rainbow Grades you will need to set up a
customization.jsonfile. While we provide a sample file as a starting point, you will need to make changes in order to tailor Rainbow Grades for your course. Starting details are on the Customization Basics page.
Add in gradeables
Once you’ve set up general course information, you’ll want to focus on adding gradeables to your
customization.jsonfile. This array describes each assignment to Rainbow Grades. You will likely update this many times throughout the semester.
Other customization extras
customization.jsonsupports other options. While the list may evolve over time, we currently provide documentation for assigned exam seating.
Generate the reports.
This will produce an overall spreadsheet-like view for the instructor:
Note: This file is automatically archived/backed up/saved with today’s date here:
It will also produce 3 files per student:
grades_summary/individual_summary_html/<student>_summary.html grades_summary/individual_summary_html/<student>_message.html grades_summary/individual_summary_html/<student>_message.json
Examine the html files. Change
Upload the files to the server.
- Confirm the individual
<username>_message.htmlfiles have been copied here:
From the “Course Settings” tab (leftmost tab in the instructors black option bar), make sure the “Display Rainbow Grades Summary” option is checked (so the students can see the file).
View the student-facing submission site and confirm that the data in
<username>_message.htmlis presented at the top of the main Submitty page, and
<username>_summary.htmlis presented to the student when they press the “View Grades” button on the main page.
By default, the instructor table is sorted by overall grade. But you can sort the list in different ways:
To group by section, then sort alphabetically (useful to enter final grades!)
To sort by specific gradeable:
make lab make hw make test make quiz make exam make reading make project