MB04OY - SLICOT Library Routine Documentation

## MB04OY

### Applying an elementary reflector (using in-line code for a low order) to a matrix C = trans( trans(A) trans(B) ), from the left, where A has one row

[Specification] [Arguments] [Method] [References] [Comments] [Example]

Purpose

      To apply a real elementary reflector H to a real (m+1)-by-n
      matrix C = [ A ], from the left, where A has one row. H is
                 [ B ]
      represented in the form
                                         ( 1 )
            H = I - tau * u *u',    u  = (   ),
                                         ( v )
      where tau is a real scalar and v is a real m-vector.

      If tau = 0, then H is taken to be the unit matrix.

      In-line code is used if H has order < 11.

Specification

          SUBROUTINE MB04OY( M, N, V, TAU, A, LDA, B, LDB, DWORK )
    C     .. Scalar Arguments ..
          INTEGER           LDA, LDB, M, N
          DOUBLE PRECISION  TAU
    C     .. Array Arguments ..
          DOUBLE PRECISION  A( LDA, * ), B( LDB, * ), DWORK( * ), V( * )

Arguments

Input/Output Parameters

      M       (input) INTEGER
              The number of rows of the matrix B.  M >= 0.

      N       (input) INTEGER
              The number of columns of the matrices A and B.  N >= 0.

      V       (input) DOUBLE PRECISION array, dimension (M)
              The vector v in the representation of H.

      TAU     (input) DOUBLE PRECISION
              The scalar factor of the elementary reflector H.

      A       (input/output) DOUBLE PRECISION array, dimension (LDA,N)
              On entry, the leading 1-by-N part of this array must
              contain the matrix A.
              On exit, the leading 1-by-N part of this array contains
              the updated matrix A (the first row of H * C).

      LDA     INTEGER
              The leading dimension of array A.  LDA >= 1.

      B       (input/output) DOUBLE PRECISION array, dimension (LDB,N)
              On entry, the leading M-by-N part of this array must
              contain the matrix B.
              On exit, the leading M-by-N part of this array contains
              the updated matrix B (the last m rows of H * C).

      LDB     INTEGER
              The leading dimension of array B.  LDB >= MAX(1,M).

Workspace

      DWORK   DOUBLE PRECISION array, dimension (N)
              DWORK is not referenced if H has order less than 11.

Method

      The routine applies the elementary reflector H, taking the special
      structure of C into account.

Numerical Aspects

      The algorithm is backward stable.

Further Comments

      None

Example

Program Text

      None

Program Data

      None

Program Results

      None

Return to Supporting Routines index