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

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.