.TH "clags2.f" 3 "Wed Oct 15 2014" "Version 3.4.2" "LAPACK" \" -*- nroff -*- .ad l .nh .SH NAME clags2.f \- .SH SYNOPSIS .br .PP .SS "Functions/Subroutines" .in +1c .ti -1c .RI "subroutine \fBclags2\fP (UPPER, A1, A2, A3, B1, B2, B3, CSU, SNU, CSV, SNV, CSQ, SNQ)" .br .RI "\fI\fBCLAGS2\fP \fP" .in -1c .SH "Function/Subroutine Documentation" .PP .SS "subroutine clags2 (logicalUPPER, realA1, complexA2, realA3, realB1, complexB2, realB3, realCSU, complexSNU, realCSV, complexSNV, realCSQ, complexSNQ)" .PP \fBCLAGS2\fP .PP \fBPurpose: \fP .RS 4 .PP .nf 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. .fi .PP .RE .PP \fBParameters:\fP .RS 4 \fIUPPER\fP .PP .nf UPPER is LOGICAL = .TRUE.: the input matrices A and B are upper triangular. = .FALSE.: the input matrices A and B are lower triangular. .fi .PP .br \fIA1\fP .PP .nf A1 is REAL .fi .PP .br \fIA2\fP .PP .nf A2 is COMPLEX .fi .PP .br \fIA3\fP .PP .nf A3 is REAL On entry, A1, A2 and A3 are elements of the input 2-by-2 upper (lower) triangular matrix A. .fi .PP .br \fIB1\fP .PP .nf B1 is REAL .fi .PP .br \fIB2\fP .PP .nf B2 is COMPLEX .fi .PP .br \fIB3\fP .PP .nf B3 is REAL On entry, B1, B2 and B3 are elements of the input 2-by-2 upper (lower) triangular matrix B. .fi .PP .br \fICSU\fP .PP .nf CSU is REAL .fi .PP .br \fISNU\fP .PP .nf SNU is COMPLEX The desired unitary matrix U. .fi .PP .br \fICSV\fP .PP .nf CSV is REAL .fi .PP .br \fISNV\fP .PP .nf SNV is COMPLEX The desired unitary matrix V. .fi .PP .br \fICSQ\fP .PP .nf CSQ is REAL .fi .PP .br \fISNQ\fP .PP .nf SNQ is COMPLEX The desired unitary matrix Q. .fi .PP .RE .PP \fBAuthor:\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBDate:\fP .RS 4 November 2011 .RE .PP .PP Definition at line 158 of file clags2\&.f\&. .SH "Author" .PP Generated automatically by Doxygen for LAPACK from the source code\&.