% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/boe_mpr_forecasts.R
\name{boe_mpr_forecasts}
\alias{boe_mpr_forecasts}
\title{Monetary Policy Report forecast data}
\source{
\url{https://www.bankofengland.co.uk/monetary-policy}
}
\usage{
boe_mpr_forecasts(
  series = c("cpi_inflation", "gdp_growth", "gdp_level", "unemployment", "bank_rate"),
  month = NULL,
  year = NULL,
  cache = TRUE
)
}
\arguments{
\item{series}{Character vector. One or more of:
\code{"cpi_inflation"}, \code{"gdp_growth"}, \code{"gdp_level"},
\code{"unemployment"}, \code{"bank_rate"}. Defaults to all five.}

\item{month}{Character. \code{"february"}, \code{"may"}, \code{"august"}, or
\code{"november"}. If \code{NULL}, the most recent quarterly release is
used.}

\item{year}{Integer. MPR year, 2019 or later. If \code{NULL}, the most
recent quarterly release is used.}

\item{cache}{Logical. Use cached download if available (default
\code{TRUE}). Older releases never change so the cache never expires;
the latest release is refreshed if older than 24 hours.}
}
\value{
A \code{boe_tbl} data frame with columns:
\describe{
\item{date}{Date. Publication date of the MPR (start of quarter
the report covers).}
\item{horizon}{Character. Forecast horizon label (e.g. \code{"2026 Q1"}).}
\item{horizon_date}{Date. Start of the forecast quarter.}
\item{series}{Character. Series identifier (e.g. \code{"cpi_inflation"}).}
\item{value}{Numeric. Forecast value (percent for rates and
growth; index for \code{gdp_level}).}
}
}
\description{
Downloads the Bank of England's Monetary Policy Report (MPR) and
parses headline projections from the Projections Databank workbook.
Returns a long-format data frame where each row is one (publication
date, forecast horizon, series) triple.
}
\details{
Coverage runs quarterly from November 2019 (when the report was
renamed from Inflation Report) to the latest published release.

Requires the \pkg{readxl} package. The MPR is published as a zip
archive containing a Projections Databank workbook plus chart data
and slides; this function only reads the projection sheets.

Each row of a projection sheet is one MPR publication; columns are
forecast quarters. The same publication therefore contributes
multiple rows here, one per forecast horizon.
}
\section{Older releases}{

Pre-2025 MPRs are packaged differently and do not contain a single
"Projections Databank" workbook. This function targets the post-2025
format and may error on older releases.
}

\examples{
\donttest{
if (requireNamespace("readxl", quietly = TRUE)) {
  op <- options(boe.cache_dir = tempdir())

  # Latest CPI inflation projections
  cpi <- boe_mpr_forecasts(series = "cpi_inflation")
  head(cpi)

  options(op)
}
}

}
\seealso{
\code{\link[=boe_mpc_decisions]{boe_mpc_decisions()}}, \code{\link[=boe_mpc_votes]{boe_mpc_votes()}}

Other monetary policy: 
\code{\link{boe_mpc_decisions}()},
\code{\link{boe_mpc_votes}()}
}
\concept{monetary policy}
