% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-estimation.R
\name{interaction_effect_table}
\alias{interaction_effect_table}
\title{Extract model-estimated facet interaction effects}
\usage{
interaction_effect_table(fit)
}
\arguments{
\item{fit}{An \code{mfrm_fit} object returned by \code{\link[=fit_mfrm]{fit_mfrm()}}.}
}
\value{
A tibble with one row per interaction cell. Returns an empty tibble
when the fit has no model-estimated facet interactions.
}
\description{
\code{interaction_effect_table()} returns the fixed-effect interaction block
estimated by \code{\link[=fit_mfrm]{fit_mfrm()}} when \code{facet_interactions} is supplied. These are
model-estimated deviations from the additive main-effects MFRM, not the
residual screening statistics returned by \code{\link[=estimate_bias]{estimate_bias()}}.
}
\details{
The current release supports two-way interactions between non-person facets,
for example \code{facet_interactions = "Rater:Criterion"}. Each interaction matrix
is identified by zero marginal sums across both participating facets, so the
interaction estimates are separable from the two main effects. Positive values
indicate higher-than-expected scores for the facet-level combination under the
additive model; negative values indicate lower-than-expected scores.

Use this table for confirmatory model review after specifying the facet pair
of substantive interest. For exploratory screening without adding parameters
to the fitted model, use \code{\link[=estimate_bias]{estimate_bias()}} or \code{\link[=estimate_all_bias]{estimate_all_bias()}}.
}
\seealso{
\code{\link[=fit_mfrm]{fit_mfrm()}}, \code{\link[=estimate_bias]{estimate_bias()}}, \code{\link[=compare_mfrm]{compare_mfrm()}}
}
