% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/utils_hts.R
\name{check_control_label}
\alias{check_control_label}
\title{Validate control-well labelling}
\usage{
check_control_label(data, type_col = "well_type", required = c("NC", "PC"))
}
\arguments{
\item{data}{A data frame of well-level readouts.}

\item{type_col}{Name of the well-type column, as a string. Default
\code{"well_type"}.}

\item{required}{Character vector of labels that must be present. Default
\code{c("NC", "PC")}; add \code{"Blank"} if background subtraction is planned.}
}
\value{
Invisibly, a list with \code{ok} (logical), \code{present} and \code{missing}
(character vectors) and \code{counts} (a table of well-type frequencies). A
warning is emitted when any required label is missing.
}
\description{
Checks that a data frame contains the expected negative-, positive- and
blank-control labels in its well-type column, so that normalisation and QC
can be carried out. It is a light-weight guard to run right after import.
}
\examples{
d <- data.frame(well_type = c("NC", "NC", "PC", "compound"))
check_control_label(d)

}
