Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 3/31/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

zlat2c

Converts a double complex triangular matrix to a complex triangular matrix.

Syntax

call zlat2c( uplo, n, a, lda, sa, ldsa, info )

Include Files
  • mkl.fi
Description

This routine is declared in mkl_lapack.fi.

The routine converts a DOUBLE COMPLEX triangular matrix A to a COMPLEX triangular matrix SA. zlat2c checks that the real and complex parts of all the elements of A are between -RMAX and RMAX, where RMAX is the overflow for the single-precision arithmetic. If this condition is not met, the conversion is aborted and a flag is raised. The routine does no parameter checking.

Input Parameters
uplo

CHARACTER*1.

Specifies whether the matrix A is upper or lower triangular:

= 'U': A is upper triangular,

= 'L': A is lower triangular.

n

INTEGER. The number of rows and columns in the matrix A. n 0.

a

DOUBLE COMPLEX.

Array, DIMENSION (lda, *).

On entry, the n-by-n triangular matrix A.

lda

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

ldsa

INTEGER. The leading dimension of the array sa. ldsa max(1,n).

Output Parameters
sa

COMPLEX.

Array, DIMENSION (ldsa, *).

Only the part of sa determined by uplo is referenced. On exit,

  • if info = 0, the n-by-n triangular matrix sa,

  • if info > 0, the content of the part of sa determined by uplo is unspecified.

info

INTEGER.

=0: successful exit,

> 0: the real or complex part of an element of the matrix A is greater than the single-precision overflow threshold; in this case, the content of the part of sa determined by uplo is unspecified on exit.