The default ARIMA(p,D,q) model in Econometrics Toolbox™ is the nonseasonal model of the form
$${\Delta}^{D}{y}_{t}=c+{\varphi}_{1}{\Delta}^{D}{y}_{t1}+\dots +{\varphi}_{p}{\Delta}^{D}{y}_{tp}+{\theta}_{1}{\epsilon}_{t1}+\dots +{\theta}_{q}{\epsilon}_{tq}+{\epsilon}_{t}.$$
You can write this equation in condensed form using lag operator notation:
$$\varphi (L){(1L)}^{D}{y}_{t}=c+\theta (L){\epsilon}_{t}$$
In either equation, the default innovation distribution is Gaussian with mean zero and constant variance.
At the command line, you can specify a model of this form using the shorthand syntax arima(p,D,q)
. For the input arguments p
, D
, and q
, enter the number of nonseasonal AR terms (p), the order of nonseasonal integration (D), and the number of nonseasonal MA terms (q), respectively.
When you use this shorthand syntax, arima
creates an arima
model with these default property values.
Property Name  Property Data Type 

AR  Cell vector of NaN s 
Beta  Empty vector [] of regression coefficients corresponding to exogenous covariates 
Constant  NaN 
D  Degree of nonseasonal integration, D 
Distribution  "Gaussian" 
MA  Cell vector of NaN s 
P  Number of AR terms plus degree of integration, p + D 
Q  Number of MA terms, q 
SAR  Cell vector of NaN s 
SMA  Cell vector of NaN s 
Variance  NaN 
To assign nondefault values to any properties, you can modify the created model object using dot notation.
Notice that the inputs D
and q
are the values arima
assigns to properties D
and Q
. However, the input argument p
is not necessarily the value arima
assigns to the model property P
. P
stores the number of presample observations needed to initialize the AR component of the model. For nonseasonal models, the required number of presample observations is p + D.
To illustrate, consider specifying the ARIMA(2,1,1) model
$$(1{\varphi}_{1}L{\varphi}_{2}{L}^{2}){(1L)}^{1}{y}_{t}=c+(1+{\theta}_{1}L){\epsilon}_{t},$$
where the innovation process is Gaussian with (unknown) constant variance.
Mdl = arima(2,1,1)
Mdl = arima with properties: Description: "ARIMA(2,1,1) Model (Gaussian Distribution)" Distribution: Name = "Gaussian" P: 3 D: 1 Q: 1 Constant: NaN AR: {NaN NaN} at lags [1 2] SAR: {} MA: {NaN} at lag [1] SMA: {} Seasonality: 0 Beta: [1×0] Variance: NaN
Notice that the model property P
does not have value 2 (the AR degree). With the integration, a total of p + D (here, 2 + 1 = 3) presample observations are needed to initialize the AR component of the model.
The created model, Mdl
, has NaN
s for all parameters. A NaN
value signals that a parameter needs to be estimated or otherwise specified by the user. All parameters must be specified to forecast or simulate the model.
To estimate parameters, input the model object (along with data) to estimate
. This returns a new fitted arima
model object. The fitted model object has parameter estimates for each input NaN
value.
Calling arima
without any input arguments returns an ARIMA(0,0,0) model specification with default property values:
DefaultMdl = arima
DefaultMdl = arima with properties: Description: "ARIMA(0,0,0) Model (Gaussian Distribution)" Distribution: Name = "Gaussian" P: 0 D: 0 Q: 0 Constant: NaN AR: {} SAR: {} MA: {} SMA: {} Seasonality: 0 Beta: [1×0] Variance: NaN
The best way to specify models to arima
is using namevalue pair arguments. You do not need, nor are you able, to specify a value for every model object property. arima
assigns default values to any properties you do not (or cannot) specify.
In condensed, lag operator notation, nonseasonal ARIMA(p,D,q) models are of the form
$$\varphi (L){(1L)}^{D}{y}_{t}=c+\theta (L){\epsilon}_{t}.$$  (1) 
You can extend this model to an ARIMAX(p,D,q) model with the linear inclusion of exogenous variables. This model has the form
$$\varphi (L){y}_{t}={c}^{\ast}+{x}_{t}^{\prime}\beta +{\theta}^{\ast}(L){\epsilon}_{t},$$  (2) 
Tip
If you specify a nonzero D
, then Econometrics Toolbox differences the response series y_{t}
before the predictors enter the model. You should preprocess the exogenous covariates x_{t} by testing for stationarity and differencing if any are unit root nonstationary. If any nonstationary exogenous covariate enters the model, then the false negative rate for significance tests of β can increase.
For the distribution of the innovations, ε_{t}, there are two choices:
Independent and identically distributed (iid) Gaussian or Student’s t with a constant variance, $${\sigma}_{\epsilon}^{2}$$.
Dependent Gaussian or Student’s t with a conditional variance process, $${\sigma}_{t}^{2}$$. Specify the conditional variance model using a garch
, egarch
, or gjr
model.
The arima
default for the innovations is an iid Gaussian process with constant (scalar) variance.
In order to estimate, forecast, or simulate a model, you must specify the parametric form of the model (e.g., which lags correspond to nonzero coefficients, the innovation distribution) and any known parameter values. You can set any unknown parameters equal to NaN
, and then input the model to estimate
(along with data) to get estimated parameter values.
arima
(and estimate
) returns a model corresponding to the model specification. You can modify models to change or update the specification. Input models (with no NaN
values) to forecast
or simulate
for forecasting and simulation, respectively. Here are some example specifications using namevalue arguments.
Model  Specification 

 arima('AR',NaN) or arima(1,0,0) 
 arima('Constant',0,'MA',{NaN,NaN},... 
 arima('Constant',0.2,'AR',0.8,'MA',0.6,'D',1,... 
 arima('Constant',0,'AR',0.5,'D',1,'Beta',[5 2]) 
You can specify the following namevalue arguments to create nonseasonal arima
models.
NameValue Arguments for Nonseasonal ARIMA Models
Name  Corresponding Model Term(s) in Equation 1  When to Specify 

AR  Nonseasonal AR coefficients, $${\varphi}_{1},\dots ,{\varphi}_{p}$$  To set equality constraints for the AR coefficients. For example, to specify the AR coefficients in the model $${y}_{t}=0.8{y}_{t1}0.2{y}_{t2}+{\epsilon}_{t},$$ specify You only need to specify the nonzero elements of Any coefficients you specify must correspond to a stable AR operator polynomial. 
ARLags  Lags corresponding to nonzero, nonseasonal AR coefficients 
Use this argument as a shortcut for specifying Use 
Beta  Values of the coefficients of the exogenous covariates  Use this argument to specify the values of the coefficients of the exogenous variables. For example, use By default, 
Constant  Constant term, c  To set equality constraints for c. For example, for a model with no constant term, specify 'Constant',0 .By default, Constant has value NaN . 
D  Degree of nonseasonal differencing, D  To specify a degree of nonseasonal differencing greater than zero. For example, to specify one degree of differencing, specify 'D',1 .By default, D has value 0 (meaning no nonseasonal integration). 
Distribution  Distribution of the innovation process  Use this argument to specify a Student’s t innovation distribution. By default, the innovation distribution is Gaussian. For example, to specify a t distribution with unknown degrees of freedom, specify 'Distribution','t' .To specify a t innovation distribution with known degrees of freedom, assign Distribution a data structure with fields Name and DoF . For example, for a t distribution with nine degrees of freedom, specify 'Distribution',struct('Name','t','DoF',9) . 
MA  Nonseasonal MA coefficients, $${\theta}_{1},\dots ,{\theta}_{q}$$  To set equality constraints for the MA coefficients. For example, to specify the MA coefficients in the model $${y}_{t}={\epsilon}_{t}+0.5{\epsilon}_{t1}+0.2{\epsilon}_{t2},$$ specify You only need to specify the nonzero elements of Any coefficients you specify must correspond to an invertible MA polynomial. 
MALags  Lags corresponding to nonzero, nonseasonal MA coefficients 
Use this argument as a shortcut for specifying $${y}_{t}={\epsilon}_{t}+{\theta}_{1}{\epsilon}_{t1}+{\theta}_{4}{\epsilon}_{t4},$$ specify Use 
Variance 


Note
You cannot assign values to the properties P
and Q
. For nonseasonal models,
arima
sets P
equal to p + D
arima
sets Q
equal to q
For a time series with periodicity s, define the degree p_{s} seasonal AR operator polynomial, $$\Phi (L)=(1{\Phi}_{1}{L}^{{p}_{1}}\dots {\Phi}_{{p}_{s}}{L}^{{p}_{s}})$$, and the degree q_{s} seasonal MA operator polynomial, $$\Theta (L)=(1+{\Theta}_{1}{L}^{{q}_{1}}+\dots +{\Theta}_{{q}_{s}}{L}^{{q}_{s}})$$. Similarly, define the degree p nonseasonal AR operator polynomial, $$\varphi (L)=(1{\varphi}_{1}L\dots {\varphi}_{p}{L}^{p})$$, and the degree q nonseasonal MA operator polynomial,
$$\theta (L)=(1+{\theta}_{1}L+\dots +{\theta}_{q}{L}^{q}).$$  (3) 
A multiplicative ARIMA model with degree D nonseasonal integration and degree s seasonality is given by
$$\varphi (L)\Phi (L){(1L)}^{D}(1{L}^{s}){y}_{t}=c+\theta (L)\Theta (L){\epsilon}_{t}.$$  (4) 
arima
default for the innovation distribution is an iid Gaussian process with constant (scalar) variance.In addition to the arguments for specifying nonseasonal models (described in NameValue Arguments for Nonseasonal ARIMA Models), you can specify these namevalue arguments to create a multiplicative arima
model. You can extend an ARIMAX model similarly to include seasonal effects.
NameValue Arguments for Seasonal ARIMA Models
Argument  Corresponding Model Term(s) in Equation 4  When to Specify 

SAR  Seasonal AR coefficients, $${\Phi}_{1},\dots ,{\Phi}_{{p}_{s}}$$  To set equality constraints for the seasonal AR coefficients. When specifying AR coefficients, use the sign opposite to what appears in Equation 4 (that is, use the sign of the coefficient as it would appear on the right side of the equation). Use For example, to specify the model $$(10.8L)(10.2{L}^{12}){y}_{t}={\epsilon}_{t},$$ specify Any coefficient values you enter must correspond to a stable seasonal AR polynomial. 
SARLags  Lags corresponding to nonzero seasonal AR coefficients, in the periodicity of the observed series 
Use this argument when specifying For example, to specify the model $$(1\varphi L)(1{\Phi}_{12}{L}^{12}){y}_{t}={\epsilon}_{t},$$ specify 
SMA  Seasonal MA coefficients, $${\Theta}_{1},\dots ,{\Theta}_{{q}_{s}}$$  To set equality constraints for the seasonal MA coefficients. Use For example, to specify the model $${y}_{t}=(1+0.6L)(1+0.2{L}^{12}){\epsilon}_{t},$$ specify Any coefficient values you enter must correspond to an invertible seasonal MA polynomial. 
SMALags  Lags corresponding to the nonzero seasonal MA coefficients, in the periodicity of the observed series 
Use this argument when specifying For example, to specify the model $${y}_{t}=(1+{\theta}_{1}L)(1+{\Theta}_{4}{L}^{4}){\epsilon}_{t},$$ specify 
Seasonality  Seasonal periodicity, s  To specify the degree of seasonal integration s in the seasonal differencing polynomial Δ_{s} = 1 – L^{s}. For example, to specify the periodicity for seasonal integration of monthly data, specify 'Seasonality',12 .If you specify nonzero Seasonality , then the degree of the whole seasonal differencing polynomial is one. By default, Seasonality has value 0 (meaning periodicity and no seasonal integration). 
Note
You cannot assign values to the properties P
and Q
. For multiplicative ARIMA models,
arima
sets P
equal to p + D + p_{s} + s
arima
sets Q
equal to q + q_{s}
You can specify the lag structure and innovation distribution of seasonal and nonseasonal conditional mean models using the Econometric Modeler app. The app treats all coefficients as unknown and estimable, including the degrees of freedom parameter for a t innovation distribution.
At the command line, open the Econometric Modeler app.
econometricModeler
Alternatively, open the app from the apps gallery (see Econometric Modeler).
In the app, you can see all supported models by selecting a time series variable for the response in the Time Series pane. Then, on the Econometric Modeler tab, in the Models section, click the arrow to display the models gallery.
The ARMA/ARIMA Models section contains supported conditional mean models.
For conditional mean model estimation, SARIMA and SARIMAX are the most flexible models. You can create any conditional mean model that excludes exogenous predictors by clicking SARIMA, or you can create any conditional mean model that includes at least one exogenous predictor by clicking SARIMAX.
After you select a model, the app displays the Type
Model
Parameters dialog box, where Type
is the model
type. This figure shows the SARIMAX Model Parameters dialog box.
Adjustable parameters in the dialog box depend on Type
. In general, adjustable parameters include:
A model constant and linear regression coefficients corresponding to predictor variables
Time series component parameters, which include seasonal and nonseasonal lags and degrees of integration
The innovation distribution
As you adjust parameter values, the equation in the Model Equation section changes to match your specifications. Adjustable parameters correspond to input and namevalue pair arguments described in the previous sections and in the arima
reference page.
For more details on specifying models using the app, see Fitting Models to Data and Specifying Lag Operator Polynomials Interactively.