adapt_test_options: Adaptive test options

In pmcharrison/psychTestCAT: Computerised Adaptive Testing With PsychTestR

Description

Creates a list of psychTestRCAT options for use in the adapt_test function.

Usage

adapt_test_options(
  next_item.criterion = "MFI",
  next_item.estimator = "BM",
  next_item.prior_dist = "norm",
  next_item.prior_par = c(0, 1),
  final_ability.estimator = "BM",
  constrain_answers = FALSE,
  avoid_duplicates = NULL,
  cb_control = NULL,
  cb_group = NULL,
  eligible_first_items = NULL,
  notify_duration = 5
)

Arguments

next_item.criterion	(Character scalar, default = "MFI") Criterion by which the next item is selected; see the criterion argument of nextItem.
next_item.estimator	(Character scalar, default = "BM") Ability scoring method used for item selection; see the method argument of nextItem. Only "BM", "ML", "WL", and "EAP" are supported.
next_item.prior_dist	(Character scalar, default = "norm") Class of prior distribution used when estimating abilities for item selection; see the priorDist argument of nextItem.
next_item.prior_par	(Numeric vector, length 2, default = c(0, 1)) Prior distribution used when estimating abilities for item selection; see the priorPar argument of nextItem.
final_ability.estimator	(Character scalar, default = "BM") Ability scoring method used for final ability estimation; see the method argument of nextItem. The prior distribution (if relevant) remains the same as that used for item selection, i.e. that specified by next_item.prior_dist and next_item.prior_par. Only "BM", "ML", "WL", and "EAP" are supported.
constrain_answers	(Boolean; default = FALSE) If TRUE, item selection actively balances the available response options. This only makes sense when the item bank contains only a small number of unique answers.
avoid_duplicates	(NULL or character scalar) If not NULL, should specify a column of the item bank defining a categorical item feature for which duplicates should be avoided during item selection.
cb_control	Content-balancing argument passed to nextItem.
cb_group	Content-balancing argument passed to nextItem.
eligible_first_items	(NULL or integerish vector) If not NULL, lists the eligible items for the first item in the test, where each item is identified by its 1-indexed row number in item_bank (see adapt_test). For example, c(2, 3, 4) means that the first item will be drawn from rows 2, 3, 4 of the item bank).
notify_duration	(Numeric scalar) Defines the length of time for which item-by-item feedback messages persist on screen, in seconds. This is only relevant when the test is taken in admin or demo mode.

Value

A list to be passed to the opt argument of adapt_test.

pmcharrison/psychTestCAT documentation built on Sept. 16, 2020, 5:48 p.m.