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

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

Contents


SORGQL(3F)							    SORGQL(3F)


NAME    [Toc]    [Back]

     SORGQL - generate an M-by-N real matrix Q with orthonormal	columns,

SYNOPSIS    [Toc]    [Back]

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

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

	 REAL		A( LDA,	* ), TAU( * ), WORK( LWORK )

PURPOSE    [Toc]    [Back]

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

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

     as	returned by SGEQLF.

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) REAL array,	dimension (LDA,N)
	     On	entry, the (n-k+i)-th column must contain the vector which
	     defines the elementary reflector H(i), for	i = 1,2,...,k, as
	     returned by SGEQLF	in the last 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) REAL array, dimension (K)
	     TAU(i) must contain the scalar factor of the elementary reflector
	     H(i), as returned by SGEQLF.

     WORK    (workspace/output)	REAL 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






SORGQL(3F)							    SORGQL(3F)



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


NAME    [Toc]    [Back]

     SORGQL - generate an M-by-N real matrix Q with orthonormal	columns,

SYNOPSIS    [Toc]    [Back]

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

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

	 REAL		A( LDA,	* ), TAU( * ), WORK( LWORK )

PURPOSE    [Toc]    [Back]

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

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

     as	returned by SGEQLF.

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) REAL array,	dimension (LDA,N)
	     On	entry, the (n-k+i)-th column must contain the vector which
	     defines the elementary reflector H(i), for	i = 1,2,...,k, as
	     returned by SGEQLF	in the last 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) REAL array, dimension (K)
	     TAU(i) must contain the scalar factor of the elementary reflector
	     H(i), as returned by SGEQLF.

     WORK    (workspace/output)	REAL 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






SORGQL(3F)							    SORGQL(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
dorg2r 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,
sorg2l 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,
cung2r IRIX generate an m by n complex matrix Q with orthonormal columns,
cungqr IRIX generate an M-by-N complex matrix Q with orthonormal columns,
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,
zungql IRIX generate an M-by-N complex matrix Q with orthonormal columns,
zungqr IRIX generate an M-by-N complex matrix Q with orthonormal columns,
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service