Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 12/16/2022
Public

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

Document Table of Contents

?large

Pre- and post-multiplies a real general matrix with a random orthogonal matrix.

Syntax

call slarge( n, a, lda, iseed, work, info )

call dlarge( n, a, lda, iseed, work, info )

call clarge( n, a, lda, iseed, work, info )

call zlarge( n, a, lda, iseed, work, info )

Include Files
  • mkl.fi
Description

The routine ?large pre- and post-multiplies a general n-by-n matrix A with a random orthogonal or unitary matrix: A = U*D*UT .

Input Parameters
n

INTEGER. The order of the matrix A. n≥0

a

REAL for slarge,

DOUBLE PRECISION for dlarge,

COMPLEX for clarge,

DOUBLE COMPLEX for zlarge,

Array, size lda by n.

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

lda

INTEGER. The leading dimension of the array a. lda≥n.

iseed

INTEGER. Array, size 4.

On entry, the seed of the random number generator. The array elements must be between 0 and 4095, and iseed(4) must be odd.

work

REAL for slarge,

DOUBLE PRECISION for dlarge,

COMPLEX for clarge,

DOUBLE COMPLEX for zlarge,

Workspace array, size 2*n.

Output Parameters
a

INTEGER.

On exit, A is overwritten by U*A*U' for some random orthogonal matrix U.

iseed

INTEGER.

On exit, the seed is updated.

info

INTEGER.

If info = 0, the execution is successful.

If info < 0, the i -th parameter had an illegal value.