FindBestRabils: Function to estimate how big the R_rest values for a set of...

View source: R/FindBestRabils.R

FindBestRabilsR Documentation

Function to estimate how big the R_rest values for a set of items might get

Description

For each item in an IRT model in turn, this function estimates the largest possible theoretical correlation between true ability and item scores that might occur if the only thing that changed was the mean ability of the population (i.e. item parameters as well as standard deviation and shape of ability distribution are fixed). This allows an idea of how high an R_rest value might get if the item was used in a population suitable to its difficulty and if the scores on the remainder of the test were perfectly reliable.

Usage

FindBestRabils(mirtobj)

Arguments

mirtobj

An estimated IRT model (of class SingleGroupClass) estimated either using the function "unimirt" or by applying the function "mirt" directly.

Details

For the purposes of this function only the underlying ability distribution is assumed to be normally distributed. Also note that R_abil is actually estimated as the square root of the percentage of the variance in item scores that can be explained by ability. As such, it accounts for nonlinear relationships between item scores and ability.

Value

A vector of highest possible correlations between true ability and item scores.

Examples

## Not run: 
mirt1=unimirt(mathsdata,"2")
FindBestRabils(mirt1)

## End(Not run)

CambridgeAssessmentResearch/unimirt documentation built on June 10, 2025, 6:03 a.m.