% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-reports.R
\name{subset_connectivity_report}
\alias{subset_connectivity_report}
\title{Build a subset connectivity report (preferred alias)}
\usage{
subset_connectivity_report(
  fit,
  diagnostics = NULL,
  top_n_subsets = NULL,
  min_observations = 0
)
}
\arguments{
\item{fit}{Output from \code{\link[=fit_mfrm]{fit_mfrm()}}.}

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

\item{top_n_subsets}{Optional maximum number of subset rows to keep.}

\item{min_observations}{Minimum observations required to keep a subset row.}
}
\value{
A named list with subset-connectivity components. Class:
\code{mfrm_subset_connectivity}.
}
\description{
Build a subset connectivity report (preferred alias)
}
\details{
\code{summary(out)} is supported through \code{summary()}.
\code{plot(out)} is dispatched through \code{plot()} for class
\code{mfrm_subset_connectivity} (\code{type = "subset_observations"},
\code{"facet_levels"}, or \code{"linking_matrix"} / \code{"coverage_matrix"} /
\code{"design_matrix"} / \code{"network"}). The network route returns reusable node
and edge tables with \code{draw = FALSE}; drawing uses \code{igraph} when available.
}
\section{Interpreting output}{

\itemize{
\item \code{summary}: number and size of connected subsets.
\item subset table: whether data are fragmented into disconnected components.
\item facet-level columns: where connectivity bottlenecks occur.
}
}

\section{Typical workflow}{

\enumerate{
\item Run \code{subset_connectivity_report(fit)}.
\item Confirm near-single-subset structure when possible.
\item Use results to justify linking/anchoring strategy.
}
}

\examples{
toy <- load_mfrmr_data("example_core")
fit <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score", method = "JML", maxit = 30)
out <- subset_connectivity_report(fit)
summary(out)
p_sub <- plot(out, draw = FALSE)
p_design <- plot(out, type = "design_matrix", draw = FALSE)
p_net <- plot(out, type = "network", draw = FALSE)
p_sub$data$plot
p_design$data$plot
p_net$data$edges
out$summary[, c("Subset", "Observations", "ObservationPercent")]
}
\seealso{
\code{\link[=diagnose_mfrm]{diagnose_mfrm()}}, \code{\link[=mfrm_network_analysis]{mfrm_network_analysis()}},
\code{\link[=measurable_summary_table]{measurable_summary_table()}}, \code{\link[=data_quality_report]{data_quality_report()}}, \link{mfrmr_linking_and_dff},
\link{mfrmr_visual_diagnostics}
}
