Developer Reference for Intel® oneAPI Math Kernel Library for C
?trttf
Copies a triangular matrix from the standard full format (TR) to the rectangular full packed format (TF).
Syntax
lapack_int LAPACKE_strttf(int matrix_layout, char transr, char uplo, lapack_int n,
const float *a, lapack_int lda, float *arf);
lapack_int LAPACKE_dtrttf(int matrix_layout, char transr, char uplo, lapack_int n,
const double *a, lapack_int lda, double *arf);
lapack_int LAPACKE_ctrttf(int matrix_layout, char transr, char uplo, lapack_int n,
const lapack_complex_float *a, lapack_int lda,
lapack_complex_float *arf);
lapack_int LAPACKE_ztrttf(int matrix_layout, char transr, char uplo, lapack_int n,
const lapack_complex_double *a, lapack_int lda,
lapack_complex_double *arf);
Include Files
mkl.h
Description
The routine copies a triangular matrix A from the standard full format to the Rectangular Full Packed (RFP) format. For the description of the RFP format, see Matrix Storage Schemes .
Input Parameters
- matrix_layout
-
Specifies whether matrix storage layout is row major ( LAPACK_ROW_MAJOR ) or column major ( LAPACK_COL_MAJOR ).
transr
= ‘N’: arf must be in the Normal format, = ‘T’: arf must be in the Transpose format (for strttf and dtrttf ), = ‘C’: arf must be in the Conjugate-transpose format (for ctrttf and ztrttf ).
uplo
Specifies whether A is upper or lower triangular: = ‘U’: A is upper triangular, = ‘L’: A is lower triangular.
- n
-
Specifies the order of the matrix A . The value of n must be at least zero.
- a
-
REAL for strttf , DOUBLE PRECISION for dtrttf , COMPLEX for ctrttf , DOUBLE COMPLEX for ztrttf .
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
- arf
-
REAL for strttf , DOUBLE PRECISION for dtrttf , COMPLEX for ctrttf , DOUBLE COMPLEX for ztrttf . Array, size at least max (1, n *( n +1)/2).
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.