Go to main content
Oracle Developer Studio 12.5 Man Pages

Exit Print View

Updated: June 2017
 
 

ctrttp (3p)

Name

ctrttp - copy a triangular matrix from the standard full format (TR) to the standard packed format (TP)

Synopsis

SUBROUTINE CTRTTP( UPLO, N, A, LDA, AP, INFO )


CHARACTER*1 UPLO

INTEGER INFO, N, LDA

COMPLEX A(LDA,*), AP(*)


SUBROUTINE CTRTTP_64( UPLO, N, A, LDA, AP, INFO )


CHARACTER*1 UPLO

INTEGER*8 INFO, N, LDA

COMPLEX A(LDA,*), AP(*)


F95 INTERFACE
SUBROUTINE TRTTP( UPLO, N, A, LDA, AP, INFO )


INTEGER :: N, LDA, INFO

CHARACTER(LEN=1) :: UPLO

COMPLEX, DIMENSION(:,:) :: A

COMPLEX, DIMENSION(:) :: AP


SUBROUTINE TRTTP_64( UPLO, N, A, LDA, AP, INFO )


INTEGER(8) :: N, LDA, INFO

CHARACTER(LEN=1) :: UPLO

COMPLEX, DIMENSION(:,:) :: A

COMPLEX, DIMENSION(:) :: AP


C INTERFACE
#include <sunperf.h>

void ctrttp (char uplo, int n, floatcomplex *a, int  lda,  floatcomplex
*ap, int *info);


void ctrttp_64 (char uplo, long n, floatcomplex *a, long lda, floatcom-
plex *ap, long *info);

Description

Oracle Solaris Studio Performance Library                           ctrttp(3P)



NAME
       ctrttp - copy a triangular matrix from the standard full format (TR) to
       the standard packed format (TP)


SYNOPSIS
       SUBROUTINE CTRTTP( UPLO, N, A, LDA, AP, INFO )


       CHARACTER*1 UPLO

       INTEGER INFO, N, LDA

       COMPLEX A(LDA,*), AP(*)


       SUBROUTINE CTRTTP_64( UPLO, N, A, LDA, AP, INFO )


       CHARACTER*1 UPLO

       INTEGER*8 INFO, N, LDA

       COMPLEX A(LDA,*), AP(*)


   F95 INTERFACE
       SUBROUTINE TRTTP( UPLO, N, A, LDA, AP, INFO )


       INTEGER :: N, LDA, INFO

       CHARACTER(LEN=1) :: UPLO

       COMPLEX, DIMENSION(:,:) :: A

       COMPLEX, DIMENSION(:) :: AP


       SUBROUTINE TRTTP_64( UPLO, N, A, LDA, AP, INFO )


       INTEGER(8) :: N, LDA, INFO

       CHARACTER(LEN=1) :: UPLO

       COMPLEX, DIMENSION(:,:) :: A

       COMPLEX, DIMENSION(:) :: AP


   C INTERFACE
       #include <sunperf.h>

       void ctrttp (char uplo, int n, floatcomplex *a, int  lda,  floatcomplex
                 *ap, int *info);


       void ctrttp_64 (char uplo, long n, floatcomplex *a, long lda, floatcom-
                 plex *ap, long *info);


PURPOSE
       ctrttp copies a triangular matrix A from full format (TR)  to  standard
       packed format (TP).


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


       N (input)
                 N is INTEGER
                 The order of the matrices AP and A.  N >= 0.


       A (input)
                 A is COMPLEX array, dimension (LDA,N)
                 On  entry, the triangular matrix A.  If UPLO = 'U', the lead-
                 ing
                 N-by-N upper triangular part of A contains the upper
                 triangular part of the matrix A, and the strictly lower
                 triangular part of A is not referenced.  If UPLO = 'L', the
                 leading N-by-N lower triangular part of A contains the lower
                 triangular part of the matrix A, and the strictly upper
                 triangular part of A is not referenced.


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


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


       INFO (output)
                 INFO is INTEGER
                 = 0:  successful exit
                 < 0:  if INFO = -i, the i-th argument had an illegal value




                                  7 Nov 2015                        ctrttp(3P)