% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-plotting-extras.R
\name{plot_rater_severity_profile}
\alias{plot_rater_severity_profile}
\title{Plot per-rater severity ranking with confidence interval whiskers}
\usage{
plot_rater_severity_profile(
  fit,
  diagnostics = NULL,
  facet = "Rater",
  ci_level = 0.95,
  show_bands = TRUE,
  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. When omitted,
\code{diagnose_mfrm(fit, residual_pca = "none")} is run internally.}

\item{facet}{Facet name to plot (default \code{"Rater"}). Any non-Person
facet name is accepted.}

\item{ci_level}{Confidence level used for the whiskers (default
\code{0.95}). Bounds use \verb{+/- z * ModelSE}.}

\item{show_bands}{Logical. When \code{TRUE} (default) draw shaded
\verb{+/-0.5} (gentle) and \verb{+/-1.0} (strict) logit guidance bands.}

\item{preset}{Visual preset.}

\item{draw}{If \code{TRUE}, draw with base graphics.}
}
\value{
An \code{mfrm_plot_data} object whose \code{data} slot contains
columns \code{Level}, \code{Estimate}, \code{SE}, \code{CI_Lower}, \code{CI_Upper},
\code{Band}.
}
\description{
Ranks the levels of a chosen rater facet by estimated severity and
draws each level as a horizontal CI whisker around the point
estimate. Optional gentle / strict guidance bands at \verb{+/-0.5} and
\verb{+/-1.0} logit relative to the centred mean make rater calibration
easy to read for training feedback.
}
\section{Interpreting output}{

The vertical reference line at zero is the sum-to-zero centring
point. Levels well within \verb{+/- 0.5 logit} (gentle band) are
typically interchangeable in operational scoring; levels outside
\verb{+/- 1.0 logit} (strict band) deserve targeted training or
anchoring.
}

\examples{
toy <- load_mfrmr_data("example_core")
fit <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score",
                method = "JML", maxit = 30)
p <- plot_rater_severity_profile(fit, draw = FALSE)
head(p$data$data)
}
\seealso{
\code{\link[=diagnose_mfrm]{diagnose_mfrm()}}, \code{\link[=analyze_facet_equivalence]{analyze_facet_equivalence()}},
\code{\link[=plot_facet_equivalence]{plot_facet_equivalence()}}.
}
\concept{confidence intervals}
\concept{rater severity}
\concept{visual diagnostics}
