Last data update: 2014.03.03

R: Probability of correct response for cognitive diagnostic...
CDPR Documentation

Probability of correct response for cognitive diagnostic models

Description

This function returns the model-predicted probability of correct response of one item for one person given the item parameters, Q vector, and alpha vector. Currently supported cognitive diagnostic models include the DINA model, DINO model, NIDA model, G-NIDA model, and R-RUM model. This function is called by the ItemFit function in the package.

Usage

CDP(Q, par, alpha, model = c("DINA", "DINO", "NIDA", "GNIDA", "RRUM"))

Arguments

Q

The Q-vector of the item. Columns represent attributes. 1=attribute required by the item, 0=attribute not required by the item.

par

A list of parameters. DINA & DINO — par$slip: a scaler slip parameter for the item; par$guess: a scaler guessing parameter for the item. NIDA — par$slip: a vector of slip parameters for each attribute; par$guess: a vector of guessing parameters for each attribute. GNIDA — par$slip: a vector of slip parameters for each attribute for the item; par$guess: a vector of guessing parameters for each attribute for the item. RRUM — par$pi: a scaler pi parameter for the item; par$r: a vector of r parameters for each attribute for the item.

alpha

A vector of examinee ability profile. 1=examinee masters the attribute, 0=examinee does not master the attribute.

model

Currently supports five models: "DINA", "DINO", "NIDA", "GNIDA", and "RRUM". The default is "DINA".

Value

P

The probability of correct response for the item by the person.

Examples

# Generate item and examinee profiles

Q <- c(1, 0, 0)
alpha <- c(1, 0, 0)
slip <- 0.2
guess <- 0.1
my.par <- list(slip=slip, guess=guess)
CDP(Q, my.par, alpha, model="DINA")

Results


R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(NPCD)
Loading required package: BB
Loading required package: R.oo
Loading required package: R.methodsS3
R.methodsS3 v1.7.1 (2016-02-15) successfully loaded. See ?R.methodsS3 for help.
R.oo v1.20.0 (2016-02-17) successfully loaded. See ?R.oo for help.

Attaching package: 'R.oo'

The following objects are masked from 'package:methods':

    getClasses, getMethods

The following objects are masked from 'package:base':

    attach, detach, gc, load, save

> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/NPCD/CDP.Rd_%03d_medium.png", width=480, height=480)
> ### Name: CDP
> ### Title: Probability of correct response for cognitive diagnostic models
> ### Aliases: CDP
> 
> ### ** Examples
> 
> # Generate item and examinee profiles
> 
> Q <- c(1, 0, 0)
> alpha <- c(1, 0, 0)
> slip <- 0.2
> guess <- 0.1
> my.par <- list(slip=slip, guess=guess)
> CDP(Q, my.par, alpha, model="DINA")
[1] 0.8
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>