% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/cluster_choice.R
\name{plot.cluster_choice}
\alias{plot.cluster_choice}
\title{Plot Method for cluster_choice}
\usage{
\method{plot}{cluster_choice}(
  x,
  type = c("auto", "lines", "bars", "heatmap", "tradeoff", "facet"),
  abbrev = FALSE,
  combined = TRUE,
  ...
)
}
\arguments{
\item{x}{A \code{cluster_choice} object.}

\item{type}{Character. One of \code{"auto"} (default), \code{"lines"},
\code{"bars"}, \code{"heatmap"}, \code{"tradeoff"}, \code{"facet"}.}

\item{abbrev}{Logical. If \code{TRUE}, dissimilarity and method names
shown on tick labels and point labels are shortened (e.g.
\code{"hamming"} -> \code{"ham"}, \code{"ward.D2"} -> \code{"wD2"}).
The legend shows the full canonical name. Default \code{FALSE}.}

\item{combined}{Only meaningful for \code{type = "facet"}. When
\code{TRUE} (default), all methods are shown in one ggplot via
\code{facet_wrap(~ method)}. When \code{FALSE}, returns a named list
of single-panel ggplots, one per method.}

\item{...}{Unsupported. Supplying unused arguments raises an error.}
}
\value{
A \code{ggplot} object, invisibly; for \code{type = "facet"}
with \code{combined = FALSE}, a named list of ggplots.
}
\description{
Six explicit chart types plus a smart \code{"auto"} default. The user
picks the shape; the function does not editorialise (no "best"
annotation, no interpretive subtitles, no inferred recommendation).
}
\details{
Type cheat-sheet:
\describe{
\item{\code{"auto"}}{Default. Picks one of the others based on which
axes were swept. k-only -> \code{"lines"}; one categorical axis
swept -> \code{"bars"}; k plus one categorical -> \code{"lines"};
k plus two categoricals -> \code{"facet"}; both categoricals
without k -> \code{"heatmap"}.}
\item{\code{"lines"}}{Silhouette across k (and \code{mean_within_dist}
when \code{k} is the only swept axis), one line per non-k axis
when present.}
\item{\code{"bars"}}{Horizontal bar chart of silhouette per axis
level. Bars sorted by silhouette.}
\item{\code{"heatmap"}}{Tiled silhouette across two categorical
axes. Requires both \code{dissimilarity} and \code{method} swept.}
\item{\code{"tradeoff"}}{Scatter: silhouette (y) vs \code{size_ratio}
(x). Works for any sweep; labels each point.}
\item{\code{"facet"}}{Lines vs k, colour by one categorical axis,
facet by another. Requires \code{k} plus two categoricals.}
}

Asking for a type the data can't support raises an error pointing at
the alternatives.
}
