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

?tpttr

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

Syntax

lapack_int LAPACKE_stpttr (int matrix_layout , char uplo , lapack_int n , const float * ap , float * a , lapack_int lda );

lapack_int LAPACKE_dtpttr (int matrix_layout , char uplo , lapack_int n , const double * ap , double * a , lapack_int lda );

lapack_int LAPACKE_ctpttr (int matrix_layout , char uplo , lapack_int n , const lapack_complex_float * ap , lapack_complex_float * a , lapack_int lda );

lapack_int LAPACKE_ztpttr (int matrix_layout , char uplo , lapack_int n , const lapack_complex_double * ap , lapack_complex_double * a , lapack_int lda );

Include Files

  • mkl.h

Description

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

Array, size at least max (1, n*(n+1)/2). (see Matrix Storage Schemes).

lda

The leading dimension of the array a. lda max(1,n).

Output Parameters

a

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.