Assisted grading

Functions to assist with grading and providing personalized feedback to students. assist_grading() requires minimal user input, while assist_team_grading() and assist_advanced_grading() offer more user control and allow for team grading and grading assignments from GitHub

Usage

assist_grading(
  rubric_path,
  roster_path,
  grading_progress_log_path,
  final_grade_sheet_path,
  example_assignment_path,
  example_feedback_path,
  example_student_identifier,
  missing_assignment_grade = NA
)

assist_team_grading(
  rubric_path,
  roster_path,
  grading_progress_log_path,
  final_grade_sheet_path,
  example_assignment_path,
  example_feedback_path,
  example_team_identifier,
  missing_assignment_grade = NA,
  questions_to_grade = "all",
  teams_to_grade = "all",
  github_issues = FALSE
)

assist_advanced_grading(
  rubric_path,
  roster_path,
  grading_progress_log_path,
  final_grade_sheet_path,
  example_assignment_path,
  example_feedback_path,
  example_student_identifier,
  missing_assignment_grade = NA,
  questions_to_grade = "all",
  students_to_grade = "all",
  github_issues = FALSE
)

Arguments

rubric_path

string, path to assignment rubric. This rubric should be created using the function create_rubric_template, then filled in by the user. The rubric file name and column names must not be changed.

roster_path

string; file path to the class roster csv containing a column named student_identifier. If team_grading is set to TRUE then the class roster also needs to contain a column named team_identifier

grading_progress_log_path

string; assist-grading() functions save a file which includes information for gradetools's internal use. This is that path for that file. Must be a .csv

final_grade_sheet_path

string; path to save final grade sheet to. Must be a .csv

example_assignment_path

string; file path to one of the assignments to be graded. This file path structure will be used to determine where the other assignments to be graded are located. The student identifier has to be present somewhere in the file path

example_feedback_path

string; file path to one of the assignment feedback files that will be generated as the user grades. This file path structure will be used to determine where the other feedback files will be stored. The student identifier must be present somewhere in the file name and must be the only part of the file path unique to the student. The extension of the feedback file must be one of the following: "Rmd", "md", "docx", "html", "pdf". These file types (except the first) will be knitted to: GitHub, Word, html, and pdf documents respectively

example_student_identifier

string; a student identifier (e.g. name, id, id number, GitHub user name) that is used to identify the student on the roster. This needs to be present somewhere in the example_assignment_path. The student_identifier needs to be the GitHub user name if the user wishes to push issues or feedback to GitHub later

missing_assignment_grade

numeric; The grade to assign a student with no assignment submission

example_team_identifier

string; Used instead of example_student_identifier when grading team assignments with assist_team_grading(). A team identifier (e.g. "team1", "team2", etc.) that is used to identify what team the student on the roster is in. This needs to be present somewhere in the example_assignment_path.

questions_to_grade

vector of strings; names of assignment questions to grade, or "all" to specify all questions should be graded. All questions_to_grade must exactly match ones present in the rubric

teams_to_grade

vector of strings; team_identifiers corresponding to teams to grade, or "all" to specify all assignments should be graded. Team grading is when the grade of an assignment is share among multiple students. All teams_to_grade must be team_identifiers present in the roster

github_issues

logical, whether the grader wants to be given the option to create an issue in students' repos or not (defaults to FALSE)

students_to_grade

vector of strings; student_identifiers corresponding to students to grade, or "all" to specify all students should be graded. All students_to_grade must be student_identifiers present in the roster