ctptri (3p)

Name

ctptri - compute the inverse of a complex upper or lower triangular matrix A stored in packed format

Synopsis

SUBROUTINE CTPTRI(UPLO, DIAG, N, A, INFO)

CHARACTER*1 UPLO, DIAG
COMPLEX A(*)
INTEGER N, INFO

SUBROUTINE CTPTRI_64(UPLO, DIAG, N, A, INFO)

CHARACTER*1 UPLO, DIAG
COMPLEX A(*)
INTEGER*8 N, INFO




F95 INTERFACE
SUBROUTINE TPTRI(UPLO, DIAG, N, A, INFO)

CHARACTER(LEN=1) :: UPLO, DIAG
COMPLEX, DIMENSION(:) :: A
INTEGER :: N, INFO

SUBROUTINE TPTRI_64(UPLO, DIAG, N, A, INFO)

CHARACTER(LEN=1) :: UPLO, DIAG
COMPLEX, DIMENSION(:) :: A
INTEGER(8) :: N, INFO




C INTERFACE
#include <sunperf.h>

void ctptri(char uplo, char diag, int n, complex *a, int *info);

void ctptri_64(char uplo, char diag, long n, complex *a, long *info);

Description

Oracle Solaris Studio Performance Library                           ctptri(3P)



NAME
       ctptri  -  compute  the  inverse of a complex upper or lower triangular
       matrix A stored in packed format


SYNOPSIS
       SUBROUTINE CTPTRI(UPLO, DIAG, N, A, INFO)

       CHARACTER*1 UPLO, DIAG
       COMPLEX A(*)
       INTEGER N, INFO

       SUBROUTINE CTPTRI_64(UPLO, DIAG, N, A, INFO)

       CHARACTER*1 UPLO, DIAG
       COMPLEX A(*)
       INTEGER*8 N, INFO




   F95 INTERFACE
       SUBROUTINE TPTRI(UPLO, DIAG, N, A, INFO)

       CHARACTER(LEN=1) :: UPLO, DIAG
       COMPLEX, DIMENSION(:) :: A
       INTEGER :: N, INFO

       SUBROUTINE TPTRI_64(UPLO, DIAG, N, A, INFO)

       CHARACTER(LEN=1) :: UPLO, DIAG
       COMPLEX, DIMENSION(:) :: A
       INTEGER(8) :: N, INFO




   C INTERFACE
       #include <sunperf.h>

       void ctptri(char uplo, char diag, int n, complex *a, int *info);

       void ctptri_64(char uplo, char diag, long n, complex *a, long *info);



PURPOSE
       ctptri computes the inverse of a  complex  upper  or  lower  triangular
       matrix A stored in packed format.


ARGUMENTS
       UPLO (input)
                 = 'U':  A is upper triangular;
                 = 'L':  A is lower triangular.


       DIAG (input)
                 = 'N':  A is non-unit triangular;
                 = 'U':  A is unit triangular.


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


       A (input/output) COMPLEX array, dimension (N*(N+1)/2)
                 On  entry,  the  upper  or  lower triangular matrix A, stored
                 columnwise in a linear array.  The j-th column of A is stored
                 in  the array A as follows: if UPLO = 'U', A(i + (j-1)*j/2) =
                 A(i,j) for 1<=i<=j; if UPLO = 'L', A(i + (j-1)*((2*n-j)/2)  =
                 A(i,j) for j<=i<=n.  See below for further details.  On exit,
                 the (triangular) inverse of the original matrix, in the  same
                 packed storage format.


       INFO (output)
                 = 0:  successful exit
                 < 0:  if INFO = -i, the i-th argument had an illegal value
                 >  0:   if  INFO = i, A(i,i) is exactly zero.  The triangular
                 matrix is singular and its inverse can not be computed.

FURTHER DETAILS
       A triangular matrix A can be transferred to packed storage using one of
       the following program segments:

       UPLO = 'U':                      UPLO = 'L':

             JC = 1                           JC = 1
             DO 2 J = 1, N                    DO 2 J = 1, N
                DO 1 I = 1, J                    DO 1 I = J, N
                   A(JC+I-1) = A(I,J)              A(JC+I-J) = A(I,J)
           1    CONTINUE                    1    CONTINUE
                JC = JC + J                      JC = JC + N - J + 1
           2 CONTINUE                       2 CONTINUE




                                  7 Nov 2015                        ctptri(3P)