Reading the gradebook

Where scores come from

A score is the passed/total from a graded run of an assignment's tests. Graded runs happen when:

• You click Regrade all on an assignment's Student work tab, for every student, or Run all tests on the class's Gradebook tab, for every assignment and every student.
• The due date passes with Close at due date on, which it is by default once you set a due date. CS Room grades everyone at the deadline and locks the results.

Scores are not live. They show the last graded run, so run tests again to pick up work a student has done since. A locked grade does not change when tests run again.

Students check their own work with the Run Tests button in their workspace, which appears once the assignment has visible tests. It runs only those, shows the student the output and records nothing, so a student cannot give themselves a grade.

Student work

An assignment's Student work tab lists every student. Once a student has submitted or has a locked grade, their row shows a passed/total and a bar, green for a full pass, amber for partial and red for zero. Until then it shows a dash.

Click a row to expand it. Submitted shows the snapshot the student turned in, and Live files shows their working folder as it is now, read-only. The expander opens on Submitted when there is a submission.

View test output shows the last graded run, or runs the tests if there is none. Re-run runs them on the copy the tab shows. A run on Submitted is recorded as the grade. A run on Live files shows how their current work scores, and is recorded only if the student has not submitted.

Opening a student's workspace

Open on a student's row opens their whole class folder in the editor, with a banner saying whose workspace you are in. Open student's workspace on the People tab and Edit in workspace above a live file in the expander go to the same place. The files are live. You see the student's typing as it happens, and what you type lands in their file. There is no Save button.

The terminal and Run work in a temporary container over the student's files. There are no ports or preview, and the file tree only navigates, so you cannot upload, rename or delete. Notebooks open read-only. Exit returns to the class page.

A student who breaks a starter file can get it back. They right-click the file in their workspace and choose Restore, or right-click the assignment folder and choose Restore all files to bring back one they deleted.

The Gradebook tab

The Gradebook tab lists every student down the side and every assignment across the top, with an Average column at the end. Each cell shows that student's passed/total, or a dash if they have no score yet.

The selector at the top sets the grading mode, which decides the average. The download icon exports the grid as CSV, with an earned and a possible column for each assignment plus the average.

Locking and overriding grades

Click a score to override it. Enter the points under Override score and click Save override. An override can go above the total, for extra credit. It locks the grade and shows with a dotted underline.

To lock a score as it stands, hover the cell and click its lock icon. To lock a whole assignment, click the lock in its column header. A locked cell shows a lock icon, and its score counts until you unlock it. Later test runs still record results, but the grid and average keep the locked value. Unlocking an override throws it away.

Locking a column is the same as Close now on the assignment's Settings tab. It collects and grades everyone's work and stops submissions. Unlocking the column reopens the assignment and keeps your overrides.

Locks don't apply in Manual scores mode.

Grading modes

Equal weights

Every assignment counts the same. The average is the mean of each passed/total, shown as a percentage. An assignment a student has no score on is left out of their average. A locked score always counts, including a locked zero.

Custom weights

Set a weight for each assignment in the Weights row. An assignment weighted 200 counts twice as much as one weighted 100. The average is the weighted mean of each passed/total, and ungraded assignments are left out as in equal weights.

Switching to this mode gives every assignment without a weight a weight of 100. An assignment with no weight drops out of the average, and one you publish after setting your weights has none, so check the row after adding one.

Manual scores

Test results play no part. Set what each assignment is worth in the Total points row, then type each student's score into the grid. A Total column shows earned over possible points, and the average is total earned divided by total possible. Every assignment with points counts, and a missing score counts as zero.

Switching modes

Changing the mode changes only the average, never the passed/total scores. Switching to equal weights keeps your custom weights for when you switch back.

Custom weights and manual scores share one stored number per assignment, so entering total points replaces your weights, and the other way round.