1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
\encoding{UTF-8}
\name{itemfit.ppar}
\alias{itemfit.ppar}
\alias{itemfit}
\alias{personfit.ppar}
\alias{personfit}
\alias{residuals.ppar}
\alias{pmat.ppar}
\alias{pmat}
\alias{print.ifit}
\alias{print.pfit}
\alias{print.resid}
%- Also NEED an '\alias' for EACH other topic documented here.
\title{Residuals, Personfit and Itemfit Statistics}
\description{\code{pmat} computes the theoretical person-item matrix with solving
probabilities for each category (except 0th). \code{residuals} computes the squared and standardized residuals based on
the observed and the expected person-item matrix. Chi-square based itemfit and personfit
statistics can be obtained by using \code{itemfit} and \code{personfit}. Corrected item-test correlations in \code{itemfit} are computed using the approach from Cureton (1966).
}
\usage{
\method{pmat}{ppar}(object)
\method{residuals}{ppar}(object,...)
\method{itemfit}{ppar}(object)
\method{personfit}{ppar}(object)
\method{print}{ifit}(x, visible = TRUE,
sort_by = c("none", "p", "outfit_MSQ", "infit_MSQ", "outfit_t", "infit_t", "discrim"),
decreasing = FALSE, digits = 3,...)
\method{print}{pfit}(x, visible = TRUE, ...)
\method{print}{resid}(x, ...)
}
%- maybe also 'usage' for other objects documented here.
\arguments{
\item{object}{Object of class \code{ppar}, derived from \code{person.parameter}.}
\item{x}{Object of class \code{ifit}, \code{pfit}, or \code{resid}.}
\item{visible}{If \code{FALSE}, returns the matrix of fit statistics that otherwise would be printed.}
\item{sort_by}{Optionally the itemfit output can be sorted by one of these criteria.}
\item{decreasing}{If \code{sort_by} is set, whether the output should be sorted in increasing or decreasing order.}
\item{digits}{How many digits should be printed.}
\item{...}{Further arguments passed to or from other methods. They are ignored in this function.}
}
%\details{}
\value{
%Function \code{pmat}:
\item{pmat}{Matrix of theoretical probabilities for each category except 0th (from function \code{pmat}).}
%Function \code{itemfit} returns a list of class \code{ifit} with components:
\item{i.fit}{Chi-squared itemfit statistics (from function \code{itemfit}).}
\item{i.df}{Degrees of freedom for itemfit statistics (from function \code{itemfit}).}
\item{st.res}{Standardized residuals (from function \code{itemfit}).}
\item{i.outfitMSQ}{Outfit mean-square statistics (from function \code{itemfit}).}
\item{i.infitMSQ}{Infit mean-square statistics (from function \code{itemfit}).}
\item{i.disc}{Corrected item-test correlations (from function \code{itemfit}).}
%Function \code{personfit} returns a list of class \code{pfit} with components:
\item{p.fit}{Chi-squared personfit statistics (from function \code{personfit}).}
\item{p.df}{Degrees of freedom for personfit statistics (from function \code{personfit}).}
\item{st.res}{Standardized residuals (from function \code{personfit}).}
\item{p.outfitMSQ}{Outfit mean-square statistics (from function \code{personfit}).}
\item{p.infitMSQ}{Infit mean-square statistics (from function \code{personfit}).}
}
\references{
Smith Jr., E. V., and Smith, R. M. (2004). Introduction to Rasch Measurement.
JAM press.
Wright, B.D., and Masters, G.N. Computation of OUTFIT and INFIT Statistics.
Rasch Measurement Transactions, 1990, 3:4 p.84-85
Cureton, E. E. (1966). Corrected item-test correlations. Psychometrika, 31, 93-96
}
\author{Patrick Mair, Reinhold Hatzinger, Moritz Heene}
%\note{}
\seealso{\code{\link{person.parameter}}
}
\examples{
# Rasch model, estimation of item and person parameters
res <- RM(raschdat2)
p.res <- person.parameter(res)
# Matrix with expected probabilities and corresponding residuals
pmat(p.res)
residuals(p.res)
#Itemfit
itemfit(p.res)
#Personfit
personfit(p.res)
}
\keyword{models}
|
