?trttf

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

Syntax

FORTRAN 77:

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 )

C:

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

Include Files

  • Fortran: mkl.fi
  • C: mkl.h

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

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

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, DIMENSION at least max (1, n*(n+1)/2).

On exit, the upper or lower triangular matrix A stored in the RFP format.
info

INTEGER.

=0: successful exit,

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

For more complete information about compiler optimizations, see our Optimization Notice.