https://github.com/cran/eRm
Tip revision: d08460987ea51cdf020292a03d490b7d80b8e579 authored by Patrick Mair on 24 October 2007, 00:00:00 UTC
version 0.9-5
version 0.9-5
Tip revision: d084609
PCM.Rd
\name{PCM}
\alias{PCM}
%- Also NEED an '\alias' for EACH other topic documented here.
\title{Estimation of partial credit models}
\description{
This function computes the parameter estimates of a partial credit model for polytomous
item responses by using CML estimation. }
\usage{
PCM(X, W, se = TRUE, sum0 = TRUE, etaStart)
}
%- maybe also 'usage' for other objects documented here.
\arguments{
\item{X}{Input data matrix or data frame with item responses (starting from 0); rows represent individuals, columns represent items. Missing values are inserted as \code{NA}.}
\item{W}{Design matrix for the PCM. If omitted, the function will compute W automatically.}
\item{se}{If \code{TRUE}, the standard errors are computed.}
\item{sum0}{If \code{TRUE}, the parameters are normed to sum-0 by specifying
an appropriate \code{W}. If \code{FALSE}, the first parameter is restricted to 0.}
\item{etaStart}{A vector of starting values for the eta parameters can be specified. If missing, the 0-vector is used.}
}
\details{
Through specification in W, the parameters of the categories with 0 responses
are set to 0 as well as the first category of the first item. Available methods
for PCM-objects are \code{print}, \code{coef}, \code{model.matrix},
\code{vcov}, \code{plot}, \code{summary}, \code{logLik}, \code{person.parameters},
\code{plotICC}, \code{LRtest}.
}
\value{
Returns an object of class \code{Rm, eRm} containing.
\item{loglik}{Conditional log-likelihood.}
\item{iter}{Number of iterations.}
\item{npar}{Number of parameters.}
\item{convergence}{See \code{code} output in \code{\link{nlm}}.}
\item{etapar}{Estimated basic item parameters.}
\item{se.eta}{Standard errors of the estimated basic item parameters.}
\item{betapar}{Estimated item-category (easiness) parameters.}
\item{se.beta}{Standard errors of item parameters.}
\item{hessian}{Hessian matrix if \code{se = TRUE}.}
\item{W}{Design matrix.}
\item{X}{Data matrix.}
\item{X01}{Dichotomized data matrix.}
\item{call}{The matched call.}
}
\references{
Fischer, G. H., and Molenaar, I. (1995). Rasch Models - Foundations,
Recent Developements, and Applications. Springer.
Mair, P., and Hatzinger, R. (2007). Extended Rasch modeling: The eRm package for the application of IRT models in R. Journal of Statistical Software, 20(9), 1-20.
Mair, P., and Hatzinger, R. (2007). CML based estimation of extended Rasch models with the eRm package in R. Psychology Science, 49, 26-43.
}
\author{Patrick Mair, Reinhold Hatzinger}
%\note{}
\seealso{\code{\link{RM}},\code{\link{RSM}},\code{\link{LRtest}}
}
\examples{
##PCM with 10 subjects, 3 items
data(pcmdat)
res <- PCM(pcmdat)
res
summary(res) #eta and beta parameters with CI
thresholds(res) #threshold parameters
}
\keyword{models}