Purpose
To annihilate one or two entries on the subdiagonal of the Hessenberg matrix A for dealing with zero elements on the diagonal of the triangular matrix B. MB03YA is an auxiliary routine called by SLICOT Library routines MB03XP and MB03YD.Specification
      SUBROUTINE MB03YA( WANTT, WANTQ, WANTZ, N, ILO, IHI, ILOQ, IHIQ,
     $                   POS, A, LDA, B, LDB, Q, LDQ, Z, LDZ, INFO )
C     .. Scalar Arguments ..
      LOGICAL            WANTQ, WANTT, WANTZ
      INTEGER            IHI, IHIQ, ILO, ILOQ, INFO, LDA, LDB, LDQ, LDZ,
     $                   N, POS
C     .. Array Arguments ..
      DOUBLE PRECISION   A(LDA,*), B(LDB,*), Q(LDQ,*), Z(LDZ,*)
Arguments
Mode Parameters
  WANTT   LOGICAL
          Indicates whether the user wishes to compute the full
          Schur form or the eigenvalues only, as follows:
          = .TRUE. :  Compute the full Schur form;
          = .FALSE.:  compute the eigenvalues only.
  WANTQ   LOGICAL
          Indicates whether or not the user wishes to accumulate
          the matrix Q as follows:
          = .TRUE. :  The matrix Q is updated;
          = .FALSE.:  the matrix Q is not required.
  WANTZ   LOGICAL
          Indicates whether or not the user wishes to accumulate
          the matrix Z as follows:
          = .TRUE. :  The matrix Z is updated;
          = .FALSE.:  the matrix Z is not required.
Input/Output Parameters
  N       (input) INTEGER
          The order of the matrices A and B. N >= 0.
  ILO     (input) INTEGER
  IHI     (input) INTEGER
          It is assumed that the matrices A and B are already
          (quasi) upper triangular in rows and columns 1:ILO-1 and
          IHI+1:N. The routine works primarily with the submatrices
          in rows and columns ILO to IHI, but applies the
          transformations to all the rows and columns of the
          matrices A and B, if WANTT = .TRUE..
          1 <= ILO <= max(1,N); min(ILO,N) <= IHI <= N.
  ILOQ    (input) INTEGER
  IHIQ    (input) INTEGER
          Specify the rows of Q and Z to which transformations
          must be applied if WANTQ = .TRUE. and WANTZ = .TRUE.,
          respectively.
          1 <= ILOQ <= ILO; IHI <= IHIQ <= N.
  POS     (input) INTEGER
          The position of the zero element on the diagonal of B.
          ILO <= POS <= IHI.
  A       (input/output) DOUBLE PRECISION array, dimension (LDA,N)
          On entry, the leading N-by-N part of this array must
          contain the upper Hessenberg matrix A.
          On exit, the leading N-by-N part of this array contains
          the updated matrix A where A(POS,POS-1) = 0, if POS > ILO,
          and A(POS+1,POS) = 0, if POS < IHI.
  LDA     INTEGER
          The leading dimension of the array A.  LDA >= MAX(1,N).
  B       (input/output) DOUBLE PRECISION array, dimension (LDB,N)
          On entry, the leading N-by-N part of this array must
          contain an upper triangular matrix B with B(POS,POS) = 0.
          On exit, the leading N-by-N part of this array contains
          the updated upper triangular matrix B.
  LDB     INTEGER
          The leading dimension of the array B.  LDB >= MAX(1,N).
  Q       (input/output) DOUBLE PRECISION array, dimension (LDQ,N)
          On entry, if WANTQ = .TRUE., then the leading N-by-N part
          of this array must contain the current matrix Q of
          transformations accumulated by MB03XP.
          On exit, if WANTQ = .TRUE., then the leading N-by-N part
          of this array contains the matrix Q updated in the
          submatrix Q(ILOQ:IHIQ,ILO:IHI).
          If WANTQ = .FALSE., Q is not referenced.
  LDQ     INTEGER
          The leading dimension of the array Q.  LDQ >= 1.
          If WANTQ = .TRUE., LDQ >= MAX(1,N).
  Z       (input/output) DOUBLE PRECISION array, dimension (LDZ,N)
          On entry, if WANTZ = .TRUE., then the leading N-by-N part
          of this array must contain the current matrix Z of
          transformations accumulated by MB03XP.
          On exit, if WANTZ = .TRUE., then the leading N-by-N part
          of this array contains the matrix Z updated in the
          submatrix Z(ILOQ:IHIQ,ILO:IHI).
          If WANTZ = .FALSE., Z is not referenced.
  LDZ     INTEGER
          The leading dimension of the array Z.  LDZ >= 1.
          If WANTZ = .TRUE., LDZ >= MAX(1,N).
Error Indicator
  INFO    INTEGER
          = 0:  successful exit;
          < 0:  if INFO = -i, the i-th argument had an illegal
                value.
Method
  The method is illustrated by Wilkinson diagrams for N = 5,
  POS = 3:
        [ x x x x x ]       [ x x x x x ]
        [ x x x x x ]       [ o x x x x ]
    A = [ o x x x x ],  B = [ o o o x x ].
        [ o o x x x ]       [ o o o x x ]
        [ o o o x x ]       [ o o o o x ]
  First, a QR factorization is applied to A(1:3,1:3) and the
  resulting nonzero in the updated matrix B is immediately
  annihilated by a Givens rotation acting on columns 1 and 2:
        [ x x x x x ]       [ x x x x x ]
        [ x x x x x ]       [ o x x x x ]
    A = [ o o x x x ],  B = [ o o o x x ].
        [ o o x x x ]       [ o o o x x ]
        [ o o o x x ]       [ o o o o x ]
  Secondly, an RQ factorization is applied to A(4:5,4:5) and the
  resulting nonzero in the updated matrix B is immediately
  annihilated by a Givens rotation acting on rows 4 and 5:
        [ x x x x x ]       [ x x x x x ]
        [ x x x x x ]       [ o x x x x ]
    A = [ o o x x x ],  B = [ o o o x x ].
        [ o o o x x ]       [ o o o x x ]
        [ o o o x x ]       [ o o o o x ]
References
  [1] Bojanczyk, A.W., Golub, G.H., and Van Dooren, P.
      The periodic Schur decomposition: Algorithms and applications.
      Proc. of the SPIE Conference (F.T. Luk, Ed.), 1770, pp. 31-42,
      1992.
Numerical Aspects
The algorithm requires O(N**2) floating point operations and is backward stable.Further Comments
NoneExample
Program Text
NoneProgram Data
NoneProgram Results
None