caMST (version 0.1.4)

mixed_adaptive_test: Mixed Computerized Adaptive Multistage Test

Description

Mixed Computerized Adaptive Multistage Test

Usage

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
)

Arguments

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.

Value

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 method provided in function.call.

eap.theta

A numeric vector of the final theta estimates using the expected a posteriori (EAP) theta estimate from catR::eapEst.

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 final.items.seen. NA values indicate that the individual didn't answer the question in the supplied response file or wasn't given any more items to answer.

transition.matrix

The transition_matrix originally supplied to the function.

n.stages

The n_stages originally supplied to the function.

runtime

A difftime object recording how long the function took to complete.

Details

To be filled in later.

References

Baker (2001). http://echo.edres.org:8080/irt/baker/final.pdf

See Also

[multistage_test] for a standard multistage test, [computerized_adaptive_test] for a standard computerized adaptive test.

Examples

# NOT RUN {
# 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)
# }
# NOT RUN {
# }