dlarz (l) - Linux Manuals

dlarz: applies a real elementary reflector H to a real M-by-N matrix C, from either the left or the right

NAME

DLARZ - applies a real elementary reflector H to a real M-by-N matrix C, from either the left or the right

SYNOPSIS

SUBROUTINE DLARZ(
SIDE, M, N, L, V, INCV, TAU, C, LDC, WORK )

    
CHARACTER SIDE

    
INTEGER INCV, L, LDC, M, N

    
DOUBLE PRECISION TAU

    
DOUBLE PRECISION C( LDC, * ), V( * ), WORK( * )

PURPOSE

DLARZ applies a real elementary reflector H to a real M-by-N matrix C, from either the left or the right. H is represented in the form

H = I - tau * v * vaq
where tau is a real scalar and v is a real vector.
If tau = 0, then H is taken to be the unit matrix.
H is a product of k elementary reflectors as returned by DTZRZF.

ARGUMENTS

SIDE (input) CHARACTER*1
= aqLaq: form H * C
= aqRaq: form C * H
M (input) INTEGER
The number of rows of the matrix C.
N (input) INTEGER
The number of columns of the matrix C.
L (input) INTEGER
The number of entries of the vector V containing the meaningful part of the Householder vectors. If SIDE = aqLaq, M >= L >= 0, if SIDE = aqRaq, N >= L >= 0.
V (input) DOUBLE PRECISION array, dimension (1+(L-1)*abs(INCV))
The vector v in the representation of H as returned by DTZRZF. V is not used if TAU = 0.
INCV (input) INTEGER
The increment between elements of v. INCV <> 0.
TAU (input) DOUBLE PRECISION
The value tau in the representation of H.
C (input/output) DOUBLE PRECISION array, dimension (LDC,N)
On entry, the M-by-N matrix C. On exit, C is overwritten by the matrix H * C if SIDE = aqLaq, or C * H if SIDE = aqRaq.
LDC (input) INTEGER
The leading dimension of the array C. LDC >= max(1,M).
WORK (workspace) DOUBLE PRECISION array, dimension
(N) if SIDE = aqLaq or (M) if SIDE = aqRaq

FURTHER DETAILS

Based on contributions by

  A. Petitet, Computer Science Dept., Univ. of Tenn., Knoxville, USA

Pages related to dlarz

  • dlarz (3)
  • dlarzb (l) - applies a real block reflector H or its transpose H**T to a real distributed M-by-N C from the left or the right
  • dlarzt (l) - forms the triangular factor T of a real block reflector H of order > n, which is defined as a product of k elementary reflectors
  • dlar1v (l) - computes the (scaled) r-th column of the inverse of the sumbmatrix in rows B1 through BN of the tridiagonal matrix L D L^T - sigma I
  • dlar2v (l) - applies a vector of real plane rotations from both sides to a sequence of 2-by-2 real symmetric matrices, defined by the elements of the vectors x, y and z
  • dlarf (l) - applies a real elementary reflector H to a real m by n matrix C, from either the left or the right
  • dlarfb (l) - applies a real block reflector H or its transpose Haq to a real m by n matrix C, from either the left or the right
  • dlarfg (l) - generates a real elementary reflector H of order n, such that H * ( alpha ) = ( beta ), Haq * H = I
  • dlarfp (l) - generates a real elementary reflector H of order n, such that H * ( alpha ) = ( beta ), Haq * H = I
  • dlarft (l) - forms the triangular factor T of a real block reflector H of order n, which is defined as a product of k elementary reflectors
  • dlarfx (l) - applies a real elementary reflector H to a real m by n matrix C, from either the left or the right