simExaminees: Simulate an examinee list

In maat: Multiple Administrations Adaptive Testing

Simulate an examinee list

Description

simExaminees is a function for generating a list of examinee objects.

Usage

simExaminees(
  N,
  mean_v,
  sd_v,
  cor_v,
  assessment_structure,
  initial_grade = "G4",
  initial_test = "T1",
  initial_phase = "P1"
)

Arguments

N	the number of examinees.
mean_v	a vector containing the mean of each dimension.
sd_v	a vector containing the standard deviation of each dimension.
cor_v	a correlation matrix.
assessment_structure	an assessment_structure object. This can be created using createAssessmentStructure.
initial_grade	the initial grade for all examinees. The grade must exist in module_list. Also used as the grade of record when the initial phase and test points to a module position greater than 1. (default = G4)
initial_test	the initial test for all examinees. (default = T1)
initial_phase	the initial phase for all examinees. The phase must exist in module_list. (default = P1)

Details

Each dimension of mean_v, sd_v, cor_v represents a test level. For example in a three-test structure (see the assessment_structure_math example data), these arguments must have three dimensions.

Value

a list of examinee objects.

Examples

assessment_structure <- createAssessmentStructure(
  n_test  = 3,
  n_phase = 2,
  route_limit_below = 1,
  route_limit_above = 2
)
examinee_list <- simExaminees(
  N      = 100,
  mean_v = c(0, 0, 0),
  sd_v   = c(1, 1, 1),
  cor_v  = diag(1, 3),
  assessment_structure = assessment_structure
)

maat documentation built on May 18, 2022, 9:07 a.m.