04-extended-grading.knit

# Additional functionalities

---

---

## Adding a rubric item

- A rubric item can be added while grading
- The user would be prompted to supply all relevant rubric components

]

]

---

## Modifying the rubric

- Prompt messages, total points and points to remove **can be modified** directly in the rubric
- Changes **would be reflected** once the grading function is rerun

- Even on students that have already been graded!

---

## Providing personalized feedback

A grader can write a message to a student's feedback file without having points associated

]

]

---

## Hands-on: extra prompt options (**10 min**)

- Go back to the **same grading practice** you used before
- Grade at least one other student submission to **practice adding rubric items** and **writing personalized feedback** where appropriate
- Note: Running the same `assist_grading()` call will resume grading progress

---

---

---

## Selective grading

- **`assist_advanced_grading()`** operates identically to `assist_grading()`, with a few extra options

- One extra ability is grading only:

- **specified students** (`student_identifier` from roster)
  
--

- **specified questions** (`name` from rubric )
  
--

- e.g. grade question 1 for all students
  
---

## Selective grading example

```r
assist_advanced_grading(
  rubric_path = "rubric.csv", 
  roster_path = "roster.csv", 
  grading_progress_log_path = "quiz01-grading-progress-log.csv", 
  final_grade_sheet_path = "quiz01-final-grade-sheet.csv", 
  example_student_identifier = "BaronPoisson",
  example_assignment_path = "quiz01/quiz01-BaronPoisson.Rmd", 
  example_feedback_path = "quiz01/quiz01-BaronPoisson-feedback.Rmd",
*  questions_to_grade = "Question 1", 
*  students_to_grade = c("BaronPoisson", "sergent-gamma")
)
```

---

## Regrading

- **`assist_regrading()`** allows graders to specify which students and questions to **regrade**

- Grading process is identical to an `assist_advanced_grading()` call

- Grades and feedback for students who have not been regraded won't change

---

## Hands-on session: using regrading function

Regrading example

```r
assist_regrading(
  rubric_path = "rubric.csv", 
  grading_progress_log_path = "quiz01-grading-progress-log.csv", 
  final_grade_sheet_path = "quiz01-final-grade-sheet.csv",
*  questions_to_regrade = c("Question 1", "Question 2"), 
*  students_to_regrade = "BaronPoisson"
)
```

Regrade 2 questions for one student.

---

## Multiple submissions per student

The provided assignment path can be a **vector**!

.pull-left-small[
<img src="figures/filepath-multiple-submissions.jpg" alt="A picture of a directory containing two sub directories names final-AlexYu and final-Ann-Lee. Each sub directory contains the files README.md and proposal.Rmd, which are highlighted. The AlexYu subfolder has an additional sub directory names draft, while the Ann-Lee subfolder has a file names figure.png." align = "right" style="width:75%;">
]
--
.pull-right-large[

```r
example_student_identifier = "AlexYu"
example_assignment_path = c(
  "final/final-AlexYu/README.md",
  "final/final-AlexYu/proposal.Rmd"
)
```
]

---

## Team grading with `assist_team_grading()`

- For the case of **multiple students per submission** (e.g. group project)

- Students on a team **share** a feedback file and score

---

## Differences when grading teams

- Roster must have **both** student and team identifiers

| student_identifier | team_identifier |
|--------------------|-----------------|
| federicazoe        | gamma           |
| CatalinaMedina     | gamma           |
| mdogucu            | poisson         |

---

## Differences when grading teams

- `assist_team_grading()` uses team_identifier **instead of** student_identifier

- Team identifier must be present and only unique part of assignment and feedback paths

```r
example_team_identifier = "gamma"
example_assignment_path = "final-projects/gamma/presentation.Rmd"
example_feedback_path = "final-projects/gamma/feedback.Rmd"
```

---

## Team grading with `assist_team_grading()`

```r
*assist_team_grading( 
  rubric_path = "project-rubric.csv", 
*  roster_path = "roster-team", 
  grading_progress_log_path = "project-grade-log.csv",
  final_grade_sheet_path = "project-grade-book.csv",
*  example_team_identifier = "gamma", 
*  example_assignment_path = "final-projects/gamma/presentation.Rmd", 
*  example_feedback_path = "final-projects/gamma/feedback.Rmd" 
)
```