flagIneligible function

(Internal) Obtain item/set level eligibility flags

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

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.

Returns

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.