Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 11/07/2023
Public

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

Document Table of Contents

?tpttf

Copies a triangular matrix from the standard packed format (TP) to the rectangular full packed format (TF).

Syntax

lapack_int LAPACKE_stpttf (int matrix_layout , char transr , char uplo , lapack_int n , const float * ap , float * arf );

lapack_int LAPACKE_dtpttf (int matrix_layout , char transr , char uplo , lapack_int n , const double * ap , double * arf );

lapack_int LAPACKE_ctpttf (int matrix_layout , char transr , char uplo , lapack_int n , const lapack_complex_float * ap , lapack_complex_float * arf );

lapack_int LAPACKE_ztpttf (int matrix_layout , char transr , char uplo , lapack_int n , const lapack_complex_double * ap , lapack_complex_double * arf );

Include Files

  • mkl.h

Description

The routine copies a triangular matrix A from the standard packed 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 stpttf and dtpttf),

= 'C': arf must be in the Conjugate-transpose format (for ctpttf and ztpttf).

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.

ap

Array, size at least max (1, n*(n+1)/2).

On entry, the upper or lower triangular matrix A, packed in a linear array. See Matrix Storage Schemes for more information.

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.

< 0: if info = -i, the i-th parameter had an illegal value.

If info = -1011, memory allocation error occurred.