View source: R/mixed_adaptive_test_function.R
mixed_adaptive_test | R Documentation |
Mixed Computerized Adaptive Multistage Test
mixed_adaptive_test( response_matrix, cat_item_bank, initial_theta = 0, method = "BM", item_method = "MFI", cat_length, nAvailable_cat = NULL, cbControl = NULL, cbGroup = NULL, randomesque = 1, mst_item_bank, modules, transition_matrix, n_stages, module_select = "MFI" )
response_matrix |
A matrix of the person responses, with individuals as rows and items as columns. |
cat_item_bank |
A data frame with the first stage items on the rows and their item parameters on the columns. These should be in the mstR package format for item banks. |
initial_theta |
The initial theta estimate for all individuals. |
method |
A character value indicating method for the provisional theta estimate. Defaults to "BM" (Bayes Modal). See the catR and mstR packages for more details. |
item_method |
A character value indicating the method for the item-level selection in the first stage. Defaults to "MFI" (Maximum Fisher Information). See the catR and mstR packages for more details. |
cat_length |
A numeric value indicating the number of items in the first stage. |
nAvailable_cat |
Defaults to 'NULL'. See the catR package for more information on how to use this option. |
cbControl |
A list of the appropriate format used to control for content balancing in the first stage. See the Details in the nextItem function in catR. |
cbGroup |
A factor vector of the appropriate format used to control for content balancing in the first stage. See the Details in the nextItem function in catR. |
randomesque |
An integer indicating the number of items from which to select the next item to administer in the first stage. Default value is 1. |
mst_item_bank |
A data frame with the second stage and beyond items on the rows and their item parameters on the columns. These should be in the mstR package format for item banks. |
modules |
A matrix describing the relationship between the items and the modules they belong to. See Details. |
transition_matrix |
A matrix describing how individuals can transition from one stage to the next. |
n_stages |
A numerical value indicating the number of stages in the test. |
module_select |
A character value indicating the information method used to select modules at transition stages. One of "MFI" (default), "MLWMI", "MPWMI", "MKL", "MKLP", "random". See the mstR for more details. |
To be filled in later.
A list of all individuals with the following elements: the vector of final theta estimates based on "method", the vector of final theta estimates based on EAP, the vector of final theta estimates based on the iterative estimate from Baker 2004, a matrix of the final items taken, a matrix of the modules seen, and a matrix of the final responses.
An S4 object of class 'MST' with the following slots:
function.call |
The function and arguments called to create this object. |
final.theta.estimate |
A numeric vector of the final theta estimates using the |
eap.theta |
A numeric vector of the final theta estimates using the expected a posteriori (EAP) theta estimate from |
final.theta.Baker |
A numeric vector of the final theta estimates using an iterative maximum likelihood estimation procedure as described in chapter 5 of Baker (2001). |
final.theta.SEM |
A numeric vector of the final standard error of measurement (SEM) estimates using an iterative maximum likelihood estimation procedure as described in chapter 5 of Baker (2001). |
final.items.seen |
A matrix of the final items seen by each individual using the supplied item names. ‘NA' values indicate that an individual wasn’t given any items to answer after the last specified item in their row. |
final.responses |
A matrix of the responses to the items seen in |
transition.matrix |
The |
n.stages |
The |
runtime |
A |
Baker (2001). http://echo.edres.org:8080/irt/baker/final.pdf
[multistage_test] for a standard multistage test, [computerized_adaptive_test] for a standard computerized adaptive test.
# using simulated test data data(example_thetas) # 5 simulated abilities data(example_responses) # 5 simulated response vectors # the transition matrix for an 18 item 1-3-3 balanced design data(example_transition_matrix) # the items designated for use in the routing module with item-level # adaptation data(cat_items) # the items designated for use in the second and third modules with # module-level adaptation data(mst_items) # the matrix specifying how the item data frame relates to the modules data(example_module_items) # run the Mca-MST model results <- mixed_adaptive_test(response_matrix = example_responses[1:2,], cat_item_bank = cat_items, initial_theta = 0, method = "EAP", item_method = "MFI", cat_length = 6, cbControl = NULL, cbGroup = NULL, randomesque = 1, mst_item_bank = mst_items, modules = example_module_items, transition_matrix = example_transition_matrix, n_stages = 3)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.