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

?trttf

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

Syntax

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

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

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

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

Include Files

  • mkl.fi

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

transr

CHARACTER*1.

= '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

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 matrix A. n≥ 0.

a

REAL for strttf,

DOUBLE PRECISION for dtrttf,

COMPLEX for ctrttf,

DOUBLE COMPLEX for ztrttf.

Array, size (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

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

On exit, the upper or lower triangular matrix A stored in the RFP format.
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.