% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-plotting-extras.R
\name{plot_apa_figure_one}
\alias{plot_apa_figure_one}
\title{Manuscript-ready four-panel composite (Wright + severity + threshold + summary)}
\usage{
plot_apa_figure_one(
  fit,
  diagnostics = NULL,
  rater_facet = "Rater",
  ci_level = 0.95,
  preset = c("standard", "publication", "compact", "monochrome"),
  draw = TRUE
)
}
\arguments{
\item{fit}{An \code{mfrm_fit} from \code{\link[=fit_mfrm]{fit_mfrm()}}.}

\item{diagnostics}{Optional \code{\link[=diagnose_mfrm]{diagnose_mfrm()}} output.}

\item{rater_facet}{Facet name to use as the "rater" axis (default
\code{"Rater"}).}

\item{ci_level}{Confidence level for the rater severity panel.}

\item{preset}{Visual preset.}

\item{draw}{If \code{TRUE}, draw the composite immediately with
\code{graphics::layout()}.}
}
\value{
Invisibly, an \code{mfrm_plot_data} object whose \code{data} slot
bundles the four panel data objects under \code{wright}, \code{severity},
\code{threshold}, and \code{summary}.
}
\description{
Builds a 2x2 publication composite for an \code{mfrm_fit}, suitable for a
"Figure 1" in the Rasch-family \code{RSM}/\code{PCM} manuscript route. Panels: (1)
Wright map, (2)
rater severity profile with CI whiskers, (3) threshold ladder, (4)
a one-line reliability / separation summary block. Each panel reuses
the standalone plot helper so the visual language is consistent
with the rest of the package.
}
\section{Interpreting output}{

Designed for a single-figure Methods or Results overview. The
summary panel prints the model class, sample size, log-likelihood,
AIC/BIC, and the largest non-Person facet's separation /
reliability if available.
}

\examples{
toy <- load_mfrmr_data("example_core")
fit <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score",
                method = "JML", maxit = 30)
p <- plot_apa_figure_one(fit, draw = FALSE)
names(p$data)
}
\seealso{
\code{\link[=plot.mfrm_fit]{plot.mfrm_fit()}} (\code{type = "wright"}),
\code{\link[=plot_rater_severity_profile]{plot_rater_severity_profile()}}, \code{\link[=plot_threshold_ladder]{plot_threshold_ladder()}},
\code{\link[=build_apa_outputs]{build_apa_outputs()}}.
}
\concept{confidence intervals}
\concept{reporting workflow}
\concept{visual diagnostics}
