formatOutput {maat}

Format the output of maat

Description

formatOutput is a function for formatting the output examinee object of the function maat for analysis.

Usage

formatOutput(examinee_list, digits = 3)

Arguments

examinee_list

the output from maat.

digits

digits to round theta values. (default = 3)

Value

a data frame containing:

• p_ID: the person ID.

• test_phase_ID: the module position. If we have 3 tests with 2 phases in each test then the range of test_phase_ID is 1 to 6.

• initial_grade: the initial grade of the person.

• final_grade: the final grade of the person after completing all modules.

• grade_ID: the grade at the module position.

• phase_ID: the phase at the module position.

• test_ID: the test at the module position.

• module_ID: the module ID at the module position.

• final_theta_est: the grand final estimated \theta after completing all tests.

• final_SE_est: the standard error of grand final estimated \theta after completing all tests.

• theta_by_phase: the final estimated \theta after completing each phase.

• SE_by_phase: the standard error of final estimated \theta after completing each phase.

• combined: whether items were combined with the previous phase to obtain the theta estimate.

• true_theta: the true \theta in each module position.

• item_ID: the item IDs of administered items.

• ncat: the number of categories of administered items.

• IRT_model: the IRT models of administered items.

• item_par_1: the first item parameter of each administered item (e.g., for 1PL, this is item difficulty)

• item_par_2: the second item parameter of each administered item (e.g., for 1PL, this is 'NA')

• item_resp: the item response on each administered item.

• momentary_theta: the momentary (interim) \theta estimate obtained after each item administration in CAT engine.

• momentary_SE: the standard error of momentary (interim) \theta estimate obtained after each item administration in CAT engine.