This vignette describes how to grade an exam using the script found on the exec/
folder. You can find where this script is found by typing on an R terminal.
system.file("exec", package = "TexExamRandomizer")
## [1] "/private/var/folders/f9/gx8nkt0j6kgcwslqj681v8jw0000gp/T/Rtmp3qkaKd/Rinst10a993d21e2d0/TexExamRandomizer/exec"
Format of the studentâs answers
When you collect the responses from the student, you should follow the following prescriptions:
When you created the exams by using the examrandomizer
script, it will generate a fullanswersheet.csv
file. When grading, it assumes that the âcorrectTagâ and the âwrongTagâ are respectively âchoiceâ and âCorrectChoiceâ.
If that is not the case in your structure, simply change the names to âchoiceâ and âCorrectChoiceâ of those columns.
Answer sheet, the last two rows must be named âchoiceâ and âCorrectChoiceâ 0 1 1 1 1 1 1 1 1 1 NA 0 2 1 1 1 1 1 2 1 2 NA 0 3 1 1 1 1 1 3 1 3 NA 0 4 1 1 1 1 1 4 1 NA 4 0 5 1 2 1 2 1 1 1 1 NA(But if you really want to change that assumption, you can access the script and edit ASHEET_COLCORRECT
and ASHEET_COLINCORRECT
)
If you realize one question is incorrectly written, but it is too late to rewrite the exam, find the original answer sheet in the fullanswersheet.csv
(The rows with version number 0). Then, remove the lines from the answer sheet that refer to the question you want to ignore. (Keep a backup of the answer sheet, just in case).
When the students answer the exam. Tell them to write any answer in that question, it will be ignored by the program.
Grading the examYou can specify directly the responses from the students (--resp
) and the answer sheet (--answer
).
gradeexamrandomizer --resp <student responses csv> --answer <fullanswersheet csv>
If you have both of those files on the same directory and you make sure their name is somehow similar to âresponses*.csv
â and âanswer*.csv
â, you can write the shorthand version.
gradeexamrandomizer --dir <dirname>
The output will be two csv files in the same directory where the studentsâ responses file is found, called *_Graded.csv
and *_Stats.csv
.
In the output *_Graded.csv
table, as you can see in the example above, there will be 5 rows added to the output:
addedPoints
: Points added to each student, by adding a column in the responses called âExtraPointsâ
addedAllPoints
: Points added to all students. This points are added differently, like if the exam had addedAllPoints
extra questions, and all students got them correctly.
(Which right now will always be zero with the current script).
maxGrade
: Maximum number of answers in that exam. If you had removed some questions that you want to remove, but that question is not found on all versions, then some exams will have a greater than
Grade
: The number of correct answers on the student exam. (If there are more than one correct answer on each question, ti wonât be able to detec all of them, only whether the student wrote a correct one or not)
Grade_Total_Exam
: The total grade, after scaling. It assumes the maximum grade of the exam is a 100%. For generailty we will denote it MAX
. (To change it, use the option --max <integer>
) \[Grade_{Total Exam} = \frac{Grade + addedAllPoints}{maxGrade + addedAllPoints} \cdot MAX + addedPoints\]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4