% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/S3fitted.R
\name{fitted}
\alias{fitted}
\alias{fitted.MIRT}
\alias{fitted.MGPCM}
\alias{fitted.MGGUM}
\alias{fitted.FCMIRT}
\alias{fitted.FCDCM}
\alias{fitted.FCGDINA}
\alias{fitted.FCGGUM}
\alias{fitted.TIRT}
\title{S3 Methods: fitted}
\usage{
\method{fitted}{MIRT}(object, ...)

\method{fitted}{MGPCM}(object, ...)

\method{fitted}{MGGUM}(object, ...)

\method{fitted}{FCMIRT}(object, ...)

\method{fitted}{FCDCM}(object, ...)

\method{fitted}{FCGDINA}(object, ...)

\method{fitted}{FCGGUM}(object, ...)

\method{fitted}{TIRT}(object, ...)
}
\arguments{
\item{object}{A fitted model object of class \code{"MIRT"},
\code{"MGPCM"}, \code{"MGGUM"}, \code{"FCMIRT"}, \code{"FCDCM"},
\code{"FCGDINA"}, \code{"FCGGUM"}, or \code{"TIRT"}.}

\item{...}{Additional arguments (currently ignored).}
}
\value{
A numeric matrix of model-implied probabilities. Dimensions:
\itemize{
\item Binary models (MIRT, TIRT): \eqn{N \times I}
\item Polytomous models (MGPCM, MGGUM): \eqn{N \times \sum K_i}
(stacked category probabilities)
\item Forced-choice models (FCMIRT, FCGDINA, FCGGUM): \eqn{N \times \sum K_b}
(block-pattern probabilities)
\item FCDCM: \eqn{N \times B} (marginal block-choice probabilities
after integrating over \eqn{2^D} attribute patterns)
}
}
\description{
Extract model-implied response probabilities from fitted
\pkg{ForceChoice} model objects. Returns the conditional probability of
each observed response given each person's estimated latent trait
\eqn{\hat{\boldsymbol{\theta}}_j}, evaluated via the model's response
function.
}
\details{
For binary-response models, each entry is the endorsement probability
\eqn{P(Y_{ij}=1 \mid \hat{\boldsymbol{\theta}}_j)}. For polytomous
models, probabilities are returned in stacked format (one column per
category). For forced-choice models, each entry is the probability of
the observed ranking pattern in the given block.
}
\section{Methods (by class)}{
\itemize{
\item \code{fitted(MIRT)}: Fitted probabilities for \code{MIRT} objects.
Returns \eqn{N \times I} matrix of endorsement probabilities.

\item \code{fitted(MGPCM)}: Fitted probabilities for \code{MGPCM} objects.
Returns stacked category probability matrix.

\item \code{fitted(MGGUM)}: Fitted probabilities for \code{MGGUM} objects.

\item \code{fitted(FCMIRT)}: Fitted probabilities for \code{FCMIRT} objects.
Returns block-pattern probability matrix.

\item \code{fitted(FCDCM)}: Fitted probabilities for \code{FCDCM} objects.
Returns \eqn{N \times B} matrix of marginal block-choice probabilities
after integrating over \eqn{2^D} attribute patterns.

\item \code{fitted(FCGDINA)}: Fitted probabilities for \code{FCGDINA} objects.
Returns block-pattern probability matrix after integrating over posterior
attribute classes.

\item \code{fitted(FCGGUM)}: Fitted probabilities for \code{FCGGUM} objects.

\item \code{fitted(TIRT)}: Fitted probabilities for \code{TIRT} objects.
Returns \eqn{N \times I_{pairs}} matrix of pairwise comparison
probabilities.

}}
