1CTREXC(1)                LAPACK routine (version 3.2)                CTREXC(1)
2
3
4

NAME

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

SYNOPSIS

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

PURPOSE

20       CTREXC  reorders  the  Schur  factorization  of  a  complex  matrix A =
21       Q*T*Q**H, so that the diagonal element of T  with  row  index  IFST  is
22       moved to row ILST.  The Schur form T is reordered by a unitary similar‐
23       ity transformation Z**H*T*Z, and optionally the matrix Q of Schur  vec‐
24       tors is updated by postmultplying it with Z.
25

ARGUMENTS

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