Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

plot.forecast

Forecast plot

Description

Plots historical data with forecasts and prediction intervals.

Usage

## S3 method for class 'forecast'
plot(
  x,
  include,
  PI = TRUE,
  showgap = TRUE,
  shaded = TRUE,
  shadebars = (length(x$mean) < 5),
  shadecols = NULL,
  col = 1,
  fcol = 4,
  pi.col = 1,
  pi.lty = 2,
  ylim = NULL,
  main = NULL,
  xlab = "",
  ylab = "",
  type = "l",
  flty = 1,
  flwd = 2,
  ...
)

## S3 method for class 'forecast'
autoplot(
  object,
  include,
  PI = TRUE,
  shadecols = c("#596DD5", "#D5DBFF"),
  fcol = "#0000AA",
  flwd = 0.5,
  ...
)

## S3 method for class 'splineforecast'
autoplot(object, PI = TRUE, ...)

## S3 method for class 'forecast'
autolayer(object, series = NULL, PI = TRUE, showgap = TRUE, ...)

## S3 method for class 'splineforecast'
plot(x, fitcol = 2, type = "o", pch = 19, ...)

Arguments

x

Forecast object produced by forecast.
include

number of values from time series to include in plot. Default is all values.
PI

Logical flag indicating whether to plot prediction intervals.
showgap

If showgap=FALSE, the gap between the historical observations and the forecasts is removed.
shaded

Logical flag indicating whether prediction intervals should be shaded (TRUE) or lines (FALSE)
shadebars

Logical flag indicating if prediction intervals should be plotted as shaded bars (if TRUE) or a shaded polygon (if FALSE). Ignored if shaded=FALSE. Bars are plotted by default if there are fewer than five forecast horizons.
shadecols

Colors for shaded prediction intervals. To get default colors used prior to v3.26, set shadecols="oldstyle".
col

Colour for the data line.
fcol

Colour for the forecast line.
pi.col

If shaded=FALSE and PI=TRUE, the prediction intervals are plotted in this colour.
pi.lty

If shaded=FALSE and PI=TRUE, the prediction intervals are plotted using this line type.
ylim

Limits on y-axis.
main

Main title.
xlab

X-axis label.
ylab

Y-axis label.
type

1-character string giving the type of plot desired. As for plot.default.
flty

Line type for the forecast line.
flwd

Line width for the forecast line.
...

Other plotting parameters to affect the plot.
object

Forecast object produced by forecast. Used for ggplot graphics (S3 method consistency).
series

Matches an unidentified forecast layer with a coloured object on the plot.
fitcol

Line colour for fitted values.
pch

Plotting character (if type=="p" or type=="o").

Details

autoplot will produce a ggplot object.

plot.splineforecast autoplot.splineforecast

Value

None.

Author(s)

Rob J Hyndman & Mitchell O'Hara-Wild

References

Hyndman and Athanasopoulos (2018) Forecasting: principles and practice, 2nd edition, OTexts: Melbourne, Australia. https://otexts.com/fpp2/

See Also

Examples

library(ggplot2)

wine.fit <- hw(wineind,h=48)
plot(wine.fit)
autoplot(wine.fit)

fit <- tslm(wineind ~ fourier(wineind,4))
fcast <- forecast(fit, newdata=data.frame(fourier(wineind,4,20)))
autoplot(fcast)

fcast <- splinef(airmiles,h=5)
plot(fcast)
autoplot(fcast)
forecast

Forecasting Functions for Time Series and Linear Models

v8.14
GPL-3
Authors
Rob Hyndman [aut, cre, cph] (<https://orcid.org/0000-0002-2140-5352>), George Athanasopoulos [aut], Christoph Bergmeir [aut] (<https://orcid.org/0000-0002-3665-9021>), Gabriel Caceres [aut], Leanne Chhay [aut], Mitchell O'Hara-Wild [aut] (<https://orcid.org/0000-0001-6729-7695>), Fotios Petropoulos [aut] (<https://orcid.org/0000-0003-3039-4955>), Slava Razbash [aut], Earo Wang [aut], Farah Yasmeen [aut] (<https://orcid.org/0000-0002-1479-5401>), R Core Team [ctb, cph], Ross Ihaka [ctb, cph], Daniel Reid [ctb], David Shaub [ctb], Yuan Tang [ctb] (<https://orcid.org/0000-0001-5243-233X>), Zhenyu Zhou [ctb]
Initial release

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.