es() is a part of smooth package. It allows constructing Exponential Smoothing (also known as ETS), selecting the most appropriate one among 30 possible ones, including exogenous variables and many more.
In this vignette we will use data from Mcomp package, so it is adviced to install it.
Let’s load the necessary packages:
require(smooth)
require(Mcomp)You may note that Mcomp depends on forecast package and if you load both forecast and smooth, then you will have a message that forecast() function is masked from the environment. There is nothing to be worried about - smooth uses this function for consistency purposes and has exactly the same original forecast() as in the forecast package. The inclusion of this function in smooth was done only in order not to include forecast in dependencies of the package.
The simplest call of this function is:
es(M3$N2457$x, h=18, holdout=TRUE)## Forming the pool of models based on... ANN, ANA, AAN, Estimation progress: 100%... Done!## Time elapsed: 0.35 seconds
## Model estimated: ETS(MNN)
## Persistence vector g:
## alpha
## 0.145
## Initial values were optimised.
## 3 parameters were estimated in the process
## Residuals standard deviation: 0.413
## Cost function type: MSE; Cost function value: 1288657
##
## Information criteria:
## AIC AICc BIC
## 1645.978 1646.236 1653.702
## Forecast errors:
## MPE: 26.3%; Bias: 87%; MAPE: 39.8%; SMAPE: 49.4%
## MASE: 2.944; sMAE: 120.1%; RelMAE: 1.258; sMSE: 242.7%
In this case function uses branch and bound algorithm to form a pool of models to check and after that constructs a model with the lowest information criterion. As we can see, it also produces an output with brief information about the model, which contains:
holdout=TRUE).The function has also produced a graph with actuals, fitted values and point forecasts.
If we need prediction intervals, then we run:
es(M3$N2457$x, h=18, holdout=TRUE, intervals=TRUE)## Forming the pool of models based on... ANN, ANA, AAN, Estimation progress: 100%... Done!## Time elapsed: 0.35 seconds
## Model estimated: ETS(MNN)
## Persistence vector g:
## alpha
## 0.145
## Initial values were optimised.
## 3 parameters were estimated in the process
## Residuals standard deviation: 0.413
## Cost function type: MSE; Cost function value: 1288657
##
## Information criteria:
## AIC AICc BIC
## 1645.978 1646.236 1653.702
## 95% parametric prediction intervals were constructed
## 72% of values are in the prediction interval
## Forecast errors:
## MPE: 26.3%; Bias: 87%; MAPE: 39.8%; SMAPE: 49.4%
## MASE: 2.944; sMAE: 120.1%; RelMAE: 1.258; sMSE: 242.7%
Due to multiplicative nature of error term in the model, the intervals are asymmetric. This is the expected behaviour. The other thing to note is that the output now also provides the theoretical width of prediction intervals and its actual coverage.
If we save the model (and let’s say we want it to work silently):
ourModel <- es(M3$N2457$x, h=18, holdout=TRUE, silent="all")we can then reuse it for different purposes:
es(M3$N2457$x, model=ourModel, h=18, holdout=FALSE, intervals="np", level=0.93)## Time elapsed: 0.09 seconds
## Model estimated: ETS(MNN)
## Persistence vector g:
## alpha
## 0.145
## Initial values were provided by user.
## 3 parameters were estimated in the process
## Residuals standard deviation: 0.434
## Cost function type: MSE; Cost function value: 1965686
##
## Information criteria:
## AIC AICc BIC
## 1998.861 1999.078 2007.096
## 93% nonparametric prediction intervals were constructed
We can also extract the type of model in order to reuse it later:
model.type(ourModel)## [1] "MNN"This handy function, by the way, also works with ets() from forecast package.
We can then use persistence or initials only from the model to construct the other one:
es(M3$N2457$x, model=model.type(ourModel), h=18, holdout=FALSE, initial=ourModel$initial, silent="graph")## Time elapsed: 0.03 seconds
## Model estimated: ETS(MNN)
## Persistence vector g:
## alpha
## 0.151
## Initial values were provided by user.
## 3 parameters were estimated in the process
## Residuals standard deviation: 0.434
## Cost function type: MSE; Cost function value: 1965401
##
## Information criteria:
## AIC AICc BIC
## 1998.845 1999.061 2007.079es(M3$N2457$x, model=model.type(ourModel), h=18, holdout=FALSE, persistence=ourModel$persistence, silent="graph")## Time elapsed: 0.05 seconds
## Model estimated: ETS(MNN)
## Persistence vector g:
## alpha
## 0.145
## Initial values were optimised.
## 3 parameters were estimated in the process
## Residuals standard deviation: 0.434
## Cost function type: MSE; Cost function value: 1965686
##
## Information criteria:
## AIC AICc BIC
## 1998.861 1999.078 2007.096or provide some arbitrary values:
es(M3$N2457$x, model=model.type(ourModel), h=18, holdout=FALSE, initial=1500, silent="graph")## Time elapsed: 0.03 seconds
## Model estimated: ETS(MNN)
## Persistence vector g:
## alpha
## 0.15
## Initial values were provided by user.
## 3 parameters were estimated in the process
## Residuals standard deviation: 0.435
## Cost function type: MSE; Cost function value: 1968546
##
## Information criteria:
## AIC AICc BIC
## 1999.029 1999.245 2007.263Using some other parameters may lead to completely different model and forecasts:
es(M3$N2457$x, h=18, holdout=TRUE, cfType="aMSTFE", bounds="a", ic="BIC", intervals=TRUE)## Forming the pool of models based on... ANN, ANA, AAN, Estimation progress: 100%... Done!## Time elapsed: 0.55 seconds
## Model estimated: ETS(MNN)
## Persistence vector g:
## alpha
## 0.08
## Initial values were optimised.
## 3 parameters were estimated in the process
## Residuals standard deviation: 0.42
## Cost function type: aMSTFE; Cost function value: 246
##
## Information criteria:
## AIC AICc BIC
## 25551.52 25556.16 25690.55
## 95% parametric prediction intervals were constructed
## 72% of values are in the prediction interval
## Forecast errors:
## MPE: 33.3%; Bias: 90.4%; MAPE: 43.3%; SMAPE: 56.3%
## MASE: 3.232; sMAE: 131.9%; RelMAE: 1.381; sMSE: 277.6%
You can play around with all the available parameters to see what’s their effect on final model.
In order to combine forecasts we need to use “C” letter:
es(M3$N2457$x, model="CCN", h=18, holdout=TRUE, silent="graph")## Estimation progress: 10%20%30%40%50%60%70%80%90%100%... Done!## Time elapsed: 1.33 seconds
## Model estimated: ETS(CCN)
## Initial values were optimised.
## Residuals standard deviation: 1406.273
## Cost function type: MSE
##
## Information criteria:
## Combined AICc
## 1647.524
## Forecast errors:
## MPE: 27.2%; Bias: 88.1%; MAPE: 40.3%; SMAPE: 50.3%
## MASE: 2.982; sMAE: 121.7%; RelMAE: 1.274; sMSE: 247.3%Model selection from a specified pool and forecasts combination are called using respectively:
es(M3$N2457$x, model=c("ANN","AAN","AAdN","ANA","AAA","AAdA"), h=18, holdout=TRUE, silent="graph")## Estimation progress: 17%33%50%67%83%100%... Done!## Time elapsed: 0.73 seconds
## Model estimated: ETS(ANN)
## Persistence vector g:
## alpha
## 0.158
## Initial values were optimised.
## 3 parameters were estimated in the process
## Residuals standard deviation: 1439.368
## Cost function type: MSE; Cost function value: 2007705
##
## Information criteria:
## AIC AICc BIC
## 1688.987 1689.245 1696.711
## Forecast errors:
## MPE: 25.3%; Bias: 86%; MAPE: 39.4%; SMAPE: 48.6%
## MASE: 2.909; sMAE: 118.7%; RelMAE: 1.243; sMSE: 238.1%es(M3$N2457$x, model=c("CCC","ANN","AAN","AAdN","ANA","AAA","AAdA"), h=18, holdout=TRUE, silent="graph")## Estimation progress: 17%33%50%67%83%100%... Done!## Time elapsed: 0.86 seconds
## Model estimated: ETS(CCC)
## Initial values were optimised.
## Residuals standard deviation: 1387.792
## Cost function type: MSE
##
## Information criteria:
## Combined AICc
## 1689.582
## Forecast errors:
## MPE: 21.6%; Bias: 83.1%; MAPE: 38.5%; SMAPE: 46.1%
## MASE: 2.798; sMAE: 114.2%; RelMAE: 1.195; sMSE: 224.2%Now let’s introduce some artificial exogenous variables:
x <- cbind(rnorm(length(M3$N2457$x),50,3),rnorm(length(M3$N2457$x),100,7))and fit a model with all the exogenous first:
es(M3$N2457$x, model="ZZZ", h=18, holdout=TRUE, xreg=x)## Forming the pool of models based on... ANN, ANA, AAN, Estimation progress: 100%... Done!## Time elapsed: 0.63 seconds
## Model estimated: ETSX(MNN)
## Persistence vector g:
## alpha
## 0.146
## Initial values were optimised.
## 5 parameters were estimated in the process
## Residuals standard deviation: 0.417
## Xreg coefficients were estimated in a normal style
## Cost function type: MSE; Cost function value: 1288488
##
## Information criteria:
## AIC AICc BIC
## 1649.965 1650.624 1662.839
## Forecast errors:
## MPE: 26.2%; Bias: 87.1%; MAPE: 39.8%; SMAPE: 49.4%
## MASE: 2.943; sMAE: 120.1%; RelMAE: 1.257; sMSE: 243.2%
or construct a model with selected exogenous (based on IC):
es(M3$N2457$x, model="ZZZ", h=18, holdout=TRUE, xreg=x, xregDo="select")## Forming the pool of models based on... ANN, ANA, AAN, Estimation progress: 100%... Done!## Time elapsed: 0.39 seconds
## Model estimated: ETS(MNN)
## Persistence vector g:
## alpha
## 0.145
## Initial values were optimised.
## 4 parameters were estimated in the process
## Residuals standard deviation: 0.415
## Cost function type: MSE; Cost function value: 1288657
##
## Information criteria:
## AIC AICc BIC
## 1647.978 1648.413 1658.277
## Forecast errors:
## MPE: 26.3%; Bias: 87%; MAPE: 39.8%; SMAPE: 49.4%
## MASE: 2.944; sMAE: 120.1%; RelMAE: 1.258; sMSE: 242.7%
or the one with the updated xreg:
ourModel <- es(M3$N2457$x, model="ZZZ", h=18, holdout=TRUE, xreg=x, updateX=TRUE)## Forming the pool of models based on... ANN, ANA, AAN, Estimation progress: 100%... Done!
If we are confused about the type of estimated model, the function formula() will help us:
formula(ourModel)## [1] "y[t] = l[t-1] * exp(a1[t-1] * x1[t] + a2[t-1] * x2[t]) * e[t]"