Is This Post Too Long? I’ll Email A PDF Version To You

Okay, so this is my third tutorial about time-series in python. The first one was on univariate ARIMA models, and the second one was on univariate SARIMA models. Today is different, in that we are going to introduce another variable to the model. We’ll assume that one is completely exogenous and is not affected by the ongoings of the other. In real-life I imagine that this is kind of doesn’t exist very often, but it is worth noting that this sort of thing can happen from time to time, and the model is nonetheless useful for a short-term predictions.

In this post:

  • The common pitfalls associated with running ARIMAX models.
  • Generating forecasts from these models

The Mechanics of ARIMAX

Mechanically, ARIMAX and ARIMA do not differ. In fact in StatsModels (and other software), we don’t even make a distinction between the two models. They are so similar that making a distinction is almost petty. Yet, the distinction exists, you can go look it up. So the question is why?

The answer is that by trying to combine two time-series in a regression opens you up to all kinds of new mistakes that you can make. Yeah, univariate time-series analysis has different things, like ensuring that your time-series is stationary. But multivariate time-series you start entering the weird world of causality bending. (Causality bending is my own term for what is going on here). Let’s point out the basic rules of causality.

Here are the rules:

  1. A cause can generate an effect at the same time that the cause happens. (Things can happen contemporaneously.)
  2. A cause can generate an effect that happens after the cause. (The present can affect the future.)
  3. A cause that has already happened can generate an affect in the future. (The past can affect the future)
  4. An effect cannot precede a cause. (The future does not affect the present nor the past.)
  5. Speeding weasels can not go faster than the speed of light. (If going faster than the speed of light is possible, all of these rules will cease to exist.)

These rules of causality form the basis of why ARIMAX deserves to be designated separately from ARIMA, at least in my mind. You see, if you violate any of these rules with your ARIMAX model, it automatically invalidates that model.

Let’s say that you have a variable X which causes Y with a 1 period lag. In other words, X happens, and then 1 period later Y happens because of X. For concreteness, let’s say the number of Republican Congressman elected in a year is X, and the number of tax cut bills passed by congress is Y. We’ll just assume for now that there is a pretty stable positive relationship between these variables, I don’t know if there is or not, that is for political scientists to figure out. Obviously, a Republican would need to be elected before they could influence the number of tax cuts they give out. But what if we got it wrong. What if we regressed X on the lag of Y. We literally just put the cart in front of the horse.

In mathese:

That would imply that tax cuts cause republicans to get elected. We violated rule 4 or rule 5. That just won’t do.

In general, there is no way to avoid this situation except to use your intuition. However, there does exist a test, which can help you to identify whether or not you are making this mistake. That test is a granger-causality test. I wouldn’t put too much stock into this test, mostly because it won’t identify contemporaneous causality. But hey, it would be worth a look to see if we are making an obvious flaw.

Another Issue

So the other problem is there is no way to create a stationary time-series by adding up non-stationary time-series, sort of, there is a special case which would be fun to take a look at called cointegration. We’ll build up to that. For now, if I have a stationary time-series Y, and I regress it on a non-stationary time series, the math will let you do this, you end up with a contradiction. The math is forced to do some weird stuff to make it work out. In fact, your X variable must be cointegrated with your residuals. Uh-oh! That means that Y must be a linear combination of noise and X. Things, just got heteroscadastic, serial correlated, and biased. Biased? Really? Why?

It got biased because in order for X and the residuals to be cointegrated the residuals have to be trending, which means that they can not have an expected value of zero. Therefore, the standard proofs that OLS is not biased don’t work, because they depend on the residuals having a mean of zero. So we have to make sure that our X is also stationary.

Enough Talk, Let’s See Some Code

Alright, you want some code! Let’s start with a dataset that you can download. Here is a dataset that you can play with: salesdata2.

Run this code and you will see that we have 3 variables, month, marketing, and sales:

import pandas as pd
import matplotlib.pyplot as plt

We don’t really care about the month variable. So let’s see what these variables look like as time series. We’ll use the following commands to visually inspect these variables.


And when you do that you should see this graph pop-up:

With this you can clearly tell that both time-series are trending which is a fairly clear sign that both series have unit roots. We can check whether or not they have unit roots by using the augmented Dickey Fuller (ADF) test. Also, notice that Sales is more volatile than Marketing. Treating this will be a subject of a future post.

import statsmodels.api as sm

This produces the following output:

(-0.11261902882013171, 0.9481670336582011, 0, 74, {'5%': -2.9014701097664504, '1%': -3.5219803175527606, '10%': -2.58807215485756}, 601.76510405077318)
(-0.40318177272648931, 0.90956617826759134, 7, 67, {'5%': -2.9057551285231229, '1%': -3.5319549603840894, '10%': -2.5903569458676765}, 1136.2388212520589)

Clearly, we can not reject the null-hypothesis that these series have a unit root. So we should difference both series as a first step.

But let’s just run a naive regression to see what happens on the undifferenced time-series, and then again on the differenced time-series, here’s the code for the first regression.


Which gives you the following output:

                            OLS Regression Results                            
Dep. Variable:                  Sales   R-squared:                       0.998
Model:                            OLS   Adj. R-squared:                  0.998
Method:                 Least Squares   F-statistic:                 3.943e+04
Date:                Tue, 27 Jun 2017   Prob (F-statistic):          1.59e-101
Time:                        22:18:35   Log-Likelihood:                -479.13
No. Observations:                  75   AIC:                             962.3
Df Residuals:                      73   BIC:                             966.9
Df Model:                           1                                         
Covariance Type:            nonrobust                                         
                 coef    std err          t      P>|t|      [0.025      0.975]
Marketing      1.0348      0.005    198.581      0.000       1.024       1.045
const       -498.4924     34.123    -14.609      0.000    -566.500    -430.485
Omnibus:                       27.350   Durbin-Watson:                   0.131
Prob(Omnibus):                  0.000   Jarque-Bera (JB):               62.288
Skew:                           1.203   Prob(JB):                     2.98e-14
Kurtosis:                       6.761   Cond. No.                     1.33e+04

[1] Standard Errors assume that the covariance matrix of the errors is correctly specified.
[2] The condition number is large, 1.33e+04. This might indicate that there are
strong multicollinearity or other numerical problems.

And here is the code for a differenced time-series regression.


The output for this regression looks like this:

                            OLS Regression Results                            
Dep. Variable:                  diffS   R-squared:                       0.016
Model:                            OLS   Adj. R-squared:                  0.003
Method:                 Least Squares   F-statistic:                     1.196
Date:                Tue, 27 Jun 2017   Prob (F-statistic):              0.278
Time:                        22:18:35   Log-Likelihood:                -374.58
No. Observations:                  74   AIC:                             753.2
Df Residuals:                      72   BIC:                             757.8
Df Model:                           1                                         
Covariance Type:            nonrobust                                         
                 coef    std err          t      P>|t|      [0.025      0.975]
diffM         -0.1686      0.154     -1.094      0.278      -0.476       0.139
const        174.5690     23.685      7.370      0.000     127.354     221.784
Omnibus:                        4.654   Durbin-Watson:                   1.182
Prob(Omnibus):                  0.098   Jarque-Bera (JB):                3.841
Skew:                          -0.520   Prob(JB):                        0.147
Kurtosis:                       3.405   Cond. No.                         808.

[1] Standard Errors assume that the covariance matrix of the errors is correctly specified.

Clearly, there is a difference between these two models. One is just plain wrong. Well, let’s think about this logically for a moment. We get a better fit with the first regression, but when we think about what is going on here, we can remember that both time series are trending. There is a third variable in the mix. Essentially, time is correlated to both my input and output. What happens is that we get a very significant, and wrong, estimate because our coefficient is the ratio of the trends, not the effect that X has on Y. That’s why we get the multicollinearity warning too. Uh-oh, that must mean that the first is wrong, and the second is right. But there isn’t anything significant in the second, we can’t say anything.

Well, what if we didn’t difference marketing, but we did difference sales? Well, that leads to a consistency problem, we have a series without the unit-root regressed on a series with a unit-root, and that causes the problems with error terms that have to have a trend.

Okay, so at this point, we can start looking for the correct ARIMA model using ACF and PACF plots. I’m not going to do that since I covered that at length in my first tutorial. Let’s turn our attention to something else. This issue of causality. How is it that I know that Marketing is driving sales and not vice-versa.

That’s what a granger-causality test is for. The test is whether the first variable is caused by the second variable. Here’s the code:


And the results:

Granger Causality
('number of lags (no zero)', 1)
ssr based F test:         F=0.5684  , p=0.4534  , df_denom=71, df_num=1
ssr based chi2 test:   chi2=0.5924  , p=0.4415  , df=1
likelihood ratio test: chi2=0.5900  , p=0.4424  , df=1
parameter F test:         F=0.5684  , p=0.4534  , df_denom=71, df_num=1
{1: ({'lrtest': (0.59002558961230989, 0.44240922354434226, 1), 'params_ftest': (0.56836851380441789, 0.45340099095869346, 71.0, 1), 'ssr_ftest': (0.56836851383934839, 0.45340099094486797, 71.0, 1), 'ssr_chi2test': (0.59238408484664473, 0.44149868589798152, 1)}, [, , array([[ 0.,  1.,  0.]])])}

You can also see by reversing the test that Sales does not cause Marketing:


And the results:

Granger Causality
('number of lags (no zero)', 1)
ssr based F test:         F=0.5684  , p=0.4534  , df_denom=71, df_num=1
ssr based chi2 test:   chi2=0.5924  , p=0.4415  , df=1
likelihood ratio test: chi2=0.5900  , p=0.4424  , df=1
parameter F test:         F=0.5684  , p=0.4534  , df_denom=71, df_num=1
{1: ({'lrtest': (0.59002558961230989, 0.44240922354434226, 1), 'params_ftest': (0.56836851380441789, 0.45340099095869346, 71.0, 1), 'ssr_ftest': (0.56836851383934839, 0.45340099094486797, 71.0, 1), 'ssr_chi2test': (0.59238408484664473, 0.44149868589798152, 1)}, [, , array([[ 0.,  1.,  0.]])])}

Finally, here is the full blown code for the correct ARIMAX model. I know this is the “correct” model because I generated the data. But there is more to talk about with this dataset than meets the eye. The biggest problem comes from the fact that I am using non-normal errors, which is throwing things off a bit.


And the results

                             ARIMA Model Results                              
Dep. Variable:                D.Sales   No. Observations:                   71
Model:                 ARIMA(1, 1, 0)   Log Likelihood                -345.588
Method:                       css-mle   S.D. of innovations             31.448
Date:                Tue, 27 Jun 2017   AIC                            699.176
Time:                        08:00:20   BIC                            708.226
Sample:                    05-01-2012   HQIC                           702.775
                         - 03-01-2018                                         
                    coef    std err          z      P>|z|      [0.025      0.975]
const           111.6228     19.506      5.723      0.000      73.393     149.853
lag               0.2771      0.126      2.194      0.032       0.030       0.525
ar.L1.D.Sales     0.1457      0.124      1.178      0.243      -0.097       0.388
                 Real           Imaginary           Modulus         Frequency
AR.1            6.8622           +0.0000j            6.8622            0.0000

So that’s it. The basic take aways are that when introducing another variable into your time-series, you need to make sure that the time-series is consistent, in that the variables are integrated to the same order, and that the causal structure of your model makes sense not just intuitively, but statistically as well.

23 thoughts on “Analyzing Multivariate Time-Series using ARIMAX in Python with StatsModels

  1. Tony says:


    Thanks for sharing your knowledge !

    I noticed an error in your code though, and I really don’t know what you wanted to do, even if the code seems pretty clear to me.


    This line fails for me. I guess you wanted to created a new dataset, but is there something missing ?

    Best regards

    1. Ryan Barnes says:

      Hey Tony,
      Thanks for catching that. I updated the code in the article. It was supposed to be:


      Again thanks for pointing this out for me.

  2. Luis says:

    One important will be how to deal with exogenous variables when you have quite a lot candidates?
    Secondly, how one can be sure that there is not overfitting when including more than 2/3 exogenous variables in the model.
    I have read about lasso regression, but not sure how to applied to an ARIMAX model.

    Let´s say you have around 50 observations and end up with model with 8 variables (+ dependant Y). How will you evaluate that there is not overfitting on that model.

    1. Ryan Barnes says:

      Lasso regression would work in this case, typically statsmodels does not have an implementation though. You would have to build your own maximum likelihood estimator and then tack the regularization term on the end of the likelihood function. Unfortunately, that is very much a custom build, but it can be done, which is beyond the scope of what I was trying to do in this blog post.

  3. Raj Thilak says:

    This article saved my life. I’ve been trying to find something to explain implementation of multivariate time series regression in ARIMA. If we use the ARIMAX model with a test dataset to make out of sample predictions, does it work alright or is there anything we need to watch out for?
    Also, just a small correction, the grangercausality results that you show are both identical. It would be helpful to see the second result so that we can appreciate the difference. Thanks a lot.

    1. Ryan Barnes says:


      I’m so glad you found this tutorial useful!

      The model should work just fine with out of sample data. The trick is to make sure that your autocorrelation is accurate. I believe the predict method on your statsmodel arima class implements this correctly (it’s been been awhile since I read the documentation though).

      As for the granger causality test, I’m sure I just copied and pasted the wrong set. Thanks for the heads up.

  4. serdar says:

    I am new about python and data science and i am looking for releated python documents with statistics and time series model like arima ,ma,…
    I will be very happy if you would help me about where i can find that documents

    1. Ryan Barnes says:


      It’s hard for me to point you in the direction of solid resources at your level without knowing your level personally. That being said the statsmodels documentation is generally a pretty good starting point They have an entire section on time series models: Also, if you want some personalized one on one training you can give me a call at (801) 815-2922 or email me at I’d be happy to help.

  5. Muddassir says:

    Completely irrelevant!!!!Can u please post about how to do multivariate time series forecasting

    1. Ryan Barnes says:

      Muddassir, I’m sorry that you didn’t find this post helpful. You can use this model to forecast, you just assume (with this model) that the variables are not endogenous, i.e. you have exogenous variables to regress with. I believe that the title of the post mentions that I’d be using ARIMAX, so I definitely didn’t mean to mislead you. My guess is that you are looking for a model like VAR, VECM where the variables are completely endogenous with each other, right? I’ll look into writing up a post about that, thanks for the suggestion.

      1. Muddassir says:

        Thanks for quick reply…i have 4 years of data 2007,2008,2009,2010 data with 10 predictor variables and 1 target variable .
        Target variable is continous.
        I have to forecast the target variable for 2011
        Note: predictor variables are not given for 2011 data .
        Please suggest me the appropriate model to apply

  6. Bill says:

    The two Granger Causality tests are stille both identical and as such, I have no idea of what to look for — can you post the correct test results?

    1. Doctor Tex says:

      This is without diff()

      print(sm.tsa.stattools.grangercausalitytests(df[[‘Sales’,’Marketing’]], maxlag=1, verbose=True))

      Granger Causality
      number of lags (no zero) 1
      ssr based F test: F=33.4561 , p=0.0000 , df_denom=71, df_num=1
      ssr based chi2 test: chi2=34.8698 , p=0.0000 , df=1
      likelihood ratio test: chi2=28.5705 , p=0.0000 , df=1
      parameter F test: F=33.4561 , p=0.0000 , df_denom=71, df_num=1
      {1: ({‘ssr_ftest’: (33.456140995943535, 1.810036714936035e-07, 71.0, 1), ‘ssr_chi2test’: (34.869780756335516, 3.525098908631768e-09, 1), ‘lrtest’: (28.570467812774496, 9.034970552654862e-08, 1), ‘params_ftest’: (33.45614099594401, 1.8100367149357443e-07, 71.0, 1.0)}

      print(sm.tsa.stattools.grangercausalitytests(df[[‘Marketing’, ‘Sales’]], maxlag=1, verbose=True))

      Granger Causality
      number of lags (no zero) 1
      ssr based F test: F=0.3057 , p=0.5821 , df_denom=71, df_num=1
      ssr based chi2 test: chi2=0.3186 , p=0.5724 , df=1
      likelihood ratio test: chi2=0.3179 , p=0.5729 , df=1
      parameter F test: F=0.3057 , p=0.5821 , df_denom=71, df_num=1
      {1: ({‘ssr_ftest’: (0.3056924545283709, 0.5820722496888391, 71.0, 1), ‘ssr_chi2test’: (0.31860903711407673, 0.5724447641509418, 1), ‘lrtest’: (0.3179251095340305, 0.5728572543074806, 1), ‘params_ftest’: (0.30569245452808014, 0.5820722496890105, 71.0, 1.0)}

  7. Maya says:

    Noob question: How do you read the results of the Granger causality test? The results look identical for both cases in your code

  8. John Perez says:

    Can you suggest me a model and a way to plot temperature with number of chickens born through time? I tried to apply this model but the temperature is far away from number of chickens in the plot. Not like sales and marketing that those have similar values. Thanks a lot 🙂

    1. Ryan Barnes says:

      Hey John,

      I think that what you need to do is set up a secondary axis on your plot, so that you can see how they trend together. Other than that, you can of course rescale your data. That would preserve the overall structure but get them into similar scales. Try minmax scaling on both of your variables. This is probably the simplest solution that I can think of to your particular problem.

  9. Valentyna Sinichenko says:

    If I am not mistaken, you should run Granger causality test only for stationary data. In your case, for first-differenced data.

    1. Ryan Barnes says:

      You are right, you should check for stationarity first.

      1. Doctor Tex says:

        From wikipedia,If a time series is a stationary process, the test is performed using the level values of two (or more) variables. If the variables are non-stationary, then the test is done using first (or higher) differences. However, I couldn’t confirm this looking at the source code

  10. Allen Hu says:


    should be replaced by:


  11. Doctor Tex says:

    I am not able to put/upload an image of sales versus fitted values of your ARIMA model and I suspect they don’t match at all.

    Following is the summary of your ARIMA model that I copy pasted and tried in statsmodel 0.10.0

    Dep. Variable: D.Sales No. Observations: 72
    Model: ARIMA(1, 1, 0) Log Likelihood -647.768
    Method: css-mle S.D. of innovations 1951.172
    Date: Fri, 12 Jul 2019 AIC 1303.535
    Time: 02:07:47 BIC 1312.642
    Sample: 1 HQIC 1307.161

    coef std err z P>|z| [0.025 0.975]
    const 454.3043 266.811 1.703 0.093 -68.636 977.245
    lag -2.9454 1.977 -1.490 0.141 -6.821 0.930
    ar.L1.D.Sales -0.4596 0.113 -4.063 0.000 -0.681 -0.238
    Real Imaginary Modulus Frequency
    AR.1 -2.1758 +0.0000j 2.1758 0.5000

Leave a Reply

Your email address will not be published. Required fields are marked *