?trttf

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 11/07/2023

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-0655BC29-1256-4DC0-B9A4-502E26CBC9A4

View Details

?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

The order of the matrix A. n≥ 0.

a

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: Array, size at least max (1, n*(n+1)/2).
On exit, the upper or lower triangular matrix A stored in the RFP format.

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.

Parent topic: LAPACK Auxiliary Routines

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

?trttf

Syntax

Include Files

Description

Input Parameters

Output Parameters

Return Values