*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> complib/zungqr (3)              
Title
Content
Arch
Section
 

Contents


ZUNGQR(3F)							    ZUNGQR(3F)


NAME    [Toc]    [Back]

     ZUNGQR - generate an M-by-N complex matrix	Q with orthonormal columns,

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	ZUNGQR(	M, N, K, A, LDA, TAU, WORK, LWORK, INFO	)

	 INTEGER	INFO, K, LDA, LWORK, M,	N

	 COMPLEX*16	A( LDA,	* ), TAU( * ), WORK( LWORK )

PURPOSE    [Toc]    [Back]

     ZUNGQR generates an M-by-N	complex	matrix Q with orthonormal columns,
     which is defined as the first N columns of	a product of K elementary
     reflectors	of order M

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

     as	returned by ZGEQRF.

ARGUMENTS    [Toc]    [Back]

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

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

     K	     (input) INTEGER
	     The number	of elementary reflectors whose product defines the
	     matrix Q. N >= K >= 0.

     A	     (input/output) COMPLEX*16 array, dimension	(LDA,N)
	     On	entry, 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.  On	exit,
	     the M-by-N	matrix Q.

     LDA     (input) INTEGER
	     The first dimension of the	array A. LDA >=	max(1,M).

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

     WORK    (workspace/output)	COMPLEX*16 array, dimension (LWORK)
	     On	exit, if INFO =	0, WORK(1) returns the optimal LWORK.

     LWORK   (input) INTEGER
	     The dimension of the array	WORK. LWORK >= max(1,N).  For optimum
	     performance LWORK >= N*NB,	where NB is the	optimal	blocksize.





									Page 1






ZUNGQR(3F)							    ZUNGQR(3F)



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


NAME    [Toc]    [Back]

     ZUNGQR - generate an M-by-N complex matrix	Q with orthonormal columns,

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	ZUNGQR(	M, N, K, A, LDA, TAU, WORK, LWORK, INFO	)

	 INTEGER	INFO, K, LDA, LWORK, M,	N

	 COMPLEX*16	A( LDA,	* ), TAU( * ), WORK( LWORK )

PURPOSE    [Toc]    [Back]

     ZUNGQR generates an M-by-N	complex	matrix Q with orthonormal columns,
     which is defined as the first N columns of	a product of K elementary
     reflectors	of order M

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

     as	returned by ZGEQRF.

ARGUMENTS    [Toc]    [Back]

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

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

     K	     (input) INTEGER
	     The number	of elementary reflectors whose product defines the
	     matrix Q. N >= K >= 0.

     A	     (input/output) COMPLEX*16 array, dimension	(LDA,N)
	     On	entry, 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.  On	exit,
	     the M-by-N	matrix Q.

     LDA     (input) INTEGER
	     The first dimension of the	array A. LDA >=	max(1,M).

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

     WORK    (workspace/output)	COMPLEX*16 array, dimension (LWORK)
	     On	exit, if INFO =	0, WORK(1) returns the optimal LWORK.

     LWORK   (input) INTEGER
	     The dimension of the array	WORK. LWORK >= max(1,N).  For optimum
	     performance LWORK >= N*NB,	where NB is the	optimal	blocksize.





									Page 1






ZUNGQR(3F)							    ZUNGQR(3F)



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


									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
zung2r IRIX generate an m by n complex matrix Q with orthonormal columns,
zung2l IRIX generate an m by n complex matrix Q with orthonormal columns,
cung2r IRIX generate an m by n complex matrix Q with orthonormal columns,
cung2l IRIX generate an m by n complex matrix Q with orthonormal columns,
dorg2r IRIX generate an m by n real matrix Q with orthonormal columns,
dorg2l IRIX generate an m by n real matrix Q with orthonormal columns,
dorgql IRIX generate an M-by-N real matrix Q with orthonormal columns,
dorgqr IRIX generate an M-by-N real matrix Q with orthonormal columns,
sorg2l IRIX generate an m by n real matrix Q with orthonormal columns,
sorg2r IRIX generate an m by n real matrix Q with orthonormal columns,
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service