updateGrade function

Update the grade slot of an examinee object

updateGrade is a function for determining the grade an examinee is routed to.

updateGrade(
  examinee_object,
  assessment_structure,
  module_position,
  cut_scores,
  transition_policy = "CI",
  transition_CI_alpha,
  transition_percentile_lower,
  transition_percentile_upper,
  item_pool
)

Arguments

• examinee_object: an examinee object.
• assessment_structure: an assessment_structure object.
• module_position: the current module position, ranging from 1 to 6.
• cut_scores: a named list containing cut scores to be used in each grade. Each element must be named in the form G?, where ? is a number.
• transition_policy: * CI uses the confidence interval to perform routing.
  • pool_difficulty_percentile uses item difficulty percentiles of all items in the item_pool argument to perform routing.
  • pool_difficulty_percentile_exclude_administered uses item difficulty percentiles of all items in the item_pool argument to perform routing, excluding all previous items administered to the examinee.
  • on_grade does not permit any transition.
  • (default = CI)
• transition_CI_alpha: the alpha level used when transition_policy == "CI".
• transition_percentile_lower: the percentile value (between 0 and 1) used for the lower routing in percentile-based transition policies.
• transition_percentile_upper: the percentile value (between 0 and 1) used for the upper routing in percentile-based transition policies.
• item_pool: the item_pool object to determine difficulty range in percentile-based transition policies.

Returns

an examinee object with its current_grade slot updated.

Details

Currently the routing rules are hard-coded in the function. See the vignette for a description of routing rules.