System Identification Toolbox™

arxstruc

Compute and compare loss functions for single-output ARX models

Syntax

V = arxstruc(ze,zv,NN)
V = arxstruc(ze,zv,NN,maxsize)

Arguments

ze

Estimation data set can be iddata or idfrd object.

zv

Validation data set can be iddata or idfrd object.

NN

Matrix defines the number of different ARX-model structures. Each row of NN is of the form:

nn = [na nb nk]

maxsize

Specified maximum data size. See Algorithm Properties for an explanation.

Description

Note Use arxstruc for single-output systems only. arxstruc supports both single-input and multiple-input systems.

V = arxstruc(ze,zv,NN) returns V, which contains the loss functions in its first row. The remaining rows of V contain the transpose of NN, so that the orders and delays are given just below the corresponding loss functions. The last column of V contains the number of data points in ze.

V = arxstruc(ze,zv,NN,maxsize) uses the additional specification of the maximum data size.

with the same interpretation as described for arx. See struc for easy generation of typical NN matrices for single-input systems.

The output argument V is best analyzed using selstruc. The selection of a suitable model structure based on the information in v is normally done using selstruc.

Remarks

Each of ze and zv is an iddata object containing output-input data. Frequency-domain data and idfrd objects are also supported. Models for each of the model structures defined by NN are estimated using the data set ze. The loss functions (normalized sum of squared prediction errors) are then computed for these models when applied to the validation data set zv. The data sets ze and zv need not be of equal size. They could, however, be the same sets, in which case the computation is faster.

Examples

Compare first- and fifth-order models with one delay using cross-validation on the second half of the data set. Then, select the order that gives the best fit to the validation data set.

NN = struc(1:5,1:5,1);
V = arxstruc(z(1:200),z(201:400),NN);
nn = selstruc(V,0);
m = arx(z,nn);