Developer Reference for Intel® oneAPI Math Kernel Library for C
?trttp
Copies a triangular matrix from the standard full format (TR) to the standard packed format (TP) .
Syntax
lapack_intLAPACKE_strttp ( intmatrix_layout , charuplo , lapack_intn , constfloat*a , lapack_intlda , float*ap );
lapack_intLAPACKE_dtrttp ( intmatrix_layout , charuplo , lapack_intn , constdouble*a , lapack_intlda , double*ap );
lapack_intLAPACKE_ctrttp ( intmatrix_layout , charuplo , lapack_intn , constlapack_complex_float*a , lapack_intlda , lapack_complex_float*ap );
lapack_intLAPACKE_ztrttp ( intmatrix_layout , charuplo , lapack_intn , constlapack_complex_double*a , lapack_intlda , lapack_complex_double*ap );
Include Files
mkl.h
Description
strttp dtrttp ctrttp ztrttp
The routine copies a triangular matrix A from the standard full format to the standard packed format.
Input Parameters
uplo
Specifies whether A is upper or lower triangular: = ‘U’: A is upper triangular, = ‘L’: A is lower triangular.
n
The order of the matrix A , n ≥ 0.
- a
-
REAL for strttp , DOUBLE PRECISION for dtrttp , COMPLEX for ctrttp , DOUBLE COMPLEX for ztrttp .
Array, size max(1, lda * n ) .
On entry, the triangular matrix A . If uplo = ‘U’, the leading n -by- n upper triangular part of the array a contains the upper triangular matrix, and the strictly lower triangular part of a is not referenced. If uplo = ‘L’, the leading n -by- n lower triangular part of the array a contains the lower triangular matrix, and the strictly upper triangular part of a is not referenced.
lda
The leading dimension of the array a.lda ≥ max (1, n ).
Output Parameters
- ap
-
REAL for strttp , DOUBLE PRECISION for dtrttp , COMPLEX for ctrttp , DOUBLE COMPLEX for ztrttp . Array, size at least max (1, 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 . On exit, the upper or lower triangular matrix A , packed columnwise in a linear array. (see Matrix Storage Schemes )
Return Values
This function returns a value info .
If info = 0 , the execution is successful.
If info < 0 , the i -th parameter had an illegal value.
If info = -1011 , memory allocation error occurred.