Go to main content
Oracle Developer Studio 12.5 Man Pages

Exit Print View

Updated: June 2017
 
 

cgetf2 (3p)

Name

cgetf2 - n matrix A using partial pivoting with row interchanges

Synopsis

SUBROUTINE CGETF2(M, N, A, LDA, IPIV, INFO)

COMPLEX A(LDA,*)
INTEGER M, N, LDA, INFO
INTEGER IPIV(*)

SUBROUTINE CGETF2_64(M, N, A, LDA, IPIV, INFO)

COMPLEX A(LDA,*)
INTEGER*8 M, N, LDA, INFO
INTEGER*8 IPIV(*)




F95 INTERFACE
SUBROUTINE GETF2(M, N, A, LDA, IPIV, INFO)

COMPLEX, DIMENSION(:,:) :: A
INTEGER :: M, N, LDA, INFO
INTEGER, DIMENSION(:) :: IPIV

SUBROUTINE GETF2_64(M, N, A, LDA, IPIV, INFO)

COMPLEX, DIMENSION(:,:) :: A
INTEGER(8) :: M, N, LDA, INFO
INTEGER(8), DIMENSION(:) :: IPIV




C INTERFACE
#include <sunperf.h>

void cgetf2(int m, int n, complex *a, int lda, int *ipiv, int *info);

void cgetf2_64(long m, long n, complex *a, long lda, long  *ipiv,  long
*info);

Description

Oracle Solaris Studio Performance Library                           cgetf2(3P)



NAME
       cgetf2 - compute an LU factorization of a general m-by-n matrix A using
       partial pivoting with row interchanges


SYNOPSIS
       SUBROUTINE CGETF2(M, N, A, LDA, IPIV, INFO)

       COMPLEX A(LDA,*)
       INTEGER M, N, LDA, INFO
       INTEGER IPIV(*)

       SUBROUTINE CGETF2_64(M, N, A, LDA, IPIV, INFO)

       COMPLEX A(LDA,*)
       INTEGER*8 M, N, LDA, INFO
       INTEGER*8 IPIV(*)




   F95 INTERFACE
       SUBROUTINE GETF2(M, N, A, LDA, IPIV, INFO)

       COMPLEX, DIMENSION(:,:) :: A
       INTEGER :: M, N, LDA, INFO
       INTEGER, DIMENSION(:) :: IPIV

       SUBROUTINE GETF2_64(M, N, A, LDA, IPIV, INFO)

       COMPLEX, DIMENSION(:,:) :: A
       INTEGER(8) :: M, N, LDA, INFO
       INTEGER(8), DIMENSION(:) :: IPIV




   C INTERFACE
       #include <sunperf.h>

       void cgetf2(int m, int n, complex *a, int lda, int *ipiv, int *info);

       void cgetf2_64(long m, long n, complex *a, long lda, long  *ipiv,  long
                 *info);



PURPOSE
       cgetf2  computes an LU factorization of a general m-by-n matrix A using
       partial pivoting with row interchanges.

       The factorization has the form
          A = P * L * U
       where P is a permutation matrix, L is lower triangular with unit diago-
       nal  elements  (lower  trapezoidal if m > n), and U is upper triangular
       (upper trapezoidal if m < n).

       This is the right-looking Level 2 BLAS version of the algorithm.


ARGUMENTS
       M (input) The number of rows of the matrix A.  M >= 0.


       N (input) The number of columns of the matrix A.  N >= 0.


       A (input/output)
                 On entry, the m by n matrix to be  factored.   On  exit,  the
                 factors  L  and  U from the factorization A = P*L*U; the unit
                 diagonal elements of L are not stored.


       LDA (input)
                 The leading dimension of the array A.  LDA >= max(1,M).


       IPIV (output)
                 The pivot indices; for 1 <= i  <=  min(M,N),  row  i  of  the
                 matrix was interchanged with row IPIV(i).


       INFO (output)
                 = 0: successful exit
                 < 0: if INFO = -k, the k-th argument had an illegal value
                 >  0:  if INFO = k, U(k,k) is exactly zero. The factorization
                 has been completed, but the factor U is exactly singular, and
                 division  by  zero will occur if it is used to solve a system
                 of equations.




                                  7 Nov 2015                        cgetf2(3P)