How to regrade assignments with gradetools

library(gradetools)

The objective of this vignette is to demonstrate how to regrade all or certain questions from assignments previously graded with gradetools.

The grading progress log stores grading progress, so if it has been saved after using an assist grading function the user can resume grading or regrade at any point.

For this example we will use the example directory called example-directory-week09-regression in the quizzes-collected-week09-regression repository in our gradetools-test-course on GitHub.

For our purpose we will consider the situation where we were in the process of grading and realized we assigned the wrong rubric item to a student.

Specifically, we provided the prompt code “404” which says the answer is missing and deducts all points, but we can see that the user did provide an answer.

Regrading with assist_regrading()

There can be many reasons a user may want to regrade an assignment, so assist_regrading() allows for the specification of which students and questions to regrade. In this case we want to regrade Question 1.a for Federica Zoe.

assist_regrading(
  rubric_path = "quiz-09-lin-reg-rubric.csv", 
  grading_progress_log_path = "quiz-09-lin-reg-grading_progress_log.csv", 
  final_grade_sheet_path = "quiz-09-lin-reg-final-grade-sheet.csv", 
  questions_to_regrade = "Question 1.a",
  students_to_regrade = "federicazoe"
)

This exact function call assumes that example-directory-week09-regression is the working directory.

If the assignment had been a team assignment then the user would have specified students_to_regrade as NULL and instead would have provided teams_to_regrade.

Once the function call is made everything will look and function as it did with the assist grading function, except the user will only be prompted to grade the questions_to_regrade for the students_to_regrade.

If a user were to initiate regrading then stop grading before all questions_to_regrade have been regraded, the old grading progress will be retained for those questions that did not get regraded.

Final notes

Changing the rubric is not considered regrading. The grading progress log saves grading progress by saving the assigned prompt codes for each question for each student. At any point a user can edit the rubric and then re run one of the assist grading functions and all associated grades and feedback will get updated. Rewriting feedback and prompt messages for clarity, or changing points associated with a question or rubric item is considered updating and is completely fine. On the other hand, the prompt codes and question names cannot be changed since they are how gradetools stores grading progress.