% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-plotting-secondary.R
\name{plot_reliability_snapshot}
\alias{plot_reliability_snapshot}
\title{Facet reliability and separation snapshot bar plot}
\usage{
plot_reliability_snapshot(
  fit,
  diagnostics = NULL,
  metric = c("reliability", "separation", "strata"),
  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. Computed on
demand when omitted.}

\item{metric}{\code{"reliability"} (default), \code{"separation"}, or
\code{"strata"}.}

\item{preset}{Visual preset.}

\item{draw}{If \code{TRUE}, draw with base graphics.}
}
\value{
An \code{mfrm_plot_data} whose \code{data} slot bundles a tidy
\code{Facet}, \code{Metric}, \code{Value} data frame.
}
\description{
Compact facet-level visual of the Wright & Masters (1982)
separation, strata, and reliability indices that
\code{\link[=diagnose_mfrm]{diagnose_mfrm()}} computes. Helpful as a single small figure for
"are persons / raters / criteria distinguishable?" review.
These are Rasch/FACETS-style separation indices on the fitted logit
scale, not ICCs; use \code{\link[=compute_facet_icc]{compute_facet_icc()}} for the complementary
observed-score variance-share view.
}
\examples{
toy <- load_mfrmr_data("example_core")
fit <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score",
                 method = "JML", maxit = 30)
p <- plot_reliability_snapshot(fit, draw = FALSE)
p$data$table
# Look for (default `metric = "reliability"`):
# - >= 0.9 strong, 0.7-0.9 adequate, < 0.7 weak (Wright & Masters 1982).
# - The Person row is the operative reliability for ability scores.
# - Non-Person rows (Rater / Criterion) report the same index but
#   should be read as "are facet elements distinguishable?"; values
#   close to 1 mean facet means differ reliably from each other.
}
\seealso{
\code{\link[=diagnose_mfrm]{diagnose_mfrm()}}, \link{mfrmr_visual_diagnostics}
}
