Go to main content
Oracle Developer Studio 12.5 Man Pages

Exit Print View

Updated: June 2017
 
 

cla_gerpvgrw (3p)

Name

cla_gerpvgrw - compute the reciprocal pivot growth factor using the "max absolute element" norm

Synopsis

REAL FUNCTION CLA_GERPVGRW(N, NCOLS, A, LDA, AF, LDAF)


INTEGER N, NCOLS, LDA, LDAF

COMPLEX A(LDA,*), AF(LDAF,*)


REAL FUNCTION CLA_GERPVGRW_64(N, NCOLS, A, LDA, AF, LDAF)


INTEGER*8 N, NCOLS, LDA, LDAF

COMPLEX A(LDA,*), AF(LDAF,*)


F95 INTERFACE
REAL FUNCTION LA_GERPVGRW(N, NCOLS, A, LDA, AF, LDAF)


INTEGER :: N, NCOLS, LDA, LDAF

COMPLEX, DIMENSION(:,:) :: A, AF


REAL FUNCTION LA_GERPVGRW_64(N, NCOLS, A, LDA, AF, LDAF)


INTEGER(8) :: N, NCOLS, LDA, LDAF

COMPLEX, DIMENSION(:,:) :: A, AF


C INTERFACE
#include <sunperf.h>

float cla_gerpvgrw (int n, int ncols, floatcomplex *a, int lda,  float-
complex *af, int ldaf);

float  cla_gerpvgrw_64  (long n, long ncols, floatcomplex *a, long lda,
floatcomplex *af, long ldaf);

Description

Oracle Solaris Studio Performance Library                     cla_gerpvgrw(3P)



NAME
       cla_gerpvgrw  -  compute  the  reciprocal pivot growth factor using the
       "max absolute element" norm


SYNOPSIS
       REAL FUNCTION CLA_GERPVGRW(N, NCOLS, A, LDA, AF, LDAF)


       INTEGER N, NCOLS, LDA, LDAF

       COMPLEX A(LDA,*), AF(LDAF,*)


       REAL FUNCTION CLA_GERPVGRW_64(N, NCOLS, A, LDA, AF, LDAF)


       INTEGER*8 N, NCOLS, LDA, LDAF

       COMPLEX A(LDA,*), AF(LDAF,*)


   F95 INTERFACE
       REAL FUNCTION LA_GERPVGRW(N, NCOLS, A, LDA, AF, LDAF)


       INTEGER :: N, NCOLS, LDA, LDAF

       COMPLEX, DIMENSION(:,:) :: A, AF


       REAL FUNCTION LA_GERPVGRW_64(N, NCOLS, A, LDA, AF, LDAF)


       INTEGER(8) :: N, NCOLS, LDA, LDAF

       COMPLEX, DIMENSION(:,:) :: A, AF


   C INTERFACE
       #include <sunperf.h>

       float cla_gerpvgrw (int n, int ncols, floatcomplex *a, int lda,  float-
                 complex *af, int ldaf);

       float  cla_gerpvgrw_64  (long n, long ncols, floatcomplex *a, long lda,
                 floatcomplex *af, long ldaf);


PURPOSE
       cla_gerpvgrw   computes   the   reciprocal    pivot    growth    factor
       norm(A)/norm(U).  The  "max  absolute element" norm is used. If this is
       much less than 1, the stability of the LU factorization of the (equili-
       brated)  matrix  A  could be poor. This also means that the solution X,
       estimated condition numbers, and error bounds could be unreliable.


ARGUMENTS
       N (input)
                 N is INTEGER
                 The number of linear equations, i.e., the order of the matrix
                 A. N >= 0.


       NCOLS (input)
                 NCOLS is INTEGER
                 The number of columns of the matrix A. NCOLS >= 0.


       A (input)
                 A is COMPLEX array, dimension (LDA,N)
                 On entry, the N-by-N matrix A.


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


       AF (input)
                 AF is COMPLEX array, dimension (LDAF,N)
                 The  factors  L  and U from the factorization A=P*L*U as com-
                 puted by CGETRF.


       LDAF (input)
                 LDAF is INTEGER
                 The leading dimension of the array AF.
                 LDAF >= max(1,N).




                                  7 Nov 2015                  cla_gerpvgrw(3P)