SYNOPSIS

SUBROUTINE CLARZ(

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

    

CHARACTER SIDE

    

INTEGER INCV, L, LDC, M, N

    

COMPLEX TAU

    

COMPLEX C( LDC, * ), V( * ), WORK( * )

PURPOSE

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

      H = I - tau * v * v'
where tau is a complex scalar and v is a complex vector.
If tau = 0, then H is taken to be the unit matrix.
To apply H' (the conjugate transpose of H), supply conjg(tau) instead tau.
H is a product of k elementary reflectors as returned by CTZRZF.

ARGUMENTS

SIDE (input) CHARACTER*1

= 'L': form H * C
= 'R': 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 = 'L', M >= L >= 0, if SIDE = 'R', N >= L >= 0.

V (input) COMPLEX array, dimension (1+(L-1)*abs(INCV))

The vector v in the representation of H as returned by CTZRZF. V is not used if TAU = 0.

INCV (input) INTEGER

The increment between elements of v. INCV <> 0.

TAU (input) COMPLEX

The value tau in the representation of H.

C (input/output) COMPLEX array, dimension (LDC,N)

On entry, the M-by-N matrix C. On exit, C is overwritten by the matrix H * C if SIDE = 'L', or C * H if SIDE = 'R'.

LDC (input) INTEGER

The leading dimension of the array C. LDC >= max(1,M).

WORK (workspace) COMPLEX array, dimension

(N) if SIDE = 'L' or (M) if SIDE = 'R'

FURTHER DETAILS

Based on contributions by

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