## MB03CZ

### Exchanging eigenvalues of a complex 2-by-2 upper triangular pencil (factored version)

[Specification] [Arguments] [Method] [References] [Comments] [Example]

Purpose

```  To compute unitary matrices Q1, Q2, and Q3 for a complex 2-by-2
regular pencil aAB - bD, with A, B, D upper triangular, such that
Q3' A Q2, Q2' B Q1, Q3' D Q1 are still upper triangular, but the
eigenvalues are in reversed order. The matrices Q1, Q2, and Q3 are
represented by

(  CO1  SI1  )       (  CO2  SI2  )       (  CO3  SI3  )
Q1 = (            ), Q2 = (            ), Q3 = (            ).
( -SI1' CO1  )       ( -SI2' CO2  )       ( -SI3' CO3  )

The notation M' denotes the conjugate transpose of the matrix M.

```
Specification
```      SUBROUTINE MB03CZ( A, LDA, B, LDB, D, LDD, CO1, SI1, CO2, SI2,
\$                   CO3, SI3 )
C     .. Scalar Arguments ..
INTEGER            LDA, LDB, LDD
DOUBLE PRECISION   CO1, CO2, CO3
COMPLEX*16         SI1, SI2, SI3
C     .. Array Arguments ..
COMPLEX*16         A( LDA, * ), B( LDB, * ), D( LDD, * )

```
Arguments

Input/Output Parameters

```  A       (input) COMPLEX*16 array, dimension (LDA, 2)
On entry, the leading 2-by-2 upper triangular part of
this array must contain the matrix A of the pencil.
The (2,1) entry is not referenced.

LDA     INTEGER
The leading dimension of the array A.  LDA >= 2.

B       (input) COMPLEX*16 array, dimension (LDB, 2)
On entry, the leading 2-by-2 upper triangular part of
this array must contain the matrix B of the pencil.
The (2,1) entry is not referenced.

LDB     INTEGER
The leading dimension of the array B.  LDB >= 2.

D       (input) COMPLEX*16 array, dimension (LDD, 2)
On entry, the leading 2-by-2 upper triangular part of
this array must contain the matrix D of the pencil.
The (2,1) entry is not referenced.

LDD     INTEGER
The leading dimension of the array D.  LDD >= 2.

CO1     (output) DOUBLE PRECISION
The upper left element of the unitary matrix Q1.

SI1     (output) COMPLEX*16
The upper right element of the unitary matrix Q1.

CO2     (output) DOUBLE PRECISION
The upper left element of the unitary matrix Q2.

SI2     (output) COMPLEX*16
The upper right element of the unitary matrix Q2.

CO3     (output) DOUBLE PRECISION
The upper left element of the unitary matrix Q3.

SI3     (output) COMPLEX*16
The upper right element of the unitary matrix Q3.

```
Method
```  The algorithm uses unitary transformations as described on page 37
in [1].

```
References
```  [1] Benner, P., Byers, R., Mehrmann, V. and Xu, H.
Numerical Computation of Deflating Subspaces of Embedded
Hamiltonian Pencils.
Tech. Rep. SFB393/99-15, Technical University Chemnitz,
Germany, June 1999.

```
Numerical Aspects
```  The algorithm is numerically backward stable.

```
Further Comments
```  None
```
Example

Program Text

```  None
```
Program Data
```  None
```
Program Results
```  None
```

Return to Supporting Routines index