Language Reference


RDODT and RUPDT Calls

CALL RDODT (def, rup, bup, sup, r, z <*>, b <*>, y <*>, ssq );

CALL RUPDT (rup, bup, sup, r, z <*>, b <*>, y <*>, ssq );

If $\bA = \bQ \bR $ is the QR decomposition of the matrix $\bA $, the RUPDT subroutine enables you to efficiently recompute the $\bR $ matrix when a new row is added to A. This is called an update. Similarly, the RDODT subroutine enables you to efficiently recompute the $\bR $ matrix when an existing row is deleted from A. This is called a downdate. You can also use the RDODT and RUPDT subroutines to downdate and update Cholesky decompositions.

The RDODT and RUPDT subroutines return the values:

def

is only used for downdating, and it specifies whether the downdating of matrix $\bR $ by using the q rows in argument z has been successful. The result def=2 means that the downdating of $\bR $ by at least one row of $\mb{Z}$ leads to a singular matrix and cannot be completed successfully (since the result of downdating is not unique). In that case, the results rup, bup, and sup contain missing values only. The result def=1 means that the residual sum of squares, ssq, could not be downdated successfully and the result sup contains missing values only. The result def=0 means that the downdating of $\bR $ by $\mb{Z}$ was completed successfully.

rup

is the $n \times n$ upper triangular matrix $\bR $ that has been updated or downdated by using the q rows in $\mb{Z}$.

bup

is the $n \times p$ matrix $\bB $ of right-hand sides that has been updated or downdated by using the q rows in argument y. If the argument b is not specified, bup is not computed.

sup

is a p vector of square roots of residual sum of squares that is updated or downdated by using the q rows of argument y. If ssq is not specified, sup is not computed.

The input arguments to the RDODT and RUPDT subroutines are as follows:

r

specifies an $n \times n$ upper triangular matrix $\bR $ to be updated or downdated by the q rows in $\mb{Z}$. Only the upper triangle of $\bR $ is used; the lower triangle can contain any information.

z

specifies a $q \times n$ matrix $\mb{Z}$ used rowwise to update or downdate the matrix $\bR $.

b

specifies an optional $n \times p$ matrix $\bB $ of right-hand sides that have to be updated or downdated simultaneously with $\bR $. If b is specified, the argument y must also be specified.

y

specifies an optional $q \times p$ matrix $\bY $ used rowwise to update or downdate the right-hand side matrix $\bB $. If b is specified, the argument y must also be specified.

ssq

is an optional p vector that, if b is specified, specifies the square root of the error sum of squares that should be updated or downdated simultaneously with $\bR $ and $\bB $.

The upper triangular matrix $\bR $ of the QR decomposition of an $m \times n$ matrix $\bA $,

\[ \bA = \bQ \bR , \mbox{ where } \bQ ^{\prime } \bQ = \bQ \bQ ^{\prime } = \bI _ m \]

is recomputed efficiently in two cases:

  • update: An n vector z is added to matrix $\bA $.

  • downdate: An n vector z is deleted from matrix $\bA $.

Computing the whole QR decomposition of matrix $\bA $ by Householder transformations requires $4mn^2 - 4n^3/3$ floating-point operations, whereas updating or downdating the QR decomposition (by Givens rotations) of one row vector z requires only $2n^2$ floating-point operations.

If the QR decomposition is used to solve the full-rank linear least squares problem

\[ \min _{x} \| \bA x - b \| ^2 = \mbox{ssq} \]

by solving the nonsingular upper triangular system

\[ x = \bR ^{-1} \bQ ^{\prime } b \]

then the RUPDT and RDODT subroutines can be used to update or downdate the p-transformed right-hand sides $\bQ ^{\prime } \bB $ and the residual sum-of-squares p vector ssq provided that for each n vector z added to or deleted from $\bA $ there is also a p vector y added to or deleted from the $m \times p$ right-hand-side matrix $\bB $.

If the arguments z and y of the subroutines RUPDT and RDODT contain $q > 1$ row vectors for which $\bR $ (and $\bQ ^{\prime } \bB $, and eventually ssq) is to be updated or downdated, the process is performed stepwise by processing the rows z$_ k$ (and y$_ k$), $k = 1,\ldots ,q$, in the order in which they are stored.

The QR decomposition of an $m \times n$ matrix $\bA $, $m \geq n$, rank$(\bA ) = n$,

\[ \bA = \bQ \bR , \mbox{ where } \bQ ^{\prime } \bQ = \bQ \bQ ^{\prime } = \bI _ m \]

corresponds to the Cholesky factorization

\[ \bC = \bR ^{\prime } \bR , \mbox{ where } \bC = \bA ^{\prime } \bA \]

of the positive definite $n \times n$ crossproduct matrix $\bC = \bA ^{\prime } \bA $. In the case where $m \geq n$ and rank$(\bA ) = n$, the upper triangular matrix $\bR $ computed by the QR decomposition (with positive diagonal elements) is the same as the one computed by Cholesky factorization except for numerical error,

\[ \bA ^{\prime } \bA = (\bQ \bR )^{\prime } (\bQ \bR ) = \bR ^{\prime } \bR \]

Adding a row vector z to matrix $\bA $ corresponds to the rank-1 modification of the crossproduct matrix $\bC $

\[ \widetilde{\bC } = \bC + z^{\prime } z, \mbox{ where } \widetilde{\bC } = \widetilde{\bA }^{\prime } \widetilde{\bA } \]

and the $(m+1) \times n$ matrix $\widetilde{\bA }$ contains all rows of $\bA $ with the row z added.

Deleting a row vector z from matrix $\bA $ corresponds to the rank-1 modification

\[ \bC ^* = \bC - z^{\prime } z, \mbox{ where } \bC ^* = \bA ^{*\prime } \bA ^* \]

and the $(m-1) \times n$ matrix $\bA ^*$ contains all rows of $\bA $ with the row z deleted. Thus, you can also use the subroutines RUPDT and RDODT to update or downdate the Cholesky factor $\bR $ of a positive definite crossproduct matrix $\bC $ of $\bA $.

The process of downdating an upper triangular matrix $\bR $ (and eventually a residual sum-of-squares vector ssq) is not always successful. First of all, the downdated matrix $\bR $ could be rank-deficient. Even if the downdated matrix $\bR $ is of full rank, the process of downdating can be ill-conditioned and does not work well if the downdated matrix is close (by rounding errors) to a rank-deficient one. In these cases, the downdated matrix $\bR $ is not unique and cannot be computed by subroutine RDODT. If $\bR $ cannot be computed, def returns 2, and the results rup, bup, and sup return missing values.

The downdating of the residual sum-of-squares vector ssq can be a problem, too. In practice, the downdate formula

\[ \Argument{ssq}_{\mbox{new}} = \sqrt {{\Argument{ssq}}_{\mbox{old}} - {\Argument{ssq}}_{\mbox{dod}}} \]

cannot always be computed because, due to rounding errors, the radicand can be negative. In this case, the result vector sup returns missing values, and def returns 1.

You can use various methods to compute the p columns $x_ k$ of the $n \times p$ matrix $\bX $ that minimize the p linear least squares problems with an $m \times n$ coefficient matrix $\bA $, $m\geq n$, rank$(\bA )=n$, and p right-hand-side vectors b$_ k$ (stored columnwise in the $m \times p$ matrix $\bB $).

The methods in this section use the following simple example:

 a = { 1 3 ,
       2 2 ,
       3 1 };
 b = { 1, 1, 1};
 m = nrow(a);
 n = ncol(a);
 p = ncol(b);
  • Cholesky decomposition of crossproduct matrix:

    /* form and solve the normal equations */
    aa = a` * a; ab = a` * b;
    r  = root(aa);
    x  = trisolv(2,r,ab);
    x  = trisolv(1,r,x);
    print x;
    
  • QR decomposition by Householder transformations:

    call qr(qtb, r, piv, lindep, a, , b);
    x = trisolv(1, r[,piv], qtb[1:n,]);
    
  • Stepwise update by Givens rotations:

    r = j(n,n,0); qtb = j(n,p,0); ssq = j(1,p,0);
    do i = 1 to m;
       z = a[i,];
       y = b[i,];
       call rupdt(rup,bup,sup,r,z,qtb,y,ssq);
       r   = rup;
       qtb = bup;
       ssq = sup;
    end;
    x = trisolv(1,r,qtb);
    

    Or, equivalently:

    r   = j(n,n,0); qtb = j(n,p,0); ssq = j(1,p,0);
    call rupdt(rup,bup,sup,r,a,qtb,b,ssq);
    x   = trisolv(1,rup,bup);
    
  • Singular value decomposition:

    call svd(u, d, v, a);
    d = diag(1 / d);
    x = v * d * u` * b;
    

For the preceding $3 \times 2$ example matrix a, each method obtains the unique LS estimator:

ss = ssq(a * x - b);
print ss x;

Figure 25.323: Least Squares Solution and Sum of Squared Residuals

ss x
2.465E-31 0.25
  0.25



To compute the (transposed) matrix $\bQ $, you can use the following technique:

r = repeat(0,n,n);
y = i(m);
qt = repeat(0,n,m);
call rupdt(rup, qtup, sup, r, a, qt, y);
print qtup;

Figure 25.324: Transposed Matrix

qtup
0.2672612 0.5345225 0.8017837
-0.872872 -0.218218 0.4364358