% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/S3print.R
\name{print}
\alias{print}
\alias{print.good.of.fit}
\alias{print.summary.good.of.fit}
\alias{print.MIRT}
\alias{print.summary.MIRT}
\alias{print.MGPCM}
\alias{print.summary.MGPCM}
\alias{print.MGGUM}
\alias{print.summary.MGGUM}
\alias{print.FCMIRT}
\alias{print.summary.FCMIRT}
\alias{print.FCDCM}
\alias{print.summary.FCDCM}
\alias{print.FCGDINA}
\alias{print.summary.FCGDINA}
\alias{print.FCGGUM}
\alias{print.summary.FCGGUM}
\alias{print.TIRT}
\alias{print.summary.TIRT}
\alias{print.data.MIRT}
\alias{print.data.MGPCM}
\alias{print.data.MGGUM}
\alias{print.data.FCMIRT}
\alias{print.data.FCDCM}
\alias{print.data.FCGDINA}
\alias{print.data.FCGGUM}
\alias{print.data.TIRT}
\title{S3 Methods: print}
\usage{
\method{print}{good.of.fit}(x, digits = 4, ...)

\method{print}{summary.good.of.fit}(x, ...)

\method{print}{MIRT}(x, ...)

\method{print}{summary.MIRT}(x, ...)

\method{print}{MGPCM}(x, ...)

\method{print}{summary.MGPCM}(x, ...)

\method{print}{MGGUM}(x, ...)

\method{print}{summary.MGGUM}(x, ...)

\method{print}{FCMIRT}(x, ...)

\method{print}{summary.FCMIRT}(x, ...)

\method{print}{FCDCM}(x, ...)

\method{print}{summary.FCDCM}(x, ...)

\method{print}{FCGDINA}(x, ...)

\method{print}{summary.FCGDINA}(x, ...)

\method{print}{FCGGUM}(x, ...)

\method{print}{summary.FCGGUM}(x, ...)

\method{print}{TIRT}(x, ...)

\method{print}{summary.TIRT}(x, ...)

\method{print}{data.MIRT}(x, ...)

\method{print}{data.MGPCM}(x, ...)

\method{print}{data.MGGUM}(x, ...)

\method{print}{data.FCMIRT}(x, ...)

\method{print}{data.FCDCM}(x, ...)

\method{print}{data.FCGDINA}(x, ...)

\method{print}{data.FCGGUM}(x, ...)

\method{print}{data.TIRT}(x, ...)
}
\arguments{
\item{x}{An object of one of the following classes:
\itemize{
\item Fitted model objects: \code{\link[ForceChoice]{fit.MIRT}}
(\code{"MIRT"}), \code{\link[ForceChoice]{fit.MGPCM}}
(\code{"MGPCM"}), \code{\link[ForceChoice]{fit.MGGUM}}
(\code{"MGGUM"}), \code{\link[ForceChoice]{fit.FCMIRT}}
(\code{"FCMIRT"}), \code{\link[ForceChoice]{fit.FCDCM}}
(\code{"FCDCM"}), \code{\link[ForceChoice]{fit.FCGGUM}}
(\code{"FCGGUM"}), \code{\link[ForceChoice]{fit.TIRT}}
(\code{"TIRT"})
\item Goodness-of-fit objects: \code{\link[ForceChoice]{good.of.fit}}
(\code{"good.of.fit"})
\item Summary objects: \code{summary.MIRT}, \code{summary.MGPCM},
\code{summary.MGGUM}, \code{summary.FCMIRT}, \code{summary.FCDCM},
\code{summary.FCGGUM}, \code{summary.TIRT},
\code{summary.good.of.fit}
}}

\item{digits}{Number of decimal places for numeric output (default: 4).
Used by \code{print.good.of.fit}.}

\item{...}{Additional arguments passed to methods (currently ignored in
most cases).}
}
\value{
Invisibly returns the input object \code{x}. No data is modified.
}
\description{
Provides user-friendly, formatted console output for objects generated by
the \pkg{ForceChoice} package. This generic function dispatches to
class-specific methods that display concise summaries of fitted models,
simulation datasets, goodness-of-fit indices, and rotated solutions.
Designed for interactive use and quick diagnostic inspection.
}
\details{
Each method produces a structured, human-readable summary optimized for
its object type:

\describe{
\item{\strong{Fitted Model Objects}}{
Invokes \code{summary()} internally and prints comprehensive output
including:
\itemize{
\item Model call and configuration (family, method, dimensions)
\item Data characteristics (N, I or B, response type)
\item Fit statistics (LogLik, npar, AIC, BIC)
\item Factor correlation matrix
\item Person parameter summary (N x D)
\item Item / statement / block parameter summary
\item For FCDCM: higher-order delta parameters and classification
diagnostics
\item For TIRT: loading (lambda) parameter summary
\item Convergence diagnostics (algorithm, batches, latent grid length L)
}
}

\item{\strong{Goodness-of-Fit Objects (\code{good.of.fit})}}{
Delegates to \code{summary.good.of.fit} and prints:
\itemize{
\item Overview table (sample size, items, parameters, moments)
\item Limited-information absolute fit (M2, RMSEA, SRMSR)
\item Incremental / comparative fit (CFI, TLI, IFI)
\item Likelihood and information criteria (AIC, BIC, SABIC, CAIC)
\item Pseudo-\eqn{R^2} measures
}
}
}
}
\section{Methods (by class)}{
\itemize{
\item \code{print(good.of.fit)}: Print method for \code{good.of.fit} objects.
Delegates to \code{summary.good.of.fit} and prints formatted tables.

\item \code{print(summary.good.of.fit)}: Print method for \code{summary.good.of.fit} objects.
Displays overview, absolute-fit, comparative-fit, likelihood/IC,
and pseudo-\eqn{R^2} tables.

\item \code{print(MIRT)}: Print method for \code{MIRT} objects.
Multidimensional IRT (1PL--4PL) model summary.

\item \code{print(summary.MIRT)}: Print method for \code{summary.MIRT} objects.
Shows model config, data info, fit stats, factor correlations,
person/item parameter summaries, and convergence.

\item \code{print(MGPCM)}: Print method for \code{MGPCM} objects.
Multidimensional Generalized Partial Credit Model summary.

\item \code{print(summary.MGPCM)}: Print method for \code{summary.MGPCM} objects.
Shows polytomous model config, fit stats, factor correlations,
person/item parameter summaries, and convergence.

\item \code{print(MGGUM)}: Print method for \code{MGGUM} objects.
Multidimensional Generalized Graded Unfolding Model summary.

\item \code{print(summary.MGGUM)}: Print method for \code{summary.MGGUM} objects.
Shows unfolding model config, fit stats, factor correlations,
person/item parameter summaries, and convergence.

\item \code{print(FCMIRT)}: Print method for \code{FCMIRT} objects.
Forced-Choice Multidimensional IRT model summary.

\item \code{print(summary.FCMIRT)}: Print method for \code{summary.FCMIRT} objects.
Shows forced-choice model config with block info, fit stats,
factor correlations, person/statement parameter summaries.

\item \code{print(FCDCM)}: Print method for \code{FCDCM} objects.
Forced-Choice Diagnostic Classification Model summary with
higher-order trait, attribute profiles, and classification diagnostics.

\item \code{print(summary.FCDCM)}: Print method for \code{summary.FCDCM} objects.
Shows higher-order delta parameters, block eta parameters,
attribute classification summary, and convergence.

\item \code{print(FCGDINA)}: Print method for \code{FCGDINA} objects.
Forced-Choice GDINA model summary.

\item \code{print(summary.FCGDINA)}: Print method for \code{summary.FCGDINA} objects.
Shows CDM type, forced-choice block info, fit stats, delta summaries,
posterior attribute probabilities, and convergence.

\item \code{print(FCGGUM)}: Print method for \code{FCGGUM} objects.
Forced-Choice Generalized Graded Unfolding Model summary.

\item \code{print(summary.FCGGUM)}: Print method for \code{summary.FCGGUM} objects.
Shows forced-choice unfolding model config, fit stats,
factor correlations, person/statement parameter summaries.

\item \code{print(TIRT)}: Print method for \code{TIRT} objects.
Thurstonian IRT for Forced-Choice model summary.

\item \code{print(summary.TIRT)}: Print method for \code{summary.TIRT} objects.
Shows pairwise-comparison model config, fit stats,
factor correlations, loading/person parameter summaries.

\item \code{print(data.MIRT)}: Print method for \code{data.MIRT} objects.

\item \code{print(data.MGPCM)}: Print method for \code{data.MGPCM} objects.

\item \code{print(data.MGGUM)}: Print method for \code{data.MGGUM} objects.

\item \code{print(data.FCMIRT)}: Print method for \code{data.FCMIRT} objects.

\item \code{print(data.FCDCM)}: Print method for \code{data.FCDCM} objects.

\item \code{print(data.FCGDINA)}: Print method for \code{data.FCGDINA} objects.

\item \code{print(data.FCGGUM)}: Print method for \code{data.FCGGUM} objects.

\item \code{print(data.TIRT)}: Print method for \code{data.TIRT} objects.

}}
\section{Output Conventions}{

\itemize{
\item Numeric values are rounded to the precision specified by
\code{digits} (default 4).
\item Parameter summary tables show Min, Q1, Median, Mean, Q3, Max
across items/statements for each parameter type.
\item Convergence diagnostics adapt to the estimation backend
(iStEM batch diagnostics vs. Stan HMC notes).
}
}

