nops_eval {c403} | R Documentation |
Evaluate NOPS exams produced with exams2nops
,
and scanned by nops_scan
.
nops_eval(register = Sys.glob("*.csv"), solutions = Sys.glob("*.rds"), scans = Sys.glob("nops_scan_*.zip"), points = NULL, eval = exams_eval(partial = FALSE, negative = 0.25), mark = c(0.5, 0.6, 0.75, 0.85), dir = ".", results = "nops_eval", html = NULL, col = hcl(c(0, 0, 60, 120), c(70, 0, 70, 70), 90), encoding = "latin1", language = "de", module = NULL, interactive = TRUE, string_scans = Sys.glob("nops_string_scan_*.zip"), string_points = seq(0, 1, 0.25)) nops_register(file = Sys.glob("*.xls*"), startid = 1L) nops_itemresp(eval = "nops_eval.csv", exam = Sys.glob("*.rds"), psychotools = NULL, labels = NULL, ...) nops_zip2tab(file = "nops_eval.zip")
register |
character. File name of a CSV file (semicolon-separated)
of the registered students, e.g., as produced by |
solutions |
character. File name of the RDS exercise file
produced by |
scans |
character. File name of the ZIP file with scanning results
(containing Daten.txt and PNG files) as produced by |
points |
numeric. Vector of points per exercise. By default read from
|
eval |
For |
mark |
logical or numeric. If |
dir |
character. File path to the output directory (the default being the current working directory). |
results |
character. Prefix for output files. |
html |
character. File name for individual HTML files, by default
the same as |
col |
character. Hex color codes used for exercises with negative, neutral, positive, full solution. |
encoding |
character. Encoding of |
language |
character. Path to a DCF file with a language specification.
Currently, |
module |
logical or numeric. Should module marks (in addition to the
exam marks) be computed? If this is numeric, this can be a vector of
two ECTS weights for the written exam and seminar, respectively (by
default equal weights of 0.5 and 0.5 are used). If |
interactive |
logical. Should possible errors in the Daten.txt file by corrected interactively? Requires the png package for full interactivity. |
string_scans |
character. Optional file name of the ZIP file with scanning results
of string exercise sheets (if any) containing Daten2.txt and PNG files as produced
by |
string_points |
numeric. Vector of length 5 with points assigned to string results. |
file |
character with file name. For |
startid |
integer. Starting ID for the seats (defaults to 1). |
exam |
file name of RDS output from |
psychotools |
logical. Should |
labels |
function for extracting exercise labels from each |
... |
additional arguments (such as |
nops_itemresp(eval = "nops_eval.csv", exam = Sys.glob("*.rds"), psychotools = NULL, labels = NULL, ...)
nops_eval
is a companion function for exams2nops
and nops_scan
. It evaluates the scanned exams by computing
the sums of the points achived and (if desired) mapping them to marks (and to
module marks). Furthermore HTML reports for each individual student are
generated for upload into OLAT.
nops_register
is another companion function for preprocessing the
registration lists that are provided by VIS. The function assigns random
seats for every student and saves the result in both CSV and XLSX format
as well as a tab-separated text file with the seat numbers for import into OLAT.
The underlying workhorse function is read_vis
.
nops_itemresp
returns a data frame with several item response outcomes
for each student: solved
indicates whether or not an exercise was
fully solved, partial
whether or not it was at least partially solved.
points
gives the points achieved for each exercise. The corresponding
nsolved
, npartial
, and npoints
are the sums of these
for each student. Moreover, solved2
, partial2
, and points2
distinguish not only the exercises within the exam but also the actual
source template within each exercise.
nops_zip2tab
takes the ZIP file from nops_eval
, extracts all
information from the students' individual HTML files but omits the scanned
exam sheet, and stores everything as a tab-separated text file.
A data.frame
with the detailed exam results is returned invisibly.
It is also written to a CSV file in the current directory, along with a ZIP
file containing the HTML reports (for upload into OLAT), and an XLSX file
(for importing the marks into VIS).
exams2nops
, nops_scan
, read_vis