% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/place_based.R
\name{gb_place_based}
\alias{gb_place_based}
\title{Aggregate sub-projects into a place-based business case}
\usage{
gb_place_based(..., place = NULL, synergy = 0)
}
\arguments{
\item{...}{\code{gb_appraisal} objects representing sub-projects.
Pass as named arguments to label each.}

\item{place}{Character scalar. Place name (e.g. \code{"Greater Manchester"}). Optional.}

\item{synergy}{Numeric scalar in \verb{[-0.5, 0.5]}. Optional uplift
applied to aggregate benefits to capture cross-project synergy
or drag. Default \code{0} (additive aggregation).}
}
\value{
A \code{gb_place_based} object with elements \code{projects},
\code{place}, \code{aggregate_npv}, \code{aggregate_bcr}, \code{per_project},
\code{synergy}.
}
\description{
Combines multiple \code{gb_appraisal} objects into a single portfolio
appraisal. Introduced in the 2026 Green Book as a recognised
business case structure for places (city deals, devolved
settlements, regional packages) where individual projects are
interdependent.
}
\examples{
transport <- gb_appraise(c(100, 0, 0, 0, 0), c(0, 30, 30, 30, 30))
housing <- gb_appraise(c(50, 0, 0, 0, 0), c(0, 20, 20, 20, 20))
skills <- gb_appraise(c(20, 20, 0, 0, 0), c(0, 0, 15, 15, 15))
gb_place_based(transport = transport, housing = housing,
               skills = skills, place = "Example City")
}
\references{
HM Treasury (2026). The Green Book, on place-based
business cases.
}
\seealso{
\code{\link[=gb_appraise]{gb_appraise()}}, \code{\link[=gb_compare]{gb_compare()}}.

Other appraisal: 
\code{\link{gb_appraise}()},
\code{\link{gb_compare}()},
\code{\link{gb_economic_case}()},
\code{\link{gb_progression}()},
\code{\link{gb_risk_register}()},
\code{\link{gb_sensitivity_ob}()},
\code{\link{gb_validate}()}
}
\concept{appraisal}
