% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/model.R
\name{add_client_group}
\alias{add_client_group}
\title{Add a mutually exclusive group of clients}
\usage{
add_client_group(model, clients, required = FALSE)
}
\arguments{
\item{model}{A \code{vrpr_model}.}

\item{clients}{Vector of client numbers (1-based, in the order of
\code{\link[=add_clients]{add_clients()}}) that form the group.}

\item{required}{If \code{TRUE}, exactly one client in the group must be visited;
if \code{FALSE} (default), at most one.}
}
\value{
The updated \code{vrpr_model}.
}
\description{
Defines a group from which at most one client is visited (or exactly one if
\code{required = TRUE}). Useful for prize-collecting with exclusive alternatives
(e.g. serving one of several equivalent points). Clients in the group
automatically become optional (individual \code{required = FALSE}); use \code{prize} to
encourage a visit.
}
