Previous: cggbal Up: ../lapack-c.html Next: cgghrd

NAME CGGGLM - solve a generalized linear regression model (GLM) problem SYNOPSIS SUBROUTINE CGGGLM( N, M, P, A, LDA, B, LDB, D, X, Y, WORK, LWORK, INFO ) INTEGER INFO, LDA, LDB, LWORK, M, N, P COMPLEX A( LDA, * ), B( LDB, * ), D( * ), WORK( * ), X( * ), Y( * ) PURPOSE CGGGLM solves a generalized linear regression model (GLM) problem: minimize y'*y subject to d = A*x + B*y x,y using a generalized QR factorization of A and B, where A is an N-by-M matrix, B is a given N-by-P matrix, and d is given N vector. It is also assumed that M <= N <= M+P and rank(A) = M and rank([ A B ]) = N. Under these assumptions, the constrained equation is always consistent, and there is a unique solution x and a minimal 2-norm solution y. In particular, if matrix B is square nonsingular, then the problem GLM is equivalent to the following weighted linear least squares problem minimize || inv(B)*(b-A*x) || x where ||.|| is vector 2-norm, and inv(B) denotes the inverse of matrix B. ARGUMENTS N (input) INTEGER The number of rows of the matrices A and B. N >= 0. M (input) INTEGER The number of columns of the matrix A. M >= 0. P (input) INTEGER The number of columns of the matrix B. P >= 0. Assume that M <= N <= M+P. A (input/output) COMPLEX array, dimension (LDA,M) On entry, the N-by-M matrix A. On exit, A is destroyed. LDA (input) INTEGER The leading dimension of the array A. LDA >= max( 1,N ). B (input/output) COMPLEX array, dimension (LDB,P) On entry, the N-by-P matrix B. On exit, B is des- troyed. LDB (input) INTEGER The leading dimension of the array B. LDB >= max( 1,N ). D (input) COMPLEX array, dimension (N) On entry, D is the left hand side of the GLM equa- tion. On exit, D is destroyed. X (output) COMPLEX array, dimension (M) Y (output) COMPLEX array, dimension (P) On exit, X and Y are the solutions of the GLM problem. WORK (workspace) COMPLEX array, dimension ( LWORK ) On exit, if INFO = 0, WORK(1) returns the optimal LWORK. LWORK (input) INTEGER The dimension for the array WORK. LWORK >= M+P+max(N,M,P). For optimum performance, LWORK >= M+P+max(N,M,P)*max(NB1,NB2), where NB1 is the optimal blocksize for the QR factorization of an N- by-M matrix A. NB2 is the optimal blocksize for the RQ factorization of an N-by-P matrix B. INFO (output) INTEGER = 0: successful exit. < 0: if INFO = -i, the i-th argument had an illegal value.