maat (version 1.1.0)

simExaminees: 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)

Value

a list of '>examinee objects.

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.

Examples

# NOT RUN {
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
)

# }