| extract_results {rqti} | R Documentation |
Create data frame with test results
Description
The function extract_results() takes Opal zip archive "Export results" or
xml file and creates two kinds of data frames (according to parameter
'level'), see the 'Details' section.
Usage
extract_results(file, level = "exercises", hide_filename = TRUE)
Arguments
file |
A string with a path of the xml test result file. |
level |
A string with two possible values: exercises and items. |
hide_filename |
A boolean value, TRUE to hide original file names by default. |
Value
A dataframe with attribues of the candidates outcomes and result variables.
Note
1.With option level = "exercises" data frame consists of columns:
'file' - name of the xml file with test results (to identify candidate)
'date' - date and time of test
'id_question' - question item identifier
'duration' - time in sec. what candidate spent on this item
'score_candidate' - points that were given to candidate after evaluation
'score_max' - max possible score for this question
'question_type' - the type of question
'is_answer_given' - TRUE if candidate gave the answer on question, otherwise FALSE
'title' - the values of attribute 'title' of assessment items
2.With option level = "items" data frame consists of columns:
'file' - name of the xml file with test results (to identify candidate)
'date' - date and time of test
'id_question' - question item identifier
'base_type' - type of answer (identifier, string or float)
'cardinalities' - defines whether this question is single, multiple or ordered -value
'qti_type' - specifies the type of the task
'id_answer' - identifier of each response variable
'expected_response' - values that considered as right responses for question
'candidate_response' - values that were given by candidate
'score_candidate' - - points that were given to candidate after evaluation
'score_max' - max possible score for this question item
'is_response_correct' - TRUE if candidate gave the right response, otherwise FALSE
'title' - the values of attribute 'title' of assessment items
Examples
file <- system.file("test_results.zip", package='rqti')
df <- extract_results(file, level = "items")