linkNames: Link Student Names
In mverouden/wurmc: WUR Process and Grade Multiple Choice Answer Sheets

Description Usage Arguments Details Value Author(s) See Also Examples

View source: R/gradeFunctions.R

Link names of students and their study programme to the corrected studentnumbers.

1	linkNames(responses, regFile)

`responses`	A data.frame object (REQUIRED), as created with the `loadResponses()` function and modified by the `numberCorrect()` function.
`regFile`	A character string (REQUIRED) specifying the location and name of the `*.csv` or `.xls(x)` file containing the studentnumber, full name and study programme for all students, which registered for the exam via Osiris.

The linkNames() function compares the student registration numbers scanned from the multiple choice answer sheets (filled by students during the exam) with the student registration numbers from the list of students that registered for the exam via Osiris. In case the registration number was incorrectly filled on the answer sheet this function provides the opportunity to manually correct this. From the Test participants per student group file exported from Osiris the student's name and study programme are matched with the student registration number and added to the responses object.

The input responses data.frame object extended with three columns indicating the corrected studentnumber (Corrected Studentnumber), name (Full Name), and Study (Programme) of all students.

Maikel Verouden

loadKey(), loadResponses()

Other grade functions: gradeExam(), numberCorrect()

## Load the answer key
key <- loadKey(keyFile = paste0(.libPaths()[1], "/wurmc/examples/keyFile.xlsx"))

## Load the student responses from a Microsoft Excel
responses <- loadResponses(respFile = paste0(.libPaths()[1], "/wurmc/examples/respFile.xlsx"))

## Determine the number of correct student responses
responses <- numberCorrect(responses, key)

## Link Student Names
responses <- linkNames(responses, regFile = paste0(.libPaths()[1], "/wurmc/examples/regFile.xlsx"))