% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/visualization.R
\name{plot_delta_auc_heatmap}
\alias{plot_delta_auc_heatmap}
\title{Heatmap of differential AUC across conditions or cell lines}
\usage{
plot_delta_auc_heatmap(
  data,
  drug_col = "drug_name",
  value_cols = NULL,
  cell_types = NULL,
  cluster_rows = TRUE,
  cluster_columns = TRUE,
  name = "delta AUC"
)
}
\arguments{
\item{data}{A data frame with one row per drug: a drug identifier column and
one numeric delta-AUC column per condition or cell line.}

\item{drug_col}{Name of the drug identifier column, as a string. Default
\code{"drug_name"}.}

\item{value_cols}{Character vector of the delta-AUC column names to display.
Defaults to every numeric column other than \code{drug_col}.}

\item{cell_types}{Optional named character vector mapping each column in
\code{value_cols} to a group label (for example \code{"Cancer"} or \code{"Normal"}) used
to annotate the heatmap.}

\item{cluster_rows, cluster_columns}{Logical, whether to cluster drugs and
conditions respectively. Defaults \code{TRUE}.}

\item{name}{Legend title. Default \code{"delta AUC"}.}
}
\value{
A \link[ComplexHeatmap:Heatmap-class]{ComplexHeatmap::Heatmap} object, which is drawn when
printed. Rows with missing values are dropped before plotting.
}
\description{
Draws a diverging heatmap of differential (delta) AUC values with drugs on
one axis and conditions/cell lines on the other, using \pkg{ComplexHeatmap}.
Colours are centred at zero so that sensitising (negative) and antagonising
(positive) responses are visually separated.
}
\details{
Requires the suggested packages \pkg{ComplexHeatmap} and
\pkg{circlize}.
}
\examples{
if (requireNamespace("ComplexHeatmap", quietly = TRUE) &&
    requireNamespace("circlize", quietly = TRUE)) {
  ht <- plot_delta_auc_heatmap(
    screen_delta_auc,
    value_cols = c("A549", "H1299", "H1975", "MRC5")
  )
}

}
\seealso{
\code{\link[=plot_condition_scatter]{plot_condition_scatter()}}
}
