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

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

Contents


DLAEXC(3F)							    DLAEXC(3F)


NAME    [Toc]    [Back]

     DLAEXC - swap adjacent diagonal blocks T11	and T22	of order 1 or 2	in an
     upper quasi-triangular matrix T by	an orthogonal similarity
     transformation

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	DLAEXC(	WANTQ, N, T, LDT, Q, LDQ, J1, N1, N2, WORK, INFO )

	 LOGICAL	WANTQ

	 INTEGER	INFO, J1, LDQ, LDT, N, N1, N2

	 DOUBLE		PRECISION Q( LDQ, * ), T( LDT, * ), WORK( * )

PURPOSE    [Toc]    [Back]

     DLAEXC swaps adjacent diagonal blocks T11 and T22 of order	1 or 2 in an
     upper quasi-triangular matrix T by	an orthogonal similarity
     transformation.

     T must be in Schur	canonical form,	that is, block upper triangular	with
     1-by-1 and	2-by-2 diagonal	blocks;	each 2-by-2 diagonal block has its
     diagonal elemnts equal and	its off-diagonal elements of opposite sign.

ARGUMENTS    [Toc]    [Back]

     WANTQ   (input) LOGICAL
	     = .TRUE. :	accumulate the transformation in the matrix Q;
	     = .FALSE.:	do not accumulate the transformation.

     N	     (input) INTEGER
	     The order of the matrix T.	N >= 0.

     T	     (input/output) DOUBLE PRECISION array, dimension (LDT,N)
	     On	entry, the upper quasi-triangular matrix T, in Schur canonical
	     form.  On exit, the updated matrix	T, again in Schur canonical
	     form.

     LDT     (input)  INTEGER
	     The leading dimension of the array	T. LDT >= max(1,N).

     Q	     (input/output) DOUBLE PRECISION array, dimension (LDQ,N)
	     On	entry, if WANTQ	is .TRUE., the orthogonal matrix Q.  On	exit,
	     if	WANTQ is .TRUE., the updated matrix Q.	If WANTQ is .FALSE., Q
	     is	not referenced.

     LDQ     (input) INTEGER
	     The leading dimension of the array	Q.  LDQ	>= 1; and if WANTQ is
	     .TRUE., LDQ >= N.

     J1	     (input) INTEGER
	     The index of the first row	of the first block T11.




									Page 1






DLAEXC(3F)							    DLAEXC(3F)



     N1	     (input) INTEGER
	     The order of the first block T11. N1 = 0, 1 or 2.

     N2	     (input) INTEGER
	     The order of the second block T22.	N2 = 0,	1 or 2.

     WORK    (workspace) DOUBLE	PRECISION array, dimension (N)

     INFO    (output) INTEGER
	     = 0: successful exit
	     = 1: the transformed matrix T would be too	far from Schur form;
	     the blocks	are not	swapped	and T and Q are	unchanged.
DLAEXC(3F)							    DLAEXC(3F)


NAME    [Toc]    [Back]

     DLAEXC - swap adjacent diagonal blocks T11	and T22	of order 1 or 2	in an
     upper quasi-triangular matrix T by	an orthogonal similarity
     transformation

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	DLAEXC(	WANTQ, N, T, LDT, Q, LDQ, J1, N1, N2, WORK, INFO )

	 LOGICAL	WANTQ

	 INTEGER	INFO, J1, LDQ, LDT, N, N1, N2

	 DOUBLE		PRECISION Q( LDQ, * ), T( LDT, * ), WORK( * )

PURPOSE    [Toc]    [Back]

     DLAEXC swaps adjacent diagonal blocks T11 and T22 of order	1 or 2 in an
     upper quasi-triangular matrix T by	an orthogonal similarity
     transformation.

     T must be in Schur	canonical form,	that is, block upper triangular	with
     1-by-1 and	2-by-2 diagonal	blocks;	each 2-by-2 diagonal block has its
     diagonal elemnts equal and	its off-diagonal elements of opposite sign.

ARGUMENTS    [Toc]    [Back]

     WANTQ   (input) LOGICAL
	     = .TRUE. :	accumulate the transformation in the matrix Q;
	     = .FALSE.:	do not accumulate the transformation.

     N	     (input) INTEGER
	     The order of the matrix T.	N >= 0.

     T	     (input/output) DOUBLE PRECISION array, dimension (LDT,N)
	     On	entry, the upper quasi-triangular matrix T, in Schur canonical
	     form.  On exit, the updated matrix	T, again in Schur canonical
	     form.

     LDT     (input)  INTEGER
	     The leading dimension of the array	T. LDT >= max(1,N).

     Q	     (input/output) DOUBLE PRECISION array, dimension (LDQ,N)
	     On	entry, if WANTQ	is .TRUE., the orthogonal matrix Q.  On	exit,
	     if	WANTQ is .TRUE., the updated matrix Q.	If WANTQ is .FALSE., Q
	     is	not referenced.

     LDQ     (input) INTEGER
	     The leading dimension of the array	Q.  LDQ	>= 1; and if WANTQ is
	     .TRUE., LDQ >= N.

     J1	     (input) INTEGER
	     The index of the first row	of the first block T11.




									Page 1






DLAEXC(3F)							    DLAEXC(3F)



     N1	     (input) INTEGER
	     The order of the first block T11. N1 = 0, 1 or 2.

     N2	     (input) INTEGER
	     The order of the second block T22.	N2 = 0,	1 or 2.

     WORK    (workspace) DOUBLE	PRECISION array, dimension (N)

     INFO    (output) INTEGER
	     = 0: successful exit
	     = 1: the transformed matrix T would be too	far from Schur form;
	     the blocks	are not	swapped	and T and Q are	unchanged.


									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
sgehd2 IRIX reduce a real general matrix A to upper Hessenberg form H by an orthogonal similarity transformation
sgehrd IRIX reduce a real general matrix A to upper Hessenberg form H by an orthogonal similarity transformation
dgehrd IRIX reduce a real general matrix A to upper Hessenberg form H by an orthogonal similarity transformation
dgehd2 IRIX reduce a real general matrix A to upper Hessenberg form H by an orthogonal similarity transformation
strevc IRIX real upper quasi-triangular matrix T
dtrevc IRIX real upper quasi-triangular matrix T
dtrsna IRIX and/or right eigenvectors of a real upper quasi-triangular matrix T (or of any matrix Q*T*Q**T with Q orthogon
strsna IRIX and/or right eigenvectors of a real upper quasi-triangular matrix T (or of any matrix Q*T*Q**T with Q orthogon
dtzrqf IRIX reduce the M-by-N ( M<=N ) real upper trapezoidal matrix A to upper triangular form by means of orthogonal tra
stzrqf IRIX reduce the M-by-N ( M<=N ) real upper trapezoidal matrix A to upper triangular form by means of orthogonal tra
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service