Cat-class {catSurv} | R Documentation |
Computerized Adaptive Testing Survey (catSurv) Object
Description
Creates an object of class Cat
. Cat
objects are used in administering Computerized Adaptive Testing (CAT) Surveys. These objects contain several pieces of information relevant for CAT surveys, and are used as input in the main functions of the catSurv
package.
Details
Assume we have a survey battery with I
questions. An object of the class Cat
has the following slots:
-
ids
A vector of lengthI
of unique question identifiers. Default is the column names of response data frame used to calibrateCat
object. -
guessing
A vector of lengthI
of guessing parameters. Guessing parameters are only applicable forCat
objects fit with the"tpm"
model, using thetpmCat
function. -
discrimination
A vector of lengthI
of discrimination parameters. -
difficulty
A vector or list of lengthI
of difficulty parameters. ForCat
objects of the"ltm"
or"tpm"
model,difficulty
is a vector that contains a parameter for each item. ForCat
objects of the"grm"
or"gpcm"
model,difficulty
is a list that contains a vector for each item, and each vector contains parameters for each response option. -
answers
A vector of lengthI
of answers to questions as given by the survey respondent. Unanswered questions have the valueNA
. Questions respondent has skipped or refused to answer have a value of-1
. -
priorName
A character vector of length one giving the prior distribution to use for the ability parameter estimates. The options are"NORMAL"
for the normal distribution,"STUDENT_T"
for the student's t distribution, and"UNIFORM"
for the uniform distribution. The default value is"NORMAL"
. -
priorParams
A numeric vector of length two of parameters for the distribution specified in thepriorName
slot. WhenpriorName
is set to"NORMAL"
, the first element ofpriorParams
is the mean, and the second element is the standard deviation. WhenpriorName
is set to"STUDENT_T"
, the first element ofpriorParams
is the location parameter and the second is degrees of freedom. WhenpriorName
is set to"UNIFORM"
, the elements ofpriorParams
are lower and upper bound, respectively. Note that the uniform distribution is only applicable for the"EAP"
estimation method. The default values are0,1
. -
lowerBound
A numeric indicating the lower bound of the interval of the latent scale used in estimation. The default value is-5
. -
upperBound
A numeric indicating the upper bound of the interval of the latent scale used in estimation. The default value is5
. -
model
A string indicating the model fit to the data. The options are"ltm"
for the latent trait model,"tpm"
for Birnbaum's three parameter model,"grm"
for the graded response model, and"gpcm"
for the generalized partial credit model. -
estimation
A string indicating the approach to estimating ability parameters. The options are"EAP"
for the expected a posteriori approach,"MAP"
for the modal a posteriori approach,"MLE"
for the maximum likelihood approach, and"WLE"
for the weighted maximum likelihood approach. The default value is"EAP"
. -
estimationDefault
A string indicating the approach to estimating ability parameters when the primary estimation choice indicated in theestimation
slot is"MLE"
or"WLE"
and this estimation fails to converge. The options are"EAP"
and"MAP"
. The default value is"MAP"
. -
selection
A string indicating the approach for selecting the next item. The options are"EPV"
for minimum expected posterior variance,"MEI"
for maximum expected information,"MFI"
for maximum Fisher information,"MPWI"
for maximum posterior weighted information,"MLWI"
for maximum likelihood weighted information,"KL"
for the maximum expected Kullback-Leibler (KL) information,"LKL"
maximum likelihood weighted KL information,"PKL"
maximum posterior weighted KL information,"MFII"
for maximum Fisher interval information, and"RANDOM"
where the next item is chosen randomly. The default value is"EPV"
. -
z
A numeric used in calculating\delta
.\delta
is used in determining the bounds of integration for someselectItem
methods. SeeselectItem
for more information. Default value is0.9
. -
lengthThreshold
A numeric. The number of questions answered must be greater than or equal to this threshold to stop administering items. The default value isNA
. -
seThreshold
A numeric. The standard error estimate of the latent trait must be less than this threshold to stop administering items. The default value isNA
. -
infoThreshold
A numeric. The Fisher's information for all remaining items must be less than this threshold to stop administering items. The default value isNA
. -
gainThreshold
A numeric. The absolute value of the difference between the standard error of the latent trait estimate and the square root of the expected posterior variance for each item must be less than this threshold to stop administering items. The default value isNA
. -
lengthOverride
A numeric. The number of questions answered must be less than this override to continue administering items. The default value isNA
. -
gainOverride
A numeric. The absolute value of the difference between the standard error of the latent trait estimate and the square root of the expected posterior variance for each item must be less than this override to continue administering items. The default value isNA
.
Author(s)
Haley Acevedo, Ryden Butler, Josh W. Cutler, Matt Malis, Jacob M. Montgomery, Tom Wilkinson, Erin Rossiter, Min Hee Seo, Alex Weil
See Also
checkStopRules
, estimateTheta
, gpcmCat
, grmCat
, ltmCat
, selectItem
, tpmCat