Note: This page has been translated by MathWorks. Click here to see

To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

This example shows how to use the shorthand `arima(p,D,q)`

syntax to specify the default MA

$${y}_{t}=c+{\epsilon}_{t}+{\theta}_{1}{\epsilon}_{t-1}+\dots +{\theta}_{q}{\epsilon}_{t-q}.$$

By default, all parameters in the created model object have unknown values, and the innovation distribution is Gaussian with constant variance.

Specify the default MA(3) model:

model = arima(0,0,3)

model = arima with properties: Description: "ARIMA(0,0,3) Model (Gaussian Distribution)" Distribution: Name = "Gaussian" P: 0 D: 0 Q: 3 Constant: NaN AR: {} SAR: {} MA: {NaN NaN NaN} at lags [1 2 3] SMA: {} Seasonality: 0 Beta: [1×0] Variance: NaN

The output shows that the created model object, `model`

, has `NaN`

values for all model parameters: the constant term, the MA coefficients, and the variance. You can modify the created model object using dot notation, or input it (along with data) to `estimate`

.

This example shows how to specify an MA(*q*) model with constant term equal to zero. Use name-value syntax to specify a model that differs from the default model.

Specify an MA(2) model with no constant term,

$${y}_{t}={\epsilon}_{t}+{\theta}_{1}{\epsilon}_{t-1}+{\theta}_{2}{\epsilon}_{t-2},$$

where the innovation distribution is Gaussian with constant variance.

model = arima('MALags',1:2,'Constant',0)

model = arima with properties: Description: "ARIMA(0,0,2) Model (Gaussian Distribution)" Distribution: Name = "Gaussian" P: 0 D: 0 Q: 2 Constant: 0 AR: {} SAR: {} MA: {NaN NaN} at lags [1 2] SMA: {} Seasonality: 0 Beta: [1×0] Variance: NaN

The `MALags`

name-value argument specifies the lags corresponding to nonzero MA coefficients. The property `Constant`

in the created model object is equal to `0`

, as specified. The model object has default values for all other properties, including `NaN`

values as placeholders for the unknown parameters: the MA coefficients and scalar variance.

You can modify the created model variable, or input it (along with data) to `estimate`

.

This example shows how to specify an MA(*q*) model with nonzero coefficients at nonconsecutive lags.

Specify an MA(4) model with nonzero MA coefficients at lags 1 and 4 (an no constant term),

$${y}_{t}={\epsilon}_{t}+{\theta}_{1}{\epsilon}_{t-1}+{\theta}_{12}{\epsilon}_{t-12},$$

where the innovation distribution is Gaussian with constant variance.

model = arima('MALags',[1,4],'Constant',0)

model = arima with properties: Description: "ARIMA(0,0,4) Model (Gaussian Distribution)" Distribution: Name = "Gaussian" P: 0 D: 0 Q: 4 Constant: 0 AR: {} SAR: {} MA: {NaN NaN} at lags [1 4] SMA: {} Seasonality: 0 Beta: [1×0] Variance: NaN

The output shows the nonzero AR coefficients at lags 1 and 4, as specified. The property `Q`

is equal to `4`

, the number of presample innovations needed to initialize the MA model. The unconstrained parameters are equal to `NaN`

.

Display the value of `MA`

:

model.MA

`ans = `*1x4 cell array*
{[NaN]} {[0]} {[0]} {[NaN]}

The `MA`

cell array returns four elements. The first and last elements (corresponding to lags 1 and 4) have value `NaN`

, indicating these coefficients are nonzero and need to be estimated or otherwise specified by the user. `arima`

sets the coefficients at interim lags equal to zero to maintain consistency with MATLAB® cell array indexing.

This example shows how to specify an MA(*q*) model with known parameter values. You can use such a fully specified model as an input to `simulate`

or `forecast`

.

Specify the MA(4) model

$${y}_{t}=0.1+{\epsilon}_{t}+0.7{\epsilon}_{t-1}+0.2{\epsilon}_{t-4},$$

where the innovation distribution is Gaussian with constant variance 0.15.

model = arima('Constant',0.1,'MA',{0.7,0.2},... 'MALags',[1,4],'Variance',0.15)

model = arima with properties: Description: "ARIMA(0,0,4) Model (Gaussian Distribution)" Distribution: Name = "Gaussian" P: 0 D: 0 Q: 4 Constant: 0.1 AR: {} SAR: {} MA: {0.7 0.2} at lags [1 4] SMA: {} Seasonality: 0 Beta: [1×0] Variance: 0.15

Because all parameter values are specified, the created model object has no `NaN`

values. The functions `simulate`

and `forecast`

don't accept input models with `NaN`

values.

This example shows how to specify an MA(*q*) model with a Student's *t* innovation distribution.

Specify an MA(2) model with no constant term,

$${y}_{t}={\epsilon}_{t}+{\theta}_{1}{\epsilon}_{t-1}+{\theta}_{2}{\epsilon}_{t-2},$$

where the innovation process follows a Student's *t* distribution with eight degrees of freedom.

tdist = struct('Name','t','DoF',8); model = arima('Constant',0,'MALags',1:2,'Distribution',tdist)

model = arima with properties: Description: "ARIMA(0,0,2) Model (t Distribution)" Distribution: Name = "t", DoF = 8 P: 0 D: 0 Q: 2 Constant: 0 AR: {} SAR: {} MA: {NaN NaN} at lags [1 2] SMA: {} Seasonality: 0 Beta: [1×0] Variance: NaN

The value of `Distribution`

is a `struct`

array with field `Name`

equal to `'t'`

and field `DoF`

equal to `8`

. When you specify the degrees of freedom, they aren't estimated if you input the model to `estimate`

.

In the **Econometric
Modeler** app, you can specify the lag structure, presence of a constant,
and innovation distribution of an MA(*q*) model by following these
steps. All specified coefficients are unknown but estimable parameters.

At the command line, open the

**Econometric Modeler**app.econometricModeler

Alternatively, open the app from the apps gallery (see

**Econometric Modeler**).In the

**Data Browser**, select the response time series to which the model will be fit.On the

**Econometric Modeler**tab, in the**Models**section, click**MA**.The

**MA Model Parameters**dialog box appears.Specify the lag structure. To specify an MA(

*q*) model that includes all MA lags from 1 through*q*, use the**Lag Order**tab. For the flexibility to specify the inclusion of particular lags, use the**Lag Vector**tab. For more details, see Specifying Lag Operator Polynomials Interactively. Regardless of the tab you use, you can verify the model form by inspecting the equation in the**Model Equation**section.

For example:

To specify an MA(3) model that includes a constant, includes the first lag, and has a Gaussian innovation distribution, set

**Moving Average Order**to`3`

.To specify an MA(2) model that includes the first lag, has a Gaussian distribution, but does not include a constant:

Set

**Moving Average Order**to`2`

.Clear the

**Include Constant Term**check box.

To specify an MA(4) model containing nonconsecutive lags

$${y}_{t}={\epsilon}_{t}+{\theta}_{1}{\epsilon}_{t-1}+{\theta}_{4}{\epsilon}_{t-4},$$

where

*ε*is a series of IID Gaussian innovations:_{t}Click the

**Lag Vector**tab.Set

**Moving Average Order**to`1 4`

.Clear the

**Include Constant Term**check box.

To specify an MA(2) model that includes the first lag, includes a constant term, and has

*t*-distributed innovations:Set

**Moving Average Lags**to`2`

.Click the

**Innovation Distribution**button, then select`t`

.

The degrees of freedom parameter of the

*t*distribution is an unknown but estimable parameter.

After you specify a model, click **Estimate** to
estimate all unknown parameters in the model.

- Econometric Modeler App Overview
- Specifying Lag Operator Polynomials Interactively
- Specify Conditional Mean Models
- Modify Properties of Conditional Mean Model Objects
- Specify Conditional Mean Model Innovation Distribution