Language Reference

VTSROOT Call

CALL VTSROOT (root, phi, theta <, p> <, q> ) ;

This subroutine is supported by the IML procedure and the iml action.

The VTSROOT subroutine computes the characteristic roots of the model from AR and MA characteristic functions.

The input arguments to the VTSROOT subroutine are as follows:

phi

specifies a k m Subscript p times k matrix that contains the autoregressive coefficient matrices, where m Subscript p is the number of the elements in the subset of the AR order and k greater-than-or-equal-to 2 is the number of variables. You must specify either phi or theta.

theta

specifies a k m Subscript q times k matrix that contains the moving average coefficient matrices, where m Subscript q is the number of the elements in the subset of the MA order. You must specify either phi or theta.

p

specifies the subset of the AR order. See the VARMACOV subroutine.

q

specifies the subset of the MA order. See the VARMACOV subroutine.

The VTSROOT subroutine returns the following value:

root

is a k left-parenthesis p Subscript normal m normal a normal x Baseline plus q Subscript normal m normal a normal x Baseline right-parenthesis times 5 matrix, where p Subscript normal m normal a normal x is the maximum order of the AR characteristic function and q Subscript normal m normal a normal x is the maximum order of the MA characteristic function. The first k p Subscript normal m normal a normal x rows refer to the results of the AR characteristic function; the last k q Subscript normal m normal a normal x rows refer to the results of the MA characteristic function.

The first column contains the real parts, x, of eigenvalues of companion matrix associated with the AR(p Subscript normal m normal a normal x) or MA(q Subscript normal m normal a normal x) characteristic function; the second column contains the imaginary parts, y, of the eigenvalues; the third column contains the moduli of the eigenvalues, StartRoot x squared plus y squared EndRoot; the fourth column contains the arguments (arc tangent left-parenthesis y slash x right-parenthesis) of the eigenvalues, measured in radians from the positive real axis. The fifth column contains the arguments expressed in degrees rather than radians.

Consider the roots of the characteristic functions, normal upper Phi left-parenthesis upper B right-parenthesis equals upper I minus normal upper Phi upper B and normal upper Theta left-parenthesis upper B right-parenthesis equals upper I minus normal upper Theta upper B, where I is an identity matrix with dimension 2 and

normal upper Phi equals Start 2 By 2 Matrix 1st Row 1st Column 1.2 2nd Column negative 0.5 2nd Row 1st Column 0.6 2nd Column 0.3 EndMatrix normal upper Theta equals Start 2 By 2 Matrix 1st Row 1st Column negative 0.6 2nd Column 0.3 2nd Row 1st Column 0.3 2nd Column 0.6 EndMatrix

To compute these roots, you can use the following statements:

phi  = { 1.2 -0.5, 0.6 0.3 };
theta= {-0.6  0.3, 0.3 0.6 };
call vtsroot(root, phi, theta);
cols = {"Real" "Imag" "Modulus" "Radians" "Degrees"};
print root[colname=cols];

Figure 494: Characteristic Roots

root
RealImagModulusRadiansDegrees
0.750.31224990.81240380.394506922.603583
0.75-0.312250.8124038-0.394507-22.60358
0.670820400.670820400
-0.6708200.67082043.1415927180


Last updated: May 07, 2026