Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
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

?tfttr

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

Syntax

call stfttr( transr, uplo, n, arf, a, lda, info )

call dtfttr( transr, uplo, n, arf, a, lda, info )

call ctfttr( transr, uplo, n, arf, a, lda, info )

call ztfttr( transr, uplo, n, arf, a, lda, info )

Include Files

  • mkl.fi

Description

The routine copies a triangular matrix A from the Rectangular Full Packed (RFP) format to the standard full format. For the description of the RFP format, see Matrix Storage Schemes.

Input Parameters

transr

CHARACTER*1.

= 'N': arf is in the Normal format,

= 'T': arf is in the Transpose format (for stfttr and dtfttr),

= 'C': arf is in the Conjugate-transpose format (for ctfttr and ztfttr).

uplo

CHARACTER*1.

Specifies whether A is upper or lower triangular:

= 'U': A is upper triangular,

= 'L': A is lower triangular.

n

INTEGER. The order of the matrices arf and a. n 0.

arf

REAL for stfttr,

DOUBLE PRECISION for dtfttr,

COMPLEX for ctfttr,

DOUBLE COMPLEX for ztfttr.

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

On entry, the upper or lower triangular matrix A stored in the RFP format.
lda

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

Output Parameters

a

REAL for stfttr,

DOUBLE PRECISION for dtfttr,

COMPLEX for ctfttr,

DOUBLE COMPLEX for ztfttr.

Array, size (lda, *).

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 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.

info

INTEGER. 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.