Compiles a data frame of trial-by-trial results for each participant. This function is intended to be called once data have been collected for several participants; it allows the researcher to inspect CA-BAT results on a trial-by-trial level.
compile_trial_by_trial_results( in_dir = "output/results", label = "BAT", combine = TRUE )
Results directory to process.
Label that the CA-BAT's results were saved under (typically "BAT").
Whether to combine results into one big data frame, or instead to return a list of data frames, one for each participant.
Suppose that a participant completes 5 items in the test. They will have 5 rows in the table, corresponding to their 5 items. You can find the participant's rows by filtering by the "p_id" column. The column "num" indexes these rows: 1 corresponds to the first item they took, 2 corresponds to the second item, and so on. The ability scores are given in the "ability_" columns; they tell you the participant's estimated ability after having answered that particular item. To get the participant's final estimated ability score, look for the highest value of "num", in this case 5. Then look up the ability score within that row.
There are different columns for the different ability
estimation methods, make sure you are looking at the right one.
The correct one to look at corresponds to the
parameter in your adaptive test. We most commonly use weighted likelihood,
i.e. "WL". This is stored in the column "ability_WL".
If you are unsure that you are looking at the right column,
you can compare the results to the CSV results that you can download
from the psychTestR admin interface, which provide
solely the participant's final ability score.
A data frame, or list of data frames, of trial-by-trial results.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.