% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/progression.R
\name{gb_progression}
\alias{gb_progression}
\title{Track an appraisal across SOC, OBC, and FBC stages}
\usage{
gb_progression(soc, obc = NULL, fbc = NULL)
}
\arguments{
\item{soc}{Strategic Outline Case \code{gb_appraisal}.}

\item{obc}{Outline Business Case \code{gb_appraisal}. Optional.}

\item{fbc}{Full Business Case \code{gb_appraisal}. Optional.}
}
\value{
A \code{gb_progression} object with elements \code{stages},
\code{evolution} (data frame), \code{delta_npv}, \code{delta_costs}.
}
\description{
Builds a \code{gb_progression} showing how NPV, BCR, and key
parameters evolve across the three Green Book business case
stages: Strategic Outline Case (SOC), Outline Business Case
(OBC), and Full Business Case (FBC). Useful for both authoring
a multi-stage appraisal and reviewing how figures have moved
between gateway approvals.
}
\details{
At each stage, optimism bias mitigation typically increases as
project definition firms up. Cost estimates converge towards
base-cost reality; benefit estimates may also shift as evidence
accumulates. The \code{evolution} table makes the trajectory visible.
}
\examples{
soc <- gb_appraise(c(100, 0, 0, 0, 0), c(0, 30, 30, 30, 30),
                   ob = "non_standard_buildings", ob_mitigation = 0)
obc <- gb_appraise(c(100, 0, 0, 0, 0), c(0, 30, 30, 30, 30),
                   ob = "non_standard_buildings", ob_mitigation = 0.5)
fbc <- gb_appraise(c(100, 0, 0, 0, 0), c(0, 30, 30, 30, 30),
                   ob = "non_standard_buildings", ob_mitigation = 0.9)
gb_progression(soc, obc, fbc)
}
\references{
HM Treasury (2018). Guide to Developing the Project
Business Case (Green Book supplementary guidance).
}
\seealso{
\code{\link[=gb_appraise]{gb_appraise()}}.

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