Introducing Modeltime Ensemble: Time Series Forecast Stacking
Written by Matt Dancho
I’m SUPER EXCITED to introduce modeltime.ensemble
. Modeltime Ensemble implements three competitionwinning forecasting strategies. This article (recently updated) introduces Modeltime Ensemble, which makes it easy to perform blended and stacked forecasts that improve forecast accuracy.
 We’ll quickly introduce you to the growing modeltime ecosystem.
 We’ll explain what Modeltime Ensemble does.
 Then, we’ll do a Modeltime Ensemble Forecast Tutorial using the
modeltime.ensemble
If you like what you see, I have an Advanced Time Series Course where you will become the timeseries expert for your organization by learning modeltime
, modeltime.ensemble
, and timetk
.
Time Series Forecasting Article Guide:
This article is part of a series of software announcements on the Modeltime Forecasting Ecosystem.
Like these articles?
👉 Register to stay in the know
👈
on new cuttingedge R software like modeltime
.
Meet the Modeltime Ecosystem
A growing ecosystem for tidymodels forecasting
Modeltime Ensemble is part of a growing ecosystem of Modeltime forecasting packages. The main purpose of the Modeltime Ecosystem is to develop scalable forecasting systems.
Modeltime Ensemble
The time series ensemble API for Modeltime
Three months ago I introduced modeltime
, a new R package that speeds up forecasting experimentation and model selection with Machine Learning (XGBoost, GLMNET, Prophet, Prophet Boost, ARIMA, and ARIMA Boost). Fastforward to now. I’m thrilled to announce the first expansion to the Modeltime Ecosystem: modeltime.ensemble
.
Modeltime Ensemble is a cuttingedge package that integrates competitionwinning time series ensembling strategies:

Stacked MetaLearners

Weighted Ensembles

Average Ensembles
What is a Stacked Ensemble?
Using modeltime.ensemble
, you can build something called a Stacked Ensemble. Let’s break this down:

An ensemble is just a combination of models. We can combine them in many ways.

One method is stacking, which typically uses a “metalearning algorithm” to learn how to combine “submodels” (the lower level models used as inputs to the stacking algorithm)
Stacking Diagram
Here’s a MultiLevel Stack, which won the Kaggle Grupo Bimbo Inventory Demand Forecasting Competition.
The MultiLevel Stacked Ensemble that won the Kaggle Grupo Bimbo Inventory Demand Challenge
The multilevel stack can be broken down:

Level 1  SubModels. Includes models like ARIMA, Elastic Net, Support Vector Machines, or XGBoost. These models each predict independently on the time series data.

Level 2  Stacking Algorithms. Stacking algorithms learn how to combine each of the submodels by training a “metamodel” on the predictions from the submodels.

Level 3  Weighted Stacking. Weighted stacking is a simple approach that is fast and effective. It’s a very simple approach where we apply a weighting and average the predictions of the incoming models. We can use this approach on submodels, stacked models, or even a combination of stacked and submodels. We decide the weighting.
I teach how to do a MultiLevel Stack in Module 14 of my HighPerformance Time Series Forecasting Course.
What Modeltime Ensemble Functions do I need to know?
Here’s the lowdown on which functions you’ll need to learn to implement different strategies. I teach these in in Module 14 of my HighPerformance Time Series Forecasting Course.

Stacked MetaLearners: Use
modeltime_fit_resamples()
to create submodel predictions. Useensemble_model_spec()
to create super learners (models that learn from the predictions of submodels). 
Weighted Ensembles: Use
ensemble_weighted()
to create weighted ensemble blends. You choose the weights. 
Average Ensembles: Use
ensemble_average()
to build simple average and median ensembles. No decisions necessary, but accuracy may be suboptimal.
Ensemble Tutorial
Forecasting with Weighted Ensembles
Today, I’ll cover forecasting Product Sales Demand with Average and Weighted Ensembles, which are fast to implement and can have good performance (although stacked ensembles tend to have better performance).
Get the Cheat Sheet
As you go through this tutorial, it may help to use the Ultimate R Cheat Sheet. Page 3 Covers the Modeltime Forecasting Ecosystem with links to key documentation.
Forecasting Ecosystem Links (Ultimate R Cheat Sheet)
Modeltime Ensemble Diagram
Here’s an ensemble diagram of what we are going to accomplish.
Weighted Stacking, Modeltime Ensemble Diagram
Modeltime Ensemble Functions used in this Tutorial
The idea is that we have several submodels (Level 1) that make predictions. We can then take these predictions and blend them using weighting and averaging techniques (Level 2):
 Simple Average: Weights all models with the same proportion. Selects the average for each timestamp. Use
ensemble_average(type = "mean")
.  Median Average: No weighting. Selects prediction using the centered value for each time stamp. Use
ensemble_average(type = "median")
.  Weighted Average: User defines the weights (loadings). Applies a weighted average at each of the timestamps. Use
ensemble_weighted(loadings = c(1, 2, 3, 4))
.
More Advanced Ensembles: Stacked MetaLearners
The average and weighted ensembles are the simplest approaches to ensembling. One method that Modeltime Ensemble has integrated is Stacked MetaLearners, which learn from the predictions of submodels. We won’t cover stacked metalearners in this tutorial. But, I teach them in my HighPerformance Time Series Course. 💪
Getting Started
Let’s kick the tires on modeltime.ensemble
Install modeltime.ensemble
.
Load the following libraries.
Get Your Data
Forecasting Product Sales
Start with our Business Objective:
Our Business objective is to forecast the next 12weeks of Product Sales Demandgiven 2year sales history.
We’ll use the walmart_sales_weekly
time series data set that includes Walmart Product Transactions from several stores, which is a small sample of the dataset from Kaggle Walmart Recruiting  Store Sales Forecasting. We’ll simplify the data set to a univariate time series with columns, “Date” and “Weekly_Sales” from Store 1 and Department 1.
Next, visualize the dataset with the plot_time_series()
function. Toggle .interactive = TRUE
to get a plotly interactive plot. FALSE
returns a ggplot2 static plot.
Seasonality Evaluation
Let’s do a quick seasonality evaluation to hone in on important features using plot_seasonal_diagnostics()
.
We can see that certain weeks and months of the year have higher sales. These anomalies are likely due to events. The Kaggle Competition informed competitors that Super Bowl, Labor Day, Thanksgiving, and Christmas were special holidays. To approximate the events, week number and month may be good features. Let’s come back to this when we preprocess our data.
Train / Test
Split your time series into training and testing sets
Give the objective to forecast 12 weeks of product sales, we use time_series_split()
to make a train/test set consisting of 12weeks of test data (hold out) and the rest for training.
 Setting
assess = "12 weeks"
tells the function to use the last 12weeks of data as the testing set.  Setting
cumulative = TRUE
tells the sampling to use all of the prior data as the training set.
Next, visualize the train/test split.
tk_time_series_cv_plan()
: Converts the splits object to a data frameplot_time_series_cv_plan()
: Plots the time series sampling data using the “date” and “value” columns.
Feature Engineering
We’ll make a number of calendar features using recipes
. Most of the heavy lifting is done by timetk::step_timeseries_signature()
, which generates a series of common time series features. We remove the ones that won’t help. After dummying we have 74 total columns, 72 of which are engineered calendar features.
Make SubModels
Let’s make some submodels with Modeltime
Now for the fun part! Let’s make some models using functions from modeltime
and parsnip
.
Auto ARIMA
Here’s the basic Auto ARIMA Model.
 Model Spec:
arima_reg()
<– This sets up your general model algorithm and key parameters  Set Engine:
set_engine("auto_arima")
<– This selects the specific packagefunction to use and you can add any functionlevel arguments here.  Fit Model:
fit(Weekly_Sales ~ Date, training(splits))
<– All Modeltime Models require a date column to be a regressor.
Elastic Net
Making an Elastic NET model is easy to do. Just set up your model spec using linear_reg()
and set_engine("glmnet")
. Note that we have not fitted the model yet (as we did in previous steps).
Next, make a fitted workflow:
 Start with a
workflow()
 Add a Model Spec:
add_model(model_spec_glmnet)
 Add Preprocessing:
add_recipe(recipe_spec %>% step_rm(date))
<– Note that I’m removing the “date” column since Machine Learning algorithms don’t typically know how to deal with date or datetime features  Fit the Workflow:
fit(training(splits))
XGBoost
We can fit a XGBoost Model using a similar process as the Elastic Net.
NNETAR
We can use a NNETAR model. Note that add_recipe()
uses the full recipe (with the Date column) because this is a Modeltime Model.
Prophet w/ Regressors
We’ll build a Prophet Model with Regressors. This uses the Facebook Prophet forecasting algorithm and supplies all of the 72 features as regressors to the model. Note  Because this is a Modeltime Model we need to have a Date Feature in the recipe.
SubModel Evaluation
Let’s take a look at our progress so far. We have 5 models. We’ll put them into a Modeltime Table to organize them using modeltime_table()
.
We can get the accuracy on the holdout set using modeltime_accuracy()
and table_modeltime_accuracy()
. The best model is the Prophet with Regressors with a MAE of 1031.
Accuracy Table  

.model_id  .model_desc  .type  mae  mape  mase  smape  rmse  rsq 
1  ARIMA(0,0,1)(0,1,0)[52]  Test  1359.99  6.77  1.02  6.93  1721.47  0.95 
2  GLMNET  Test  1222.38  6.47  0.91  6.73  1349.88  0.98 
3  XGBOOST  Test  1089.56  5.22  0.82  5.20  1266.62  0.96 
4  NNAR(4,1,10)[52]  Test  2529.92  11.68  1.89  10.73  3507.55  0.93 
5  PROPHET W/ REGRESSORS  Test  1031.53  5.13  0.77  5.22  1226.80  0.98 
And, we can visualize the forecasts with modeltime_forecast()
and plot_modeltime_forecast()
.
Build Modeltime Ensembles
This is exciting.
We’ll make Average, Median, and Weighted Ensembles. If you are interested in making Super Learners (MetaLearner Models that leverage submodel predictions), I teach this in my new HighPerformance Time Series course.
I’ve made it super simple to build an ensemble from a Modeltime Tables. Here’s how to use ensemble_average()
.
 Start with your Modeltime Table of SubModels
 Pipe into
ensemble_average(type = "mean")
You now have a fitted average ensemble.
We can make median and weighted ensembles just as easily. Note  For the weighted ensemble I’m loading the better performing models higher.
Ensemble Evaluation
Let’s see how we did
We need to have Modeltime Tables that organize our ensembles before we can assess performance. Just use modeltime_table()
to organize ensembles just like we did for the SubModels.
Let’s check out the Accuracy Table using modeltime_accuracy()
and table_modeltime_accuracy()
.
 From MAE, Ensemble Model ID 1 has 1000 MAE, a 3% improvement over our best submodel (MAE 1031).
 From RMSE, Ensemble Model ID 3 has 1228, which is on par with our best submodel.
Accuracy Table  

.model_id  .model_desc  .type  mae  mape  mase  smape  rmse  rsq 
1  ENSEMBLE (MEAN): 5 MODELS  Test  1000.01  4.63  0.75  4.58  1408.68  0.97 
2  ENSEMBLE (MEDIAN): 5 MODELS  Test  1146.60  5.68  0.86  5.77  1310.30  0.98 
3  ENSEMBLE (WEIGHTED): 5 MODELS  Test  1056.59  5.15  0.79  5.20  1228.45  0.98 
And finally we can visualize the performance of the ensembles.
It gets better
You’ve just scratched the surface, here’s what’s coming…
The modeltime.ensemble
package functionality is much more featurerich than what we’ve covered here (I couldn’t possibly cover everything in this post). 😀
Here’s what I didn’t cover:

Scalable Forecasting with Ensembles: What happens when your data has more than one time series. This is called scalable forecasting, and we need to use special techniques to ensemble these models.

Stacked SuperLearners: We can make use resample predictions from our submodels as inputs to a metalearner. This can result is significantly better accuracy (5% improvement is what we achieve in my Time Series Course).

MultiLevel Stacking: This is the strategy that won the Grupo Bimbo Inventory Demand Forecasting Challenge where multiple layers of ensembles are used.

Refitting SubModels and MetaLearners: Refitting is special task that is needed prior to forecasting future data. Refitting requires careful attention to control the submodel and metalearner retraining process.
So how are you ever going to learn time series analysis and forecasting?
You’re probably thinking:
 There’s so much to learn
 My time is precious
 I’ll never learn time series
I have good news that will put those doubts behind you.
You can learn time series analysis and forecasting in hours with my stateoftheart time series forecasting course. 👇
HighPerformance Time Series Course
Become the times series expert in your organization.
My HighPerformance Time Series Forecasting in R course is available now. You’ll learn timetk
and modeltime
plus the most powerful time series forecasting techniques available like GluonTS Deep Learning. Become the times series domain expert in your organization.
👉 HighPerformance Time Series Course.
You will learn:
 Time Series Foundations  Visualization, Preprocessing, Noise Reduction, & Anomaly Detection
 Feature Engineering using lagged variables & external regressors
 Hyperparameter Tuning  For both sequential and nonsequential models
 Time Series CrossValidation (TSCV)
 Ensembling Multiple Machine Learning & Univariate Modeling Techniques (Competition Winner)
 Deep Learning with GluonTS (Competition Winner)
 and more.
Unlock the HighPerformance Time Series Course
Project Roadmap, Future Work, and Contributing to Modeltime
Modeltime is a growing ecosystem of packages that work together for forecasting and time series analysis. Here are several useful links:

Modeltime Ecosystem Roadmap on GitHub  See the past development and future trajectory. Did we miss something? Make a suggestion.

Business Science data science blog  I announce all Modeltime Software happenings
Have questions about Modeltime Ensemble?
Make a comment in the chat below. 👇
And, if you plan on using modeltime.ensemble
for your business, it’s a nobrainer  Take my Time Series Course.