Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31559 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

ZUNM2R(3F)							    ZUNM2R(3F)

NAME
     ZUNM2R - overwrite the general complex m-by-n matrix C with   Q * C if
     SIDE = 'L' and TRANS = 'N', or   Q'* C if SIDE = 'L' and TRANS = 'C', or
     C * Q if SIDE = 'R' and TRANS = 'N', or   C * Q' if SIDE = 'R' and TRANS
     = 'C',

SYNOPSIS
     SUBROUTINE ZUNM2R( SIDE, TRANS, M, N, K, A, LDA, TAU, C, LDC, WORK, INFO
			)

	 CHARACTER	SIDE, TRANS

	 INTEGER	INFO, K, LDA, LDC, M, N

	 COMPLEX*16	A( LDA, * ), C( LDC, * ), TAU( * ), WORK( * )

PURPOSE
     ZUNM2R overwrites the general complex m-by-n matrix C with

     where Q is a complex unitary matrix defined as the product of k
     elementary reflectors

	   Q = H(1) H(2) . . . H(k)

     as returned by ZGEQRF. Q is of order m if SIDE = 'L' and of order n if
     SIDE = 'R'.

ARGUMENTS
     SIDE    (input) CHARACTER*1
	     = 'L': apply Q or Q' from the Left
	     = 'R': apply Q or Q' from the Right

     TRANS   (input) CHARACTER*1
	     = 'N': apply Q  (No transpose)
	     = 'C': apply Q' (Conjugate transpose)

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

     N	     (input) INTEGER
	     The number of columns of the matrix C. N >= 0.

     K	     (input) INTEGER
	     The number of elementary reflectors whose product defines the
	     matrix Q.	If SIDE = 'L', M >= K >= 0; if SIDE = 'R', N >= K >=
	     0.

     A	     (input) COMPLEX*16 array, dimension (LDA,K)
	     The i-th column must contain the vector which defines the
	     elementary reflector H(i), for i = 1,2,...,k, as returned by
	     ZGEQRF in the first k columns of its array argument A.  A is

									Page 1

ZUNM2R(3F)							    ZUNM2R(3F)

	     modified by the routine but restored on exit.

     LDA     (input) INTEGER
	     The leading dimension of the array A.  If SIDE = 'L', LDA >=
	     max(1,M); if SIDE = 'R', LDA >= max(1,N).

     TAU     (input) COMPLEX*16 array, dimension (K)
	     TAU(i) must contain the scalar factor of the elementary reflector
	     H(i), as returned by ZGEQRF.

     C	     (input/output) COMPLEX*16 array, dimension (LDC,N)
	     On entry, the m-by-n matrix C.  On exit, C is overwritten by Q*C
	     or Q'*C or C*Q' or C*Q.

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

     WORK    (workspace) COMPLEX*16 array, dimension
	     (N) if SIDE = 'L', (M) if SIDE = 'R'

     INFO    (output) INTEGER
	     = 0: successful exit
	     < 0: if INFO = -i, the i-th argument had an illegal value

									Page 2

Vote for polarhome