# clags2.f man page

clags2.f

## Synopsis

### Functions/Subroutines

subroutine **clags2** (UPPER, A1, A2, A3, B1, B2, B3, CSU, SNU, CSV, SNV, CSQ, SNQ)**CLAGS2**

## Function/Subroutine Documentation

### subroutine clags2 (logical UPPER, real A1, complex A2, real A3, real B1, complex B2, real B3, real CSU, complex SNU, real CSV, complex SNV, real CSQ, complex SNQ)

**CLAGS2**

**Purpose:**

CLAGS2 computes 2-by-2 unitary matrices U, V and Q, such that if ( UPPER ) then U**H *A*Q = U**H *( A1 A2 )*Q = ( x 0 ) ( 0 A3 ) ( x x ) and V**H*B*Q = V**H *( B1 B2 )*Q = ( x 0 ) ( 0 B3 ) ( x x ) or if ( .NOT.UPPER ) then U**H *A*Q = U**H *( A1 0 )*Q = ( x x ) ( A2 A3 ) ( 0 x ) and V**H *B*Q = V**H *( B1 0 )*Q = ( x x ) ( B2 B3 ) ( 0 x ) where U = ( CSU SNU ), V = ( CSV SNV ), ( -SNU**H CSU ) ( -SNV**H CSV ) Q = ( CSQ SNQ ) ( -SNQ**H CSQ ) The rows of the transformed A and B are parallel. Moreover, if the input 2-by-2 matrix A is not zero, then the transformed (1,1) entry of A is not zero. If the input matrices A and B are both not zero, then the transformed (2,2) element of B is not zero, except when the first rows of input A and B are parallel and the second rows are zero.

**Parameters:***UPPER*UPPER is LOGICAL = .TRUE.: the input matrices A and B are upper triangular. = .FALSE.: the input matrices A and B are lower triangular.

*A1*A1 is REAL

*A2*A2 is COMPLEX

*A3*A3 is REAL On entry, A1, A2 and A3 are elements of the input 2-by-2 upper (lower) triangular matrix A.

*B1*B1 is REAL

*B2*B2 is COMPLEX

*B3*B3 is REAL On entry, B1, B2 and B3 are elements of the input 2-by-2 upper (lower) triangular matrix B.

*CSU*CSU is REAL

*SNU*SNU is COMPLEX The desired unitary matrix U.

*CSV*CSV is REAL

*SNV*SNV is COMPLEX The desired unitary matrix V.

*CSQ*CSQ is REAL

*SNQ*SNQ is COMPLEX The desired unitary matrix Q.

**Author:**Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

**Date:**December 2016

Definition at line 160 of file clags2.f.

## Author

Generated automatically by Doxygen for LAPACK from the source code.

## Referenced By

The man page clags2(3) is an alias of clags2.f(3).

Tue Nov 14 2017 Version 3.8.0 LAPACK