# plot.forecast

##### Forecast plot

Plots historical data with forecasts and prediction intervals.

- Keywords
- ts

##### Usage

```
# S3 method for 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 forecast
autoplot(object, include, PI = TRUE,
shadecols = c("#596DD5", "#D5DBFF"), fcol = "#0000AA", flwd = 0.5, ...)

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

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

# S3 method for 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.

##### References

Hyndman and Athanasopoulos (2014) *Forecasting: principles
and practice*, OTexts: Melbourne, Australia.
http://www.otexts.org/fpp/

##### See Also

##### Examples

```
# NOT RUN {
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)
# }
```

*Documentation reproduced from package forecast, version 8.1, License: GPL (>= 3)*