Go to main content
Oracle Developer Studio 12.5 Man Pages

Exit Print View

Updated: June 2017
 
 

chetri_rook (3p)

Name

chetri_rook - torization obtained with the bounded Bunch-Kaufman ("rook") diagonal pivoting method

Synopsis

SUBROUTINE CHETRI_ROOK(UPLO, N, A, LDA, IPIV, WORK, INFO)


CHARACTER*1 UPLO

INTEGER INFO, LDA, N

INTEGER IPIV(*)

COMPLEX A(LDA,*), WORK(*)


SUBROUTINE CHETRI_ROOK_64(UPLO, N, A, LDA, IPIV, WORK, INFO)


CHARACTER* UPLO

INTEGER*8 INFO, LDA, N

INTEGER*8 IPIV(*)

COMPLEX A(LDA,*), WORK(*)


F95 INTERFACE
SUBROUTINE HETRI_ROOK(UPLO, N, A, LDA, IPIV, WORK, INFO)


INTEGER :: N, LDA, INFO

CHARACTER(LEN=1) :: UPLO

INTEGER, DIMENSION(:) :: IPIV

COMPLEX, DIMENSION(:) :: WORK

COMPLEX, DIMENSION(:,:) :: A


SUBROUTINE HETRI_ROOK_64(UPLO, N, A, LDA, IPIV, WORK, INFO)


INTEGER(8) :: N, LDA, INFO

CHARACTER(LEN=1) :: UPLO

INTEGER(8), DIMENSION(:) :: IPIV

COMPLEX, DIMENSION(:) :: WORK

COMPLEX, DIMENSION(:,:) :: A


C INTERFACE
#include <sunperf.h>

void  chetri_rook  (char  uplo,  int  n,  floatcomplex *a, int lda, int
*ipiv, int *info);


void chetri_rook_64 (char uplo, long n, floatcomplex *a, long lda, long
*ipiv, long *info);

Description

Oracle Solaris Studio Performance Library                      chetri_rook(3P)



NAME
       chetri_rook  - compute the inverse of a Hermitian matrix using the fac-
       torization obtained with the bounded  Bunch-Kaufman  ("rook")  diagonal
       pivoting method


SYNOPSIS
       SUBROUTINE CHETRI_ROOK(UPLO, N, A, LDA, IPIV, WORK, INFO)


       CHARACTER*1 UPLO

       INTEGER INFO, LDA, N

       INTEGER IPIV(*)

       COMPLEX A(LDA,*), WORK(*)


       SUBROUTINE CHETRI_ROOK_64(UPLO, N, A, LDA, IPIV, WORK, INFO)


       CHARACTER* UPLO

       INTEGER*8 INFO, LDA, N

       INTEGER*8 IPIV(*)

       COMPLEX A(LDA,*), WORK(*)


   F95 INTERFACE
       SUBROUTINE HETRI_ROOK(UPLO, N, A, LDA, IPIV, WORK, INFO)


       INTEGER :: N, LDA, INFO

       CHARACTER(LEN=1) :: UPLO

       INTEGER, DIMENSION(:) :: IPIV

       COMPLEX, DIMENSION(:) :: WORK

       COMPLEX, DIMENSION(:,:) :: A


       SUBROUTINE HETRI_ROOK_64(UPLO, N, A, LDA, IPIV, WORK, INFO)


       INTEGER(8) :: N, LDA, INFO

       CHARACTER(LEN=1) :: UPLO

       INTEGER(8), DIMENSION(:) :: IPIV

       COMPLEX, DIMENSION(:) :: WORK

       COMPLEX, DIMENSION(:,:) :: A


   C INTERFACE
       #include <sunperf.h>

       void  chetri_rook  (char  uplo,  int  n,  floatcomplex *a, int lda, int
                 *ipiv, int *info);


       void chetri_rook_64 (char uplo, long n, floatcomplex *a, long lda, long
                 *ipiv, long *info);


PURPOSE
       chetri_rook  computes  the  inverse  of  a complex Hermitian indefinite
       matrix A using the factorization A = U*D*U**H or A = L*D*L**H  computed
       by CHETRF_ROOK.


ARGUMENTS
       UPLO (input)
                 UPLO is CHARACTER*1
                 Specifies whether the details of the factorization are stored
                 as an upper or lower triangular matrix.
                 = 'U':  Upper triangular, form is A = U*D*U**H;
                 = 'L':  Lower triangular, form is A = L*D*L**H.


       N (input)
                 N is INTEGER
                 The order of the matrix A. N >= 0.


       A (input/output)
                 A is COMPLEX array, dimension (LDA,N)
                 On entry, the block diagonal matrix  D  and  the  multipliers
                 used  to obtain the factor U or L as computed by CHETRF_ROOK.
                 On exit, if INFO = 0, the (Hermitian) inverse of the original
                 matrix.
                 If  UPLO  =  'U', the upper triangular part of the inverse is
                 formed and the part of A below the  diagonal  is  not  refer-
                 enced;
                 if  UPLO  =  'L'  the lower triangular part of the inverse is
                 formed and the part of A above the  diagonal  is  not  refer-
                 enced.


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


       IPIV (input)
                 IPIV is INTEGER array, dimension (N)
                 Details  of  the interchanges and the block structure of D as
                 determined by CHETRF_ROOK.


       WORK (output)
                 WORK is COMPLEX array, dimension (N)


       INFO (output)
                 INFO is INTEGER
                 = 0: successful exit;
                 < 0: if INFO = -i, the i-th argument had an illegal value;
                 > 0: if INFO = i, D(i,i) = 0; the matrix is singular and  its
                 inverse could not be computed.




                                  7 Nov 2015                   chetri_rook(3P)