flagIneligible: (Internal) Obtain item/set level eligibility flags

In choi-phd/TestDesign: Optimal Test Design Approach to Fixed and Adaptive Test Construction

(Internal) Obtain item/set level eligibility flags

Description

flagIneligible is an internal function for obtaining item/set-level eligibility flags based on segment-wise exposure rates.

Usage

flagIneligible(
  exposure_record,
  simulation_constants,
  item_index_by_stimulus,
  seed,
  j,
  usage_flag = NULL
)

Arguments

exposure_record	a named list containing exposure records.
simulation_constants	a named list containing simulation constants.
item_index_by_stimulus	a list containing item indices by stimulus.
seed, j	(optional) a random seed, and the examinee index. Used to determine the random seed as seed * 123 + j.

Value

flagIneligible returns a named list containing the following:

i

a (n_segment, ni) matrix of 1 and 0 values.

s

a (n_segment, ns) matrix of 1 and 0 values. Only returned when simulation_constants$group_by_stimulus is TRUE.

In each matrix, 1 indicates the item/set is eligible to be selected in a shadowtest, and 0 indicates the item/set is not eligible to be selected in a shadowtest. The higher the observed exposure rate, the more likely the item/set will be flagged as 0. The rows represent theta segments, and the flags in the row corresponding to the examinee's current interim theta estimate is used for the shadowtest assembly.

choi-phd/TestDesign documentation built on Oct. 1, 2024, 2:37 a.m.