CGGSVP (3)  Linux Man Pages
NAME
cggsvp.f 
SYNOPSIS
Functions/Subroutines
subroutine cggsvp (JOBU, JOBV, JOBQ, M, P, N, A, LDA, B, LDB, TOLA, TOLB, K, L, U, LDU, V, LDV, Q, LDQ, IWORK, RWORK, TAU, WORK, INFO)
CGGSVP
Function/Subroutine Documentation
subroutine cggsvp (characterJOBU, characterJOBV, characterJOBQ, integerM, integerP, integerN, complex, dimension( lda, * )A, integerLDA, complex, dimension( ldb, * )B, integerLDB, realTOLA, realTOLB, integerK, integerL, complex, dimension( ldu, * )U, integerLDU, complex, dimension( ldv, * )V, integerLDV, complex, dimension( ldq, * )Q, integerLDQ, integer, dimension( * )IWORK, real, dimension( * )RWORK, complex, dimension( * )TAU, complex, dimension( * )WORK, integerINFO)
CGGSVP
Purpose:

CGGSVP computes unitary matrices U, V and Q such that NKL K L U**H*A*Q = K ( 0 A12 A13 ) if MKL >= 0; L ( 0 0 A23 ) MKL ( 0 0 0 ) NKL K L = K ( 0 A12 A13 ) if MKL < 0; MK ( 0 0 A23 ) NKL K L V**H*B*Q = L ( 0 0 B13 ) PL ( 0 0 0 ) where the KbyK matrix A12 and LbyL matrix B13 are nonsingular upper triangular; A23 is LbyL upper triangular if MKL >= 0, otherwise A23 is (MK)byL upper trapezoidal. K+L = the effective numerical rank of the (M+P)byN matrix (A**H,B**H)**H. This decomposition is the preprocessing step for computing the Generalized Singular Value Decomposition (GSVD), see subroutine CGGSVD.
Parameters:

JOBU
JOBU is CHARACTER*1 = 'U': Unitary matrix U is computed; = 'N': U is not computed.
JOBVJOBV is CHARACTER*1 = 'V': Unitary matrix V is computed; = 'N': V is not computed.
JOBQJOBQ is CHARACTER*1 = 'Q': Unitary matrix Q is computed; = 'N': Q is not computed.
MM is INTEGER The number of rows of the matrix A. M >= 0.
PP is INTEGER The number of rows of the matrix B. P >= 0.
NN is INTEGER The number of columns of the matrices A and B. N >= 0.
AA is COMPLEX array, dimension (LDA,N) On entry, the MbyN matrix A. On exit, A contains the triangular (or trapezoidal) matrix described in the Purpose section.
LDALDA is INTEGER The leading dimension of the array A. LDA >= max(1,M).
BB is COMPLEX array, dimension (LDB,N) On entry, the PbyN matrix B. On exit, B contains the triangular matrix described in the Purpose section.
LDBLDB is INTEGER The leading dimension of the array B. LDB >= max(1,P).
TOLATOLA is REAL
TOLBTOLB is REAL TOLA and TOLB are the thresholds to determine the effective numerical rank of matrix B and a subblock of A. Generally, they are set to TOLA = MAX(M,N)*norm(A)*MACHEPS, TOLB = MAX(P,N)*norm(B)*MACHEPS. The size of TOLA and TOLB may affect the size of backward errors of the decomposition.
KK is INTEGER
LL is INTEGER On exit, K and L specify the dimension of the subblocks described in Purpose section. K + L = effective numerical rank of (A**H,B**H)**H.
UU is COMPLEX array, dimension (LDU,M) If JOBU = 'U', U contains the unitary matrix U. If JOBU = 'N', U is not referenced.
LDULDU is INTEGER The leading dimension of the array U. LDU >= max(1,M) if JOBU = 'U'; LDU >= 1 otherwise.
VV is COMPLEX array, dimension (LDV,P) If JOBV = 'V', V contains the unitary matrix V. If JOBV = 'N', V is not referenced.
LDVLDV is INTEGER The leading dimension of the array V. LDV >= max(1,P) if JOBV = 'V'; LDV >= 1 otherwise.
QQ is COMPLEX array, dimension (LDQ,N) If JOBQ = 'Q', Q contains the unitary matrix Q. If JOBQ = 'N', Q is not referenced.
LDQLDQ is INTEGER The leading dimension of the array Q. LDQ >= max(1,N) if JOBQ = 'Q'; LDQ >= 1 otherwise.
IWORKIWORK is INTEGER array, dimension (N)
RWORKRWORK is REAL array, dimension (2*N)
TAUTAU is COMPLEX array, dimension (N)
WORKWORK is COMPLEX array, dimension (max(3*N,M,P))
INFOINFO is INTEGER = 0: successful exit < 0: if INFO = i, the ith argument had an illegal value.
Author:

Univ. of Tennessee
Univ. of California Berkeley
Univ. of Colorado Denver
NAG Ltd.
Date:
 November 2011
Further Details:
 The subroutine uses LAPACK subroutine CGEQPF for the QR factorization with column pivoting to detect the effective numerical rank of the a matrix. It may be replaced by a better rank determination strategy.
Definition at line 259 of file cggsvp.f.
Author
Generated automatically by Doxygen for LAPACK from the source code.