1ZTREXC(1)                LAPACK routine (version 3.1)                ZTREXC(1)
2
3
4

NAME

6       ZTREXC  -  the Schur factorization of a complex matrix A = Q*T*Q**H, so
7       that the diagonal element of T with row index IFST is moved to row ILST
8

SYNOPSIS

10       SUBROUTINE ZTREXC( COMPQ, N, T, LDT, Q, LDQ, IFST, ILST, INFO )
11
12           CHARACTER      COMPQ
13
14           INTEGER        IFST, ILST, INFO, LDQ, LDT, N
15
16           COMPLEX*16     Q( LDQ, * ), T( LDT, * )
17

PURPOSE

19       ZTREXC reorders the  Schur  factorization  of  a  complex  matrix  A  =
20       Q*T*Q**H,  so  that  the  diagonal  element of T with row index IFST is
21       moved to row ILST.
22
23       The Schur form T is reordered by a  unitary  similarity  transformation
24       Z**H*T*Z,  and  optionally  the matrix Q of Schur vectors is updated by
25       postmultplying it with Z.
26
27

ARGUMENTS

29       COMPQ   (input) CHARACTER*1
30               = 'V':  update the matrix Q of Schur vectors;
31               = 'N':  do not update Q.
32
33       N       (input) INTEGER
34               The order of the matrix T. N >= 0.
35
36       T       (input/output) COMPLEX*16 array, dimension (LDT,N)
37               On  entry,  the  upper  triangular  matrix  T.   On  exit,  the
38               reordered upper triangular matrix.
39
40       LDT     (input) INTEGER
41               The leading dimension of the array T. LDT >= max(1,N).
42
43       Q       (input/output) COMPLEX*16 array, dimension (LDQ,N)
44               On  entry,  if  COMPQ = 'V', the matrix Q of Schur vectors.  On
45               exit, if COMPQ = 'V', Q has been postmultiplied by the  unitary
46               transformation matrix Z which reorders T.  If COMPQ = 'N', Q is
47               not referenced.
48
49       LDQ     (input) INTEGER
50               The leading dimension of the array Q.  LDQ >= max(1,N).
51
52       IFST    (input) INTEGER
53               ILST    (input) INTEGER Specify the reordering of the  diagonal
54               elements  of T: The element with row index IFST is moved to row
55               ILST by a sequence of transpositions between adjacent elements.
56               1 <= IFST <= N; 1 <= ILST <= N.
57
58       INFO    (output) INTEGER
59               = 0:  successful exit
60               < 0:  if INFO = -i, the i-th argument had an illegal value
61
62
63
64 LAPACK routine (version 3.1)    November 2006                       ZTREXC(1)
Impressum