ARfit: A Matlab package for the estimation of parameters and eigenmodes of multivariate autoregressive models

Purpose

ARfit is a collection of Matlab modules for

• estimating parameters of multivariate autoregressive (AR) models,
• diagnostic checking of fitted AR models, and
• analyzing eigenmodes of fitted AR models.

The algorithms implemented in ARfit are described in the following papers:

A. Neumaier and T. Schneider, 2000: Estimation of parameters and eigenmodes of multivariate autoregressive models. To appear in ACM Trans. Math. Softw.

T. Schneider and A. Neumaier, 2000: Algorithm: ARfit - A Matlab package for the estimation of parameters and eigenmodes of multivariate autoregressive models. To appear in ACM Trans. Math. Softw.

ARfit has been successfully tested under Matlab 3 and later versions, including Matlab 5.

Installation

The ARfit package consists of a number of Matlab modules and the file CHANGES with a history of recent revisions of the programs.

To install ARfit, copy the Matlab modules (files with names ending in .m) into a directory that is accessible by Matlab. Starting Matlab and invoking Matlab's online help function

help filename

calls up detailed information on the purpose and the calling syntax of the module filename.m. The script ardem.m demonstrates the basic features of the modules contained in ARfit.

Module descriptions

CHANGES

A history of recent changes to ARfit.

acf.m

Plots the sample autocorrelation function of a univariate time series (using XCORR from the Matlab Signal Processing Toolbox).

adjph.m   (auxiliary routine)

Multiplies a complex vector by a phase factor such that the real part and the imaginary part of the vector are orthogonal and the norm of the real part is greater than or equal to the norm of the imaginary part. ADJPH is required by ARMODE to normalize the eigenmodes of an AR model.

arconf.m

Computes approximate confidence intervals for the AR model coefficients.

ardem.m

Demonstrates the use of modules contained in the ARfit package.

arfit.m

Stepwise selection of the order of an AR model and least squares estimation of AR model parameters.

armode.m

Eigendecomposition of AR model. For a fitted AR model, ARMODE computes eigenmodes and their associated oscillation periods and damping times, as well as approximate confidence intervals for the eigenmodes, periods, and damping times.

arord.m   (auxiliary routine)

Computes approximate order selection criteria for a sequence of AR models. ARORD is required by ARFIT.

arqr.m   (auxiliary routine)

QR factorization for least squares estimation of AR model parameters. ARQR is required by ARFIT.

arres.m

Diagnostic checking of the residuals of a fitted model. Computes the time series of residuals. The modified multivariate portmanteau statistic of Li & McLeod (1981) is used to test the residuals for uncorrelatedness.

arsim.m

Simulation of AR processes.

tquant.m   (auxiliary routine)

Quantiles of Student's t distribution. (TQUANT is required by ARCONF and ARMODE in the construction of confidence intervals.)

Copyright

© Copyright 2000 by the Association for Computing Machinery, Inc.

Authors