?tfttr

Syntax

FORTRAN 77:

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 )

C:

lapack_int LAPACKE_<?>tfttr( int matrix_order, char transr, char uplo, lapack_int n, const <datatype>* arf, <datatype>* a, lapack_int lda );

Include Files

• FORTRAN 77: mkl_lapack.fi and mkl_lapack.h
• C: mkl_lapacke.h

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

The data types are given for the Fortran interface. A <datatype> placeholder, if present, is used for the C interface data types in the C interface section above. See C Interface Conventions for the C interface principal conventions and type defintions.

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, DIMENSION 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, DIMENSION (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.

=0: successful exit,

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