Developer Reference for Intel® oneAPI Math Kernel Library for C
?tpttr
Copies a triangular matrix from the standard packed format (TP) to the standard full format (TR) .
Syntax
lapack_intLAPACKE_stpttr ( intmatrix_layout , charuplo , lapack_intn , constfloat*ap , float*a , lapack_intlda );
lapack_intLAPACKE_dtpttr ( intmatrix_layout , charuplo , lapack_intn , constdouble*ap , double*a , lapack_intlda );
lapack_intLAPACKE_ctpttr ( intmatrix_layout , charuplo , lapack_intn , constlapack_complex_float*ap , lapack_complex_float*a , lapack_intlda );
lapack_intLAPACKE_ztpttr ( intmatrix_layout , charuplo , lapack_intn , constlapack_complex_double*ap , lapack_complex_double*a , lapack_intlda );
Include Files
mkl.h
Description
stpttr dtpttr ctpttr ztpttr
The routine copies a triangular matrix A from the standard packed format to the standard full format.
Input Parameters
- matrix_layout
-
Specifies whether matrix storage layout is row major ( LAPACK_ROW_MAJOR ) or column major ( LAPACK_COL_MAJOR ).
uplo
Specifies whether A is upper or lower triangular: = ‘U’: A is upper triangular, = ‘L’: A is lower triangular.
n
The order of the matrices ap and a . n≥ 0 .
- ap
-
REAL for stpttr , DOUBLE PRECISION for dtpttr , COMPLEX for ctpttr , DOUBLE COMPLEX for ztpttr . Array, size at least max (1, n *( n +1)/2). (see Matrix Storage Schemes ). On entry, 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 .
lda
The leading dimension of the array a.lda ≥ max (1, n ).
Output Parameters
- a
-
REAL for stpttr , DOUBLE PRECISION for dtpttr , COMPLEX for ctpttr , DOUBLE COMPLEX for ztpttr .
Array, size max(1, lda * n ) .
On exit, the triangular matrix A . If uplo = ‘U’, the leading n -by- n upper triangular part of the array 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 the array a contains the lower triangular part of the matrix A , and the strictly upper triangular part of a is not referenced.
Return Values
This function returns a value info .
If info = 0 , the execution is successful.
If info = -i , the i -th parameter had an illegal value.
If info = -1011 , memory allocation error occurred.