PWFI: This function calculates percent within a fixed interval...

Description Usage Arguments Value References Examples

View source: R/PWFI.R

Description

This function calculates percent within a fixed interval (PWFI) function as introduced in Wyse & McBride (2021)

Usage

1
PWFI(estimated.theta, items.administered, bank, interval)

Arguments

estimated.theta

A data matrix that has the provisional ability estimates upon administering a sequence of items. In this input, rows are individuals taking the CAT. The columns are the items administered to individuals. The values in the cells are the provisional ability estimates after each item administration.

items.administered

A data matrix that has the set of item items administered to individuals. This input assumes that every row in the data frame corresponds to the set of item names/identifiers administered to an individual.

bank

A data matrix that have item parameters in the following order: discrimination, difficulty, guessing and slipping.

interval

The interval to calculate the statistic, should be between 0 and 1, Wyse & McBride (2021) suggests 0.30

Value

Returns a matrix for PWFI in which every row is the PWFI for each test taker

References

Wyse, A. E., & McBride, J. R. (2021). A Framework for Measuring the Amount of Adaptation of Rasch‐based Computerized Adaptive Tests. Journal of Educational Measurement, 58(1), 83-103.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
library(catR)
N=1000 #number of students
bank=250 #number of items
items=45
theta=rnorm(N,0,1) #level of trait
model="2PL" #IRT model to use
start <- list(theta = -1:1, randomesque = 1)
stop <- list(rule = c( "length"), thr = items)
final <- list(method = "ML")

test=list(method = "ML", itemSelect = "MFI")
bank=genDichoMatrix(items =bank, cbControl = NULL,
                   model = model)

res <- simulateRespondents(thetas = theta, bank,
                          start = start, test = test, stop = stop,
                          final = final, model = NULL)

estimated.theta=res$responses.df[,grepl("estimated.theta",names( res$responses.df ) ) ]
items.administered=res$responses.df[,grepl("items.administrated",names( res$responses.df ) ) ]
interval=0.30
PWFI(estimated.theta, items.administered, bank, interval)

mustfa5/test.adaptation documentation built on Dec. 21, 2021, 11:03 p.m.