print: S3 Methods: print
In ForceChoice: Forced-Choice Modeling Based on Item Response Theory and Cognitive Diagnostic Models
print R Documentation
S3 Methods: print
Description
Provides user-friendly, formatted console output for objects generated by
the 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.
Usage
## S3 method for class 'good.of.fit'
print(x, digits = 4, ...)
## S3 method for class 'summary.good.of.fit'
print(x, ...)
## S3 method for class 'MIRT'
print(x, ...)
## S3 method for class 'summary.MIRT'
print(x, ...)
## S3 method for class 'MGPCM'
print(x, ...)
## S3 method for class 'summary.MGPCM'
print(x, ...)
## S3 method for class 'MGGUM'
print(x, ...)
## S3 method for class 'summary.MGGUM'
print(x, ...)
## S3 method for class 'FCMIRT'
print(x, ...)
## S3 method for class 'summary.FCMIRT'
print(x, ...)
## S3 method for class 'FCDCM'
print(x, ...)
## S3 method for class 'summary.FCDCM'
print(x, ...)
## S3 method for class 'FCGDINA'
print(x, ...)
## S3 method for class 'summary.FCGDINA'
print(x, ...)
## S3 method for class 'FCGGUM'
print(x, ...)
## S3 method for class 'summary.FCGGUM'
print(x, ...)
## S3 method for class 'TIRT'
print(x, ...)
## S3 method for class 'summary.TIRT'
print(x, ...)
## S3 method for class 'data.MIRT'
print(x, ...)
## S3 method for class 'data.MGPCM'
print(x, ...)
## S3 method for class 'data.MGGUM'
print(x, ...)
## S3 method for class 'data.FCMIRT'
print(x, ...)
## S3 method for class 'data.FCDCM'
print(x, ...)
## S3 method for class 'data.FCGDINA'
print(x, ...)
## S3 method for class 'data.FCGGUM'
print(x, ...)
## S3 method for class 'data.TIRT'
print(x, ...)
Arguments
x
An object of one of the following classes:
Fitted model objects: fit.MIRT
("MIRT"), fit.MGPCM
("MGPCM"), fit.MGGUM
("MGGUM"), fit.FCMIRT
("FCMIRT"), fit.FCDCM
("FCDCM"), fit.FCGGUM
("FCGGUM"), fit.TIRT
("TIRT")
Goodness-of-fit objects: good.of.fit
("good.of.fit")
Summary objects: summary.MIRT, summary.MGPCM,
summary.MGGUM, summary.FCMIRT, summary.FCDCM,
summary.FCGGUM, summary.TIRT,
summary.good.of.fit
digits
Number of decimal places for numeric output (default: 4).
Used by print.good.of.fit.
...
Additional arguments passed to methods (currently ignored in
most cases).
Details
Each method produces a structured, human-readable summary optimized for
its object type:
- Fitted Model Objects
-
Invokes summary() internally and prints comprehensive output
including:
Model call and configuration (family, method, dimensions)
Data characteristics (N, I or B, response type)
Fit statistics (LogLik, npar, AIC, BIC)
Factor correlation matrix
Person parameter summary (N x D)
Item / statement / block parameter summary
For FCDCM: higher-order delta parameters and classification
diagnostics
For TIRT: loading (lambda) parameter summary
Convergence diagnostics (algorithm, batches, latent grid length L)
- Goodness-of-Fit Objects (
good.of.fit) -
Delegates to summary.good.of.fit and prints:
Overview table (sample size, items, parameters, moments)
Limited-information absolute fit (M2, RMSEA, SRMSR)
Incremental / comparative fit (CFI, TLI, IFI)
Likelihood and information criteria (AIC, BIC, SABIC, CAIC)
Pseudo-R^2 measures
Value
Invisibly returns the input object x. No data is modified.
Methods (by class)
-
print(good.of.fit): Print method for good.of.fit objects.
Delegates to summary.good.of.fit and prints formatted tables.
-
print(summary.good.of.fit): Print method for summary.good.of.fit objects.
Displays overview, absolute-fit, comparative-fit, likelihood/IC,
and pseudo-R^2 tables.
-
print(MIRT): Print method for MIRT objects.
Multidimensional IRT (1PL–4PL) model summary.
-
print(summary.MIRT): Print method for summary.MIRT objects.
Shows model config, data info, fit stats, factor correlations,
person/item parameter summaries, and convergence.
-
print(MGPCM): Print method for MGPCM objects.
Multidimensional Generalized Partial Credit Model summary.
-
print(summary.MGPCM): Print method for summary.MGPCM objects.
Shows polytomous model config, fit stats, factor correlations,
person/item parameter summaries, and convergence.
-
print(MGGUM): Print method for MGGUM objects.
Multidimensional Generalized Graded Unfolding Model summary.
-
print(summary.MGGUM): Print method for summary.MGGUM objects.
Shows unfolding model config, fit stats, factor correlations,
person/item parameter summaries, and convergence.
-
print(FCMIRT): Print method for FCMIRT objects.
Forced-Choice Multidimensional IRT model summary.
-
print(summary.FCMIRT): Print method for summary.FCMIRT objects.
Shows forced-choice model config with block info, fit stats,
factor correlations, person/statement parameter summaries.
-
print(FCDCM): Print method for FCDCM objects.
Forced-Choice Diagnostic Classification Model summary with
higher-order trait, attribute profiles, and classification diagnostics.
-
print(summary.FCDCM): Print method for summary.FCDCM objects.
Shows higher-order delta parameters, block eta parameters,
attribute classification summary, and convergence.
-
print(FCGDINA): Print method for FCGDINA objects.
Forced-Choice GDINA model summary.
-
print(summary.FCGDINA): Print method for summary.FCGDINA objects.
Shows CDM type, forced-choice block info, fit stats, delta summaries,
posterior attribute probabilities, and convergence.
-
print(FCGGUM): Print method for FCGGUM objects.
Forced-Choice Generalized Graded Unfolding Model summary.
-
print(summary.FCGGUM): Print method for summary.FCGGUM objects.
Shows forced-choice unfolding model config, fit stats,
factor correlations, person/statement parameter summaries.
-
print(TIRT): Print method for TIRT objects.
Thurstonian IRT for Forced-Choice model summary.
-
print(summary.TIRT): Print method for summary.TIRT objects.
Shows pairwise-comparison model config, fit stats,
factor correlations, loading/person parameter summaries.
-
print(data.MIRT): Print method for data.MIRT objects.
-
print(data.MGPCM): Print method for data.MGPCM objects.
-
print(data.MGGUM): Print method for data.MGGUM objects.
-
print(data.FCMIRT): Print method for data.FCMIRT objects.
-
print(data.FCDCM): Print method for data.FCDCM objects.
-
print(data.FCGDINA): Print method for data.FCGDINA objects.
-
print(data.FCGGUM): Print method for data.FCGGUM objects.
-
print(data.TIRT): Print method for data.TIRT objects.
Output Conventions
Numeric values are rounded to the precision specified by
digits (default 4).
Parameter summary tables show Min, Q1, Median, Mean, Q3, Max
across items/statements for each parameter type.
Convergence diagnostics adapt to the estimation backend
(iStEM batch diagnostics vs. Stan HMC notes).
ForceChoice documentation built on Sept. 13, 2026, 1:06 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
| R Documentation |
S3 Methods: print
Description
Provides user-friendly, formatted console output for objects generated by the 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.
Usage
## S3 method for class 'good.of.fit'
print(x, digits = 4, ...)
## S3 method for class 'summary.good.of.fit'
print(x, ...)
## S3 method for class 'MIRT'
print(x, ...)
## S3 method for class 'summary.MIRT'
print(x, ...)
## S3 method for class 'MGPCM'
print(x, ...)
## S3 method for class 'summary.MGPCM'
print(x, ...)
## S3 method for class 'MGGUM'
print(x, ...)
## S3 method for class 'summary.MGGUM'
print(x, ...)
## S3 method for class 'FCMIRT'
print(x, ...)
## S3 method for class 'summary.FCMIRT'
print(x, ...)
## S3 method for class 'FCDCM'
print(x, ...)
## S3 method for class 'summary.FCDCM'
print(x, ...)
## S3 method for class 'FCGDINA'
print(x, ...)
## S3 method for class 'summary.FCGDINA'
print(x, ...)
## S3 method for class 'FCGGUM'
print(x, ...)
## S3 method for class 'summary.FCGGUM'
print(x, ...)
## S3 method for class 'TIRT'
print(x, ...)
## S3 method for class 'summary.TIRT'
print(x, ...)
## S3 method for class 'data.MIRT'
print(x, ...)
## S3 method for class 'data.MGPCM'
print(x, ...)
## S3 method for class 'data.MGGUM'
print(x, ...)
## S3 method for class 'data.FCMIRT'
print(x, ...)
## S3 method for class 'data.FCDCM'
print(x, ...)
## S3 method for class 'data.FCGDINA'
print(x, ...)
## S3 method for class 'data.FCGGUM'
print(x, ...)
## S3 method for class 'data.TIRT'
print(x, ...)
Arguments
x |
An object of one of the following classes:
|
digits |
Number of decimal places for numeric output (default: 4).
Used by |
... |
Additional arguments passed to methods (currently ignored in most cases). |
Details
Each method produces a structured, human-readable summary optimized for its object type:
- Fitted Model Objects
-
Invokes
summary()internally and prints comprehensive output including:Model call and configuration (family, method, dimensions)
Data characteristics (N, I or B, response type)
Fit statistics (LogLik, npar, AIC, BIC)
Factor correlation matrix
Person parameter summary (N x D)
Item / statement / block parameter summary
For FCDCM: higher-order delta parameters and classification diagnostics
For TIRT: loading (lambda) parameter summary
Convergence diagnostics (algorithm, batches, latent grid length L)
- Goodness-of-Fit Objects (
good.of.fit) -
Delegates to
summary.good.of.fitand prints:Overview table (sample size, items, parameters, moments)
Limited-information absolute fit (M2, RMSEA, SRMSR)
Incremental / comparative fit (CFI, TLI, IFI)
Likelihood and information criteria (AIC, BIC, SABIC, CAIC)
Pseudo-
R^2measures
Value
Invisibly returns the input object x. No data is modified.
Methods (by class)
-
print(good.of.fit): Print method forgood.of.fitobjects. Delegates tosummary.good.of.fitand prints formatted tables. -
print(summary.good.of.fit): Print method forsummary.good.of.fitobjects. Displays overview, absolute-fit, comparative-fit, likelihood/IC, and pseudo-R^2tables. -
print(MIRT): Print method forMIRTobjects. Multidimensional IRT (1PL–4PL) model summary. -
print(summary.MIRT): Print method forsummary.MIRTobjects. Shows model config, data info, fit stats, factor correlations, person/item parameter summaries, and convergence. -
print(MGPCM): Print method forMGPCMobjects. Multidimensional Generalized Partial Credit Model summary. -
print(summary.MGPCM): Print method forsummary.MGPCMobjects. Shows polytomous model config, fit stats, factor correlations, person/item parameter summaries, and convergence. -
print(MGGUM): Print method forMGGUMobjects. Multidimensional Generalized Graded Unfolding Model summary. -
print(summary.MGGUM): Print method forsummary.MGGUMobjects. Shows unfolding model config, fit stats, factor correlations, person/item parameter summaries, and convergence. -
print(FCMIRT): Print method forFCMIRTobjects. Forced-Choice Multidimensional IRT model summary. -
print(summary.FCMIRT): Print method forsummary.FCMIRTobjects. Shows forced-choice model config with block info, fit stats, factor correlations, person/statement parameter summaries. -
print(FCDCM): Print method forFCDCMobjects. Forced-Choice Diagnostic Classification Model summary with higher-order trait, attribute profiles, and classification diagnostics. -
print(summary.FCDCM): Print method forsummary.FCDCMobjects. Shows higher-order delta parameters, block eta parameters, attribute classification summary, and convergence. -
print(FCGDINA): Print method forFCGDINAobjects. Forced-Choice GDINA model summary. -
print(summary.FCGDINA): Print method forsummary.FCGDINAobjects. Shows CDM type, forced-choice block info, fit stats, delta summaries, posterior attribute probabilities, and convergence. -
print(FCGGUM): Print method forFCGGUMobjects. Forced-Choice Generalized Graded Unfolding Model summary. -
print(summary.FCGGUM): Print method forsummary.FCGGUMobjects. Shows forced-choice unfolding model config, fit stats, factor correlations, person/statement parameter summaries. -
print(TIRT): Print method forTIRTobjects. Thurstonian IRT for Forced-Choice model summary. -
print(summary.TIRT): Print method forsummary.TIRTobjects. Shows pairwise-comparison model config, fit stats, factor correlations, loading/person parameter summaries. -
print(data.MIRT): Print method fordata.MIRTobjects. -
print(data.MGPCM): Print method fordata.MGPCMobjects. -
print(data.MGGUM): Print method fordata.MGGUMobjects. -
print(data.FCMIRT): Print method fordata.FCMIRTobjects. -
print(data.FCDCM): Print method fordata.FCDCMobjects. -
print(data.FCGDINA): Print method fordata.FCGDINAobjects. -
print(data.FCGGUM): Print method fordata.FCGGUMobjects. -
print(data.TIRT): Print method fordata.TIRTobjects.
Output Conventions
Numeric values are rounded to the precision specified by
digits(default 4).Parameter summary tables show Min, Q1, Median, Mean, Q3, Max across items/statements for each parameter type.
Convergence diagnostics adapt to the estimation backend (iStEM batch diagnostics vs. Stan HMC notes).
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.