% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-plotting-screening.R
\name{plot_residual_qq}
\alias{plot_residual_qq}
\title{Normal quantile-quantile plot of person standardized residuals}
\usage{
plot_residual_qq(
  fit,
  diagnostics = NULL,
  preset = c("standard", "publication", "compact", "monochrome"),
  draw = TRUE
)
}
\arguments{
\item{fit}{An \code{mfrm_fit}.}

\item{diagnostics}{Optional \code{\link[=diagnose_mfrm]{diagnose_mfrm()}} output; required
entries are generated internally when absent.}

\item{preset}{Visual preset.}

\item{draw}{If \code{TRUE}, draw with base graphics.}
}
\value{
An \code{mfrm_plot_data} object with a \code{data} slot containing
\code{Person}, \code{Theoretical}, \code{Sample} columns.
}
\description{
Produces a Q-Q plot of per-person standardized residuals. Under the
fitted Rasch-family model the residuals are approximately N(0, 1),
so deviations from the reference line diagnose distributional
misfit that mean-square summaries may miss.
}
\examples{
toy <- load_mfrmr_data("example_core")
fit <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score",
                method = "JML", maxit = 30)
p <- plot_residual_qq(fit, draw = FALSE)
head(p$data$data)
# Look for: points hugging the y = x reference line. Heavy upper-
#   right tails indicate persons whose residual aggregates exceed
#   the standard normal expectation; pair with `plot_unexpected()`
#   for case-level follow-up. This is an exploratory screen; do
#   not treat tail behaviour as a definitive normality test.
}
